44 # artifacts are staged.
46 # Artifacts that should be staged when client calls devserver RPC to stage an
49 # Artifacts that should be staged when client calls devserver RPC to stage an
54 # Artifacts that should be staged when client calls devserver RPC to stage an
215 def _get_storage_server_for_artifacts(artifacts=None):  argument
216     """Gets the appropriate storage server for the given artifacts.
218     @param artifacts: A list of artifacts we need to stage.
219     @return: The address of the storage server that has these artifacts.
220              The default image storage server if no artifacts are specified.
224     if artifacts and factory_artifact and factory_artifact in artifacts:
859     sets of artifacts. This base class abstracts the shared functions between
883     def create_metadata(server_name, image, artifacts=None, files=None):  argument
890         @param artifacts: A list of artifacts.
899         if artifacts:
900             metadata['artifacts'] = ' '.join(artifacts)
987         """Polling devserver.is_staged until all artifacts are staged.
991         @return: True if all artifacts are staged in devserver.
998             @return: True if all artifacts are staged in devserver. False
1002                     the artifacts. devserver raises an HTTPError or a CmdError
1038         """Helper method to make a urlopen call, and wait for artifacts staged.
1080     def _stage_artifacts(self, build, artifacts, files, archive_url, **kwargs):  argument
1081         """Tell the devserver to download and stage |artifacts| from |image|
1084         This is the main call point for staging any specific artifacts for a
1085         given build. To see the list of artifacts one can stage see:
1091         @param artifacts: A list of artifacts.
1102             archive_url = _get_storage_server_for_artifacts(artifacts) + build
1104         artifacts_arg = ','.join(artifacts) if artifacts else ''
1108                          ('artifacts=%s files=%s ' % (artifacts_arg, files_arg),
1111         staging_info = ('build=%s, artifacts=%s, files=%s, archive_url=%s' %
1112                         (build, artifacts, files, archive_url))
1113         logging.info('Staging artifacts on devserver %s: %s',
1118                          'artifacts': artifacts_arg,
1125             f = {'artifacts': artifacts_arg,
1132             logging.info('Finished staging artifacts: %s', staging_info)
1140                  'artifacts': artifacts_arg,
1147         """Helper method to make a urlopen call, and wait for artifacts staged.
1155     def _trigger_download(self, build, artifacts, files, synchronous=True,  argument
1164         staging before returning. Otherwise only the artifacts necessary
1167         artifacts have finished staging.
1187                   'artifacts': artifacts,
1203             self._finish_download(build, artifacts, files, **kwargs_build_info)
1206     def _finish_download(self, build, artifacts, files, **kwargs_build_info):  argument
1211         before all artifacts have been staged. This method contacts the
1227                   'artifacts': artifacts,
1241     def locate_file(self, file_name, artifacts, build, build_info):  argument
1245         the given file name inside specified build artifacts.
1248         @param artifacts: A list of artifact names to search for the file.
1262                                      'look for file %s in artifacts %s.' %
1263                                      (file_name, artifacts))
1265                   'artifacts': artifacts}
1271             # artifacts. Therefore, os_type for devserver calls is `android` for
1345     The calls to devserver to stage artifacts, including stage and download, are
1347     devserver to stage certain artifacts, devserver handles the call and starts
1348     staging artifacts in a new thread, and return |Success| without waiting for
1350     devserver's is_staged call until all artifacts are staged.
1352     running out, as staging artifacts might take long time, and cherrypy starts
1357         """A container for URLs of staged artifacts.
1372     def wait_for_artifacts_staged(self, archive_url, artifacts='', files=''):  argument
1373         """Polling devserver.is_staged until all artifacts are staged.
1376         @param artifacts: Comma separated list of artifacts to download.
1378         @return: True if all artifacts are staged in devserver.
1381                   'artifacts': artifacts,
1387     def call_and_wait(self, call_name, archive_url, artifacts, files,  argument
1389         """Helper method to make a urlopen call, and wait for artifacts staged.
1393         @param artifacts: Comma separated list of artifacts to download.
1407                   'artifacts': artifacts,
1414     def stage_artifacts(self, image=None, artifacts=None, files='',  argument
1416         """Tell the devserver to download and stage |artifacts| from |image|.
1418          This is the main call point for staging any specific artifacts for a
1419         given build. To see the list of artifacts one can stage see:
1426         @param artifacts: A list of artifacts.
1434         if not artifacts and not files:
1437         self._stage_artifacts(image, artifacts, files, archive_url)
1465         staging before returning. Otherwise only the artifacts necessary
1468         artifacts have finished staging.
1478         artifacts = _ARTIFACTS_TO_BE_STAGED_FOR_IMAGE
1479         self._trigger_download(image, artifacts, files='',
1511         before all artifacts have been staged. This method contacts the
1519         artifacts = _ARTIFACTS_TO_BE_STAGED_FOR_IMAGE_WITH_AUTOTEST
1520         self._finish_download(image, artifacts, files='')
1849                      download the artifacts. devserver raises an HTTPError or
2229     The calls to devserver to stage artifacts, including stage and download, are
2231     devserver to stage certain artifacts, devserver handles the call and starts
2232     staging artifacts in a new thread, and return |Success| without waiting for
2234     devserver's is_staged call until all artifacts are staged.
2236     running out, as staging artifacts might take long time, and cherrypy starts
2241                                   archive_url=None, artifacts='', files=''):
2242         """Polling devserver.is_staged until all artifacts are staged.
2249         @param artifacts: Comma separated list of artifacts to download.
2252         @return: True if all artifacts are staged in devserver.
2257                   'artifacts': artifacts,
2267                       artifacts, files, error_message,  argument
2269         """Helper method to make a urlopen call, and wait for artifacts staged.
2277         @param artifacts: Comma separated list of artifacts to download.
2293                   'artifacts': artifacts,
2304                         image=None, artifacts=None, files='', archive_url=None):
2305         """Tell the devserver to download and stage |artifacts| from |image|.
2307          This is the main call point for staging any specific artifacts for a
2308         given build. To see the list of artifacts one can stage see:
2320         @param artifacts: A list of artifacts.
2337         if not artifacts and not files:
2344         self._stage_artifacts(build, artifacts, files, archive_url,
2360     def trigger_download(self, target, build_id, branch, artifacts=None,  argument
2368         staging before returning. Otherwise only the artifacts necessary
2371         artifacts have finished staging.
2377         @param artifacts: A string of artifacts separated by comma. If None,
2378                use the default artifacts for Android or Brillo build.
2380         @param os: OS artifacts to download (android/brillo).
2391         if not artifacts:
2393             artifacts = (
2396         self._trigger_download(build, artifacts, files=files,
2404         before all artifacts have been staged. This method contacts the
2412         @param os: OS artifacts to download (android/brillo).
2421         artifacts = (
2424         self._finish_download(build, artifacts, files='', **android_build_info)