Move checkbin and download to use buildops. (kivy#1671)

* Move checkbin and download to Buildops.


This is part of a larger refactoring to simplify the Buildozer class.

* Remove checkbin() and download() methods (plus some definitions only used by download().
* Migrates all references to use the Buildops equivalents.
* Migrate shelling out to "curl"  to use download instead.

Note: The Buildops versions have completely different implementations to the original Buildozer ones, but the semantics are the same. New versions are more platform-independent, expected to be faster and don't use deprecated  library calls.

* Correct name of urllib base exception

* Avoid string splitting

buildozer/__init__.py

@@ -12,12 +12,11 @@
 from copy import copy
 from fnmatch import fnmatch
 import os
-from os import environ, unlink, walk, sep, listdir
+from os import environ, walk, sep, listdir
 from os.path import join, exists, dirname, realpath, splitext, expanduser
 import re
 from re import search
 import select
-from shutil import which
 from subprocess import Popen, PIPE, TimeoutExpired
 import sys
 from sys import stdout, stderr, exit
@@ -27,7 +26,6 @@
 import shlex
 import pexpect
 
-from urllib.request import FancyURLopener
 try:
     import fcntl
 except ImportError:
@@ -43,15 +41,6 @@
 SIMPLE_HTTP_SERVER_PORT = 8000
 
 
-class ChromeDownloader(FancyURLopener):
-    version = (
-        'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 '
-        '(KHTML, like Gecko) Chrome/28.0.1500.71 Safari/537.36')
-
-
-urlretrieve = ChromeDownloader().retrieve
-
-
 class Buildozer:
 
     standard_cmds = ('distclean', 'update', 'debug', 'release',
@@ -149,19 +138,6 @@ def build(self):
         # flag to prevent multiple build
         self.target._build_done = True
 
-    #
-    # Internal check methods
-    #
-
-    def checkbin(self, msg, fn):
-        self.logger.debug('Search for {0}'.format(msg))
-        executable_location = which(fn)
-        if executable_location:
-            self.logger.debug(' -> found at {0}'.format(executable_location))
-            return realpath(executable_location)
-        self.logger.error('{} not found, please install it.'.format(msg))
-        exit(1)
-
     def cmd(self, command, **kwargs):
         # prepare the environ, based on the system + our own env
         env = environ.copy()
@@ -493,27 +469,6 @@ def clean_platform(self):
             return
         buildops.rmdir(self.platform_dir)
 
-    def download(self, url, filename, cwd=None):
-        def report_hook(index, blksize, size):
-            if size <= 0:
-                progression = '{0} bytes'.format(index * blksize)
-            else:
-                progression = '{0:.2f}%'.format(
-                        index * blksize * 100. / float(size))
-            if "CI" not in environ:
-                stdout.write('- Download {}\r'.format(progression))
-                stdout.flush()
-
-        url = url + filename
-        if cwd:
-            filename = join(cwd, filename)
-        if buildops.file_exists(filename):
-            unlink(filename)
-
-        self.logger.debug('Downloading {0}'.format(url))
-        urlretrieve(url, filename, report_hook)
-        return filename
-
     def get_version(self):
         c = self.config
         has_version = c.has_option('app', 'version')

buildozer/targets/android.py

@@ -306,11 +306,10 @@ def check_requirements(self):
         else:
             path.append(os.environ['PATH'])
         self.buildozer.environ['PATH'] = ':'.join(path)
-        checkbin = self.buildozer.checkbin
-        checkbin('Git (git)', 'git')
-        checkbin('Cython (cython)', 'cython')
-        checkbin('Java compiler (javac)', self.javac_cmd)
-        checkbin('Java keytool (keytool)', self.keytool_cmd)
+        buildops.checkbin('Git (git)', 'git')
+        buildops.checkbin('Cython (cython)', 'cython')
+        buildops.checkbin('Java compiler (javac)', self.javac_cmd)
+        buildops.checkbin('Java keytool (keytool)', self.keytool_cmd)
 
     def _p4a_have_aab_support(self):
         returncode = self._p4a(["aab", "-h"], break_on_error=False)[2]
@@ -354,9 +353,10 @@ def _install_apache_ant(self):
         self.logger.info('Android ANT is missing, downloading')
         archive = 'apache-ant-{0}-bin.tar.gz'.format(APACHE_ANT_VERSION)
         url = 'https://archive.apache.org/dist/ant/binaries/'
-        self.buildozer.download(url,
-                                archive,
-                                cwd=ant_dir)
+        buildops.download(
+            url,
+            archive,
+            cwd=ant_dir)
         self.buildozer.file_extract(archive,
                                     cwd=ant_dir)
         self.logger.info('Apache ANT installation done.')
@@ -382,9 +382,10 @@ def _install_android_sdk(self):
             os.makedirs(sdk_dir)
 
         url = 'https://dl.google.com/android/repository/'
-        self.buildozer.download(url,
-                                archive,
-                                cwd=sdk_dir)
+        buildops.download(
+            url,
+            archive,
+            cwd=sdk_dir)
 
         self.logger.info('Unpacking Android SDK')
         self.buildozer.file_extract(archive,
@@ -444,7 +445,7 @@ def _install_android_ndk(self):
         else:
             url = 'https://dl.google.com/android/ndk/'
 
-        self.buildozer.download(url,
+        buildops.download(url,
                                 archive,
                                 cwd=self.buildozer.global_platform_dir)
 
@@ -598,7 +599,7 @@ def _check_aidl(self, v_build_tools):
                                                   'build-tools')
         aidl_cmd = join(self.android_sdk_dir, 'build-tools',
                         str(v_build_tools), 'aidl')
-        self.buildozer.checkbin('Aidl', aidl_cmd)
+        buildops.checkbin('Aidl', aidl_cmd)
         _, _, returncode = self.buildozer.cmd(aidl_cmd,
                                               break_on_error=False,
                                               show_output=False)

buildozer/targets/ios.py

@@ -75,17 +75,16 @@ def __init__(self, buildozer):
     def check_requirements(self):
         if sys.platform != "darwin":
             raise NotImplementedError("Only macOS is supported for iOS target")
-        checkbin = self.buildozer.checkbin
         cmd = self.buildozer.cmd
 
-        checkbin('Xcode xcodebuild', 'xcodebuild')
-        checkbin('Xcode xcode-select', 'xcode-select')
-        checkbin('Git git', 'git')
-        checkbin('Cython cython', 'cython')
-        checkbin('pkg-config', 'pkg-config')
-        checkbin('autoconf', 'autoconf')
-        checkbin('automake', 'automake')
-        checkbin('libtool', 'libtool')
+        buildops.checkbin('Xcode xcodebuild', 'xcodebuild')
+        buildops.checkbin('Xcode xcode-select', 'xcode-select')
+        buildops.checkbin('Git git', 'git')
+        buildops.checkbin('Cython cython', 'cython')
+        buildops.checkbin('pkg-config', 'pkg-config')
+        buildops.checkbin('autoconf', 'autoconf')
+        buildops.checkbin('automake', 'automake')
+        buildops.checkbin('libtool', 'libtool')
 
         self.logger.debug('Check availability of a iPhone SDK')
         sdk = cmd('xcodebuild -showsdks | fgrep "iphoneos" |'

buildozer/targets/osx.py

@@ -8,6 +8,7 @@
 
 from os.path import exists, join, abspath, dirname
 from subprocess import check_call, check_output
+import urllib.error
 
 import buildozer.buildops as buildops
 from buildozer.target import Target
@@ -28,9 +29,9 @@ def ensure_sdk(self):
 
         self.logger.info('kivy-sdk-packager does not exist, clone it')
         platdir = self.buildozer.platform_dir
-        check_call(
-            ('curl', '-O', '-L',
-                'https://github.com/kivy/kivy-sdk-packager/archive/master.zip'),
+        buildops.download(
+            'https://github.com/kivy/kivy-sdk-packager/archive/master.zip',
+            'master.zip',
             cwd=platdir)
         check_call(('unzip', 'master.zip'), cwd=platdir)
         buildops.file_remove(join(platdir, 'master.zip'))
@@ -44,16 +45,18 @@ def download_kivy(self, cwd):
         else:
             if not exists(join(cwd, 'Kivy.dmg')):
                 self.logger.info('Downloading kivy...')
-                status_code = check_output((
-                    'curl', '-L', '--write-out', '%{http_code}',
-                    '-o', 'Kivy.dmg',
-                    f'https://kivy.org/downloads/{current_kivy_vers}/Kivy.dmg'),
-                    cwd=cwd)
-
-                if status_code == "404":
+                try:
+                    buildops.download(
+                        f'https://kivy.org/downloads/{current_kivy_vers}/Kivy.dmg',
+                        'Kivy.dmg',
+                        cwd=cwd
+                    )
+                except urllib.error.URLError:
                     self.logger.error(
-                        "Unable to download the Kivy App. Check osx.kivy_version in your buildozer.spec, and verify "
-                        "Kivy servers are accessible. https://kivy.org/downloads/")
+                        "Unable to download the Kivy App. "
+                        "Check osx.kivy_version in your buildozer.spec, and "
+                        "verify Kivy servers are accessible. "
+                        "https://kivy.org/downloads/")
                     buildops.file_remove(join(cwd, "Kivy.dmg"))
                     sys.exit(1)
 

tests/targets/test_android.py

@@ -10,7 +10,7 @@
 from tests.targets.utils import (
     init_buildozer,
     patch_buildozer,
-    patch_buildozer_checkbin,
+    patch_buildops_checkbin,
     patch_buildozer_cmd,
     patch_buildops_file_exists,
 )
@@ -20,8 +20,8 @@ def patch_buildozer_cmd_expect():
     return patch_buildozer("cmd_expect")
 
 
-def patch_buildozer_download():
-    return patch_buildozer("download")
+def patch_buildops_download():
+    return mock.patch("buildozer.buildops.download")
 
 
 def patch_buildozer_file_extract():
@@ -155,7 +155,7 @@ def test_check_requirements(self):
         assert not hasattr(target_android, "adb_args")
         assert not hasattr(target_android, "javac_cmd")
         assert "PATH" not in buildozer.environ
-        with patch_buildozer_checkbin() as m_checkbin:
+        with patch_buildops_checkbin() as m_checkbin:
             target_android.check_requirements()
         assert m_checkbin.call_args_list == [
             mock.call("Git (git)", "git"),
@@ -182,7 +182,7 @@ def test_check_configuration_tokens(self):
     def test_install_android_sdk(self, platform):
         """Basic tests for the _install_android_sdk() method."""
         target_android = init_target(self.temp_dir)
-        with patch_buildops_file_exists() as m_file_exists, patch_buildozer_download() as m_download:
+        with patch_buildops_file_exists() as m_file_exists, patch_buildops_download() as m_download:
             m_file_exists.return_value = True
             sdk_dir = target_android._install_android_sdk()
         assert m_file_exists.call_args_list == [
@@ -191,7 +191,7 @@ def test_install_android_sdk(self, platform):
         assert m_download.call_args_list == []
         assert sdk_dir.endswith(".buildozer/android/platform/android-sdk")
         with patch_buildops_file_exists() as m_file_exists, \
-                patch_buildozer_download() as m_download, \
+                patch_buildops_download() as m_download, \
                 patch_buildozer_file_extract() as m_file_extract, \
                 patch_platform(platform):
             m_file_exists.return_value = False

tests/targets/test_ios.py

@@ -9,7 +9,7 @@
 from buildozer.targets.ios import TargetIos
 from tests.targets.utils import (
     init_buildozer,
-    patch_buildozer_checkbin,
+    patch_buildops_checkbin,
     patch_buildozer_cmd,
     patch_buildops_file_exists,
     patch_logger_error,
@@ -56,7 +56,7 @@ def test_check_requirements(self):
         buildozer = target.buildozer
         assert not hasattr(target, "javac_cmd")
         assert "PATH" not in buildozer.environ
-        with patch_buildozer_checkbin() as m_checkbin:
+        with patch_buildops_checkbin() as m_checkbin:
             target.check_requirements()
         assert m_checkbin.call_args_list == [
             mock.call("Xcode xcodebuild", "xcodebuild"),

tests/targets/utils.py

@@ -14,8 +14,8 @@ def patch_buildozer_cmd():
     return patch_buildozer("cmd")
 
 
-def patch_buildozer_checkbin():
-    return patch_buildozer("checkbin")
+def patch_buildops_checkbin():
+    return mock.patch("buildozer.buildops.checkbin")
 
 
 def patch_buildops_file_exists():

tests/test_buildozer.py

@@ -125,7 +125,7 @@ def test_android_ant_path(self):
         target = TargetAndroid(buildozer=buildozer)
 
         # Mock first run
-        with mock.patch('buildozer.Buildozer.download') as download, \
+        with mock.patch('buildozer.buildops.download') as download, \
                 mock.patch('buildozer.Buildozer.file_extract') as m_file_extract, \
                 mock.patch('os.makedirs'):
             ant_path = target._install_apache_ant()