1 # Copyright (C) 2010 Chris Jerdonek (cjerdonek@webkit.org)
3 # Redistribution and use in source and binary forms, with or without
4 # modification, are permitted provided that the following conditions
6 # 1. Redistributions of source code must retain the above copyright
7 # notice, this list of conditions and the following disclaimer.
8 # 2. Redistributions in binary form must reproduce the above copyright
9 # notice, this list of conditions and the following disclaimer in the
10 # documentation and/or other materials provided with the distribution.
12 # THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS ``AS IS'' AND
13 # ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
14 # WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
15 # DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS BE LIABLE FOR
16 # ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
17 # DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
18 # SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
19 # CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
20 # OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
21 # OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
23 # This module is required for Python to treat this directory as a package.
25 """Autoinstalls third-party code required by WebKit."""
32 from webkitpy.common.system.autoinstall import AutoInstaller
33 from webkitpy.common.system.filesystem import FileSystem
35 _THIRDPARTY_DIR = os.path.dirname(__file__)
36 _AUTOINSTALLED_DIR = os.path.join(_THIRDPARTY_DIR, "autoinstalled")
38 # Putting the autoinstall code into webkitpy/thirdparty/__init__.py
39 # ensures that no autoinstalling occurs until a caller imports from
40 # webkitpy.thirdparty. This is useful if the caller wants to configure
41 # logging prior to executing autoinstall code.
43 # FIXME: If any of these servers is offline, webkit-patch breaks (and maybe
44 # other scripts do, too). See <http://webkit.org/b/42080>.
46 # We put auto-installed third-party modules in this directory--
48 # webkitpy/thirdparty/autoinstalled
50 fs.maybe_make_directory(_AUTOINSTALLED_DIR)
52 init_path = fs.join(_AUTOINSTALLED_DIR, "__init__.py")
53 if not fs.exists(init_path):
54 fs.write_text_file(init_path, "")
56 readme_path = fs.join(_AUTOINSTALLED_DIR, "README")
57 if not fs.exists(readme_path):
58 fs.write_text_file(readme_path,
59 "This directory is auto-generated by WebKit and is "
60 "safe to delete.\nIt contains needed third-party Python "
61 "packages automatically downloaded from the web.")
64 class AutoinstallImportHook(object):
65 def __init__(self, filesystem=None):
66 self._fs = filesystem or FileSystem()
68 def find_module(self, fullname, path):
69 # This method will run before each import. See http://www.python.org/dev/peps/pep-0302/
70 if '.autoinstalled' not in fullname:
73 if '.mechanize' in fullname:
74 self._install_mechanize()
75 elif '.pep8' in fullname:
77 elif '.eliza' in fullname:
79 elif '.irc' in fullname:
81 elif '.pywebsocket' in fullname:
82 self._install_pywebsocket()
83 elif '.buildbot' in fullname:
84 self._install_buildbot()
86 def _install_mechanize(self):
87 self._install("http://pypi.python.org/packages/source/m/mechanize/mechanize-0.2.5.tar.gz",
88 "mechanize-0.2.5/mechanize")
90 def _install_pep8(self):
91 self._install("http://pypi.python.org/packages/source/p/pep8/pep8-0.5.0.tar.gz#md5=512a818af9979290cd619cce8e9c2e2b",
94 # autoinstalled.buildbot is used by BuildSlaveSupport/build.webkit.org-config/mastercfg_unittest.py
95 # and should ideally match the version of BuildBot used at build.webkit.org.
96 def _install_buildbot(self):
97 # The buildbot package uses jinja2, for example, in buildbot/status/web/base.py.
98 # buildbot imports jinja2 directly (as though it were installed on the system),
99 # so the search path needs to include jinja2. We put jinja2 in
100 # its own directory so that we can include it in the search path
101 # without including other modules as a side effect.
102 jinja_dir = self._fs.join(_AUTOINSTALLED_DIR, "jinja2")
103 installer = AutoInstaller(append_to_search_path=True, target_dir=jinja_dir)
104 installer.install(url="http://pypi.python.org/packages/source/J/Jinja2/Jinja2-2.6.tar.gz#md5=1c49a8825c993bfdcf55bb36897d28a2",
105 url_subpath="Jinja2-2.6/jinja2")
107 self._install("http://pypi.python.org/packages/source/b/buildbot/buildbot-0.8.4p2.tar.gz#md5=7597d945724c80c0ab476e833a1026cb", "buildbot-0.8.4p2/buildbot")
109 def _install_eliza(self):
110 installer = AutoInstaller(target_dir=_AUTOINSTALLED_DIR)
111 installer.install(url="http://www.adambarth.com/webkit/eliza",
112 target_name="eliza.py")
114 def _install_irc(self):
115 # Since irclib and ircbot are two top-level packages, we need to import
116 # them separately. We group them into an irc package for better
117 # organization purposes.
118 irc_dir = self._fs.join(_AUTOINSTALLED_DIR, "irc")
119 installer = AutoInstaller(target_dir=irc_dir)
120 installer.install(url="http://downloads.sourceforge.net/project/python-irclib/python-irclib/0.4.8/python-irclib-0.4.8.zip",
121 url_subpath="irclib.py")
122 installer.install(url="http://downloads.sourceforge.net/project/python-irclib/python-irclib/0.4.8/python-irclib-0.4.8.zip",
123 url_subpath="ircbot.py")
125 def _install_pywebsocket(self):
126 pywebsocket_dir = self._fs.join(_AUTOINSTALLED_DIR, "pywebsocket")
127 installer = AutoInstaller(target_dir=pywebsocket_dir)
128 installer.install(url="http://pywebsocket.googlecode.com/files/mod_pywebsocket-0.7.tar.gz",
129 url_subpath="pywebsocket-0.7/src/mod_pywebsocket")
131 def _install(self, url, url_subpath):
132 installer = AutoInstaller(target_dir=_AUTOINSTALLED_DIR)
133 installer.install(url=url, url_subpath=url_subpath)
136 sys.meta_path.append(AutoinstallImportHook())