From fc4a1df1ad48224ae846fbbdeeb21b4b7b164e02 Mon Sep 17 00:00:00 2001
From: Dian Fu <fudian.fd@alibaba-inc.com>
Date: Thu, 26 Sep 2019 12:05:53 +0800
Subject: [PATCH] [FLINK-14018][python] Package cloudpickle in flink for ease
 of use for Flink Python users

This closes #9766.
---
 NOTICE                                        |   1 +
 NOTICE-binary                                 |   1 +
 flink-python/README.md                        |   2 +-
 flink-python/bin/pyflink-shell.sh             |   5 +--
 flink-python/bin/pyflink-udf-runner.sh        |   6 ++++
 flink-python/lib/cloudpickle-1.2.2-src.zip    | Bin 0 -> 23425 bytes
 flink-python/lib/cloudpickle-LICENSE.txt      |  32 ++++++++++++++++++
 .../src/main/resources/META-INF/NOTICE        |   1 +
 .../META-INF/licenses/LICENSE.cloudpickle     |  32 ++++++++++++++++++
 licenses-binary/LICENSE.cloudpickle           |  32 ++++++++++++++++++
 licenses/LICENSE.cloudpickle                  |  32 ++++++++++++++++++
 11 files changed, 141 insertions(+), 3 deletions(-)
 create mode 100644 flink-python/lib/cloudpickle-1.2.2-src.zip
 create mode 100644 flink-python/lib/cloudpickle-LICENSE.txt
 create mode 100644 flink-python/src/main/resources/META-INF/licenses/LICENSE.cloudpickle
 create mode 100644 licenses-binary/LICENSE.cloudpickle
 create mode 100644 licenses/LICENSE.cloudpickle

diff --git a/NOTICE b/NOTICE
index 88121c1d7e28b..30aa331903d6f 100644
--- a/NOTICE
+++ b/NOTICE
@@ -33,6 +33,7 @@ This project bundles the following dependencies under the BSD license.
 See bundled license files for details.
 
 - d3:3.5.12
+- cloudpickle:1.2.2
 
 This project bundles the following dependencies under SIL OFL 1.1 license (https://opensource.org/licenses/OFL-1.1).
 See bundled license files for details.
diff --git a/NOTICE-binary b/NOTICE-binary
index 122242c18050a..afea5236f2c73 100644
--- a/NOTICE-binary
+++ b/NOTICE-binary
@@ -8035,6 +8035,7 @@ See bundled license files for details
 - com.google.protobuf:protobuf-java:3.7.1
 - com.google.protobuf:protobuf-java-util:3.7.1
 - com.google.auth:google-auth-library-credentials:0.13.0
+- cloudpickle:1.2.2
 
 This project bundles the following dependencies under the MIT license. (https://opensource.org/licenses/MIT)
 See bundled license files for details.
diff --git a/flink-python/README.md b/flink-python/README.md
index 7f8c936144116..db4915038144f 100644
--- a/flink-python/README.md
+++ b/flink-python/README.md
@@ -27,4 +27,4 @@ We can enter the directory where this README.md file is located and run test cas
 
 ## Python Requirements
 
-PyFlink depends on Py4J (currently version 0.10.8.1).
+PyFlink depends on Py4J (currently version 0.10.8.1) and CloudPickle (currently version 1.2.2).
diff --git a/flink-python/bin/pyflink-shell.sh b/flink-python/bin/pyflink-shell.sh
index 2c83cc76af575..8722e20831811 100755
--- a/flink-python/bin/pyflink-shell.sh
+++ b/flink-python/bin/pyflink-shell.sh
@@ -34,10 +34,11 @@ PYFLINK_PYTHON="${PYFLINK_PYTHON:-"python"}"
 export FLINK_BIN_DIR=$FLINK_BIN_DIR
 export FLINK_HOME
 
-# Add pyflink & py4j to PYTHONPATH
+# Add pyflink & py4j & cloudpickle to PYTHONPATH
 export PYTHONPATH="$FLINK_OPT_DIR/python/pyflink.zip:$PYTHONPATH"
 PY4J_ZIP=`echo "$FLINK_OPT_DIR"/python/py4j-*-src.zip`
-export PYTHONPATH="$PY4J_ZIP:$PYTHONPATH"
+CLOUDPICKLE_ZIP=`echo "$FLINK_OPT_DIR"/python/cloudpickle-*-src.zip`
+export PYTHONPATH="$PY4J_ZIP:$CLOUDPICKLE_ZIP:$PYTHONPATH"
 
 PARSER="org.apache.flink.client.python.PythonShellParser"
 function parse_options() {
diff --git a/flink-python/bin/pyflink-udf-runner.sh b/flink-python/bin/pyflink-udf-runner.sh
index 38c38cd314760..edfb85c718ab8 100755
--- a/flink-python/bin/pyflink-udf-runner.sh
+++ b/flink-python/bin/pyflink-udf-runner.sh
@@ -58,6 +58,12 @@ if [[ ! ${PYTHONPATH} =~ ${PY4J_ZIP} ]]; then
     export PYTHONPATH="$PY4J_ZIP:$PYTHONPATH"
 fi
 
+# Add cloudpickle to PYTHONPATH
+CLOUDPICKLE_ZIP=`echo "$FLINK_OPT_DIR"/python/cloudpickle-*-src.zip`
+if [[ ! ${PYTHONPATH} =~ ${CLOUDPICKLE_ZIP} ]]; then
+    export PYTHONPATH="$CLOUDPICKLE_ZIP:$PYTHONPATH"
+fi
+
 log="$FLINK_LOG_DIR/flink-$FLINK_IDENT_STRING-python-udf-boot-$HOSTNAME.log"
 
 ${python} -m pyflink.fn_execution.boot $@ 2>&1 | tee -a ${log}
diff --git a/flink-python/lib/cloudpickle-1.2.2-src.zip b/flink-python/lib/cloudpickle-1.2.2-src.zip
new file mode 100644
index 0000000000000000000000000000000000000000..82bc04ec2740210a4fbd2c4cd1ba0947be478b07
GIT binary patch
literal 23425
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
P^=WlO1ORSy|2q0V9$Eww

literal 0
HcmV?d00001

diff --git a/flink-python/lib/cloudpickle-LICENSE.txt b/flink-python/lib/cloudpickle-LICENSE.txt
new file mode 100644
index 0000000000000..d112c4806aa90
--- /dev/null
+++ b/flink-python/lib/cloudpickle-LICENSE.txt
@@ -0,0 +1,32 @@
+This module was extracted from the `cloud` package, developed by
+PiCloud, Inc.
+
+Copyright (c) 2015, Cloudpickle contributors.
+Copyright (c) 2012, Regents of the University of California.
+Copyright (c) 2009 PiCloud, Inc. http://www.picloud.com.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+    * 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.
+    * Neither the name of the University of California, Berkeley 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
+HOLDER 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.
diff --git a/flink-python/src/main/resources/META-INF/NOTICE b/flink-python/src/main/resources/META-INF/NOTICE
index b02bb4d2bb536..b2107533d628c 100644
--- a/flink-python/src/main/resources/META-INF/NOTICE
+++ b/flink-python/src/main/resources/META-INF/NOTICE
@@ -53,6 +53,7 @@ See bundled license files for details
 - com.google.protobuf:protobuf-java:3.7.1
 - com.google.protobuf:protobuf-java-util:3.7.1
 - com.google.auth:google-auth-library-credentials:0.13.0
+- cloudpickle:1.2.2
 
 This project bundles the following dependencies under the MIT license. (https://opensource.org/licenses/MIT)
 See bundled license files for details.
diff --git a/flink-python/src/main/resources/META-INF/licenses/LICENSE.cloudpickle b/flink-python/src/main/resources/META-INF/licenses/LICENSE.cloudpickle
new file mode 100644
index 0000000000000..d112c4806aa90
--- /dev/null
+++ b/flink-python/src/main/resources/META-INF/licenses/LICENSE.cloudpickle
@@ -0,0 +1,32 @@
+This module was extracted from the `cloud` package, developed by
+PiCloud, Inc.
+
+Copyright (c) 2015, Cloudpickle contributors.
+Copyright (c) 2012, Regents of the University of California.
+Copyright (c) 2009 PiCloud, Inc. http://www.picloud.com.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+    * 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.
+    * Neither the name of the University of California, Berkeley 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
+HOLDER 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.
diff --git a/licenses-binary/LICENSE.cloudpickle b/licenses-binary/LICENSE.cloudpickle
new file mode 100644
index 0000000000000..d112c4806aa90
--- /dev/null
+++ b/licenses-binary/LICENSE.cloudpickle
@@ -0,0 +1,32 @@
+This module was extracted from the `cloud` package, developed by
+PiCloud, Inc.
+
+Copyright (c) 2015, Cloudpickle contributors.
+Copyright (c) 2012, Regents of the University of California.
+Copyright (c) 2009 PiCloud, Inc. http://www.picloud.com.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+    * 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.
+    * Neither the name of the University of California, Berkeley 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
+HOLDER 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.
diff --git a/licenses/LICENSE.cloudpickle b/licenses/LICENSE.cloudpickle
new file mode 100644
index 0000000000000..d112c4806aa90
--- /dev/null
+++ b/licenses/LICENSE.cloudpickle
@@ -0,0 +1,32 @@
+This module was extracted from the `cloud` package, developed by
+PiCloud, Inc.
+
+Copyright (c) 2015, Cloudpickle contributors.
+Copyright (c) 2012, Regents of the University of California.
+Copyright (c) 2009 PiCloud, Inc. http://www.picloud.com.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+    * 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.
+    * Neither the name of the University of California, Berkeley 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
+HOLDER 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.