51 # artifacts are staged.
53 # Artifacts that should be staged when client calls devserver RPC to stage an
56 # Artifacts that should be staged when client calls devserver RPC to stage an
61 # Artifacts that should be staged when client calls devserver RPC to stage an
210 def _get_storage_server_for_artifacts(artifacts=None):  argument
211     """Gets the appropriate storage server for the given artifacts.
213     @param artifacts: A list of artifacts we need to stage.
214     @return: The address of the storage server that has these artifacts.
215              The default image storage server if no artifacts are specified.
219     if artifacts and factory_artifact and factory_artifact in artifacts:
933     sets of artifacts. This base class abstracts the shared functions between
957     def create_metadata(server_name, image, artifacts=None, files=None):  argument
964         @param artifacts: A list of artifacts.
973         if artifacts:
974             metadata['artifacts'] = ' '.join(artifacts)
1141         """Polling devserver.is_staged until all artifacts are staged.
1145         @return: True if all artifacts are staged in devserver.
1152             @return: True if all artifacts are staged in devserver. False
1156                     the artifacts. devserver raises an HTTPError or a CmdError
1192         """Helper method to make a urlopen call, and wait for artifacts staged.
1234     def _stage_artifacts(self, build, artifacts, files, archive_url, **kwargs):  argument
1235         """Tell the devserver to download and stage |artifacts| from |image|
1238         This is the main call point for staging any specific artifacts for a
1239         given build. To see the list of artifacts one can stage see:
1245         @param artifacts: A list of artifacts.
1257                     _get_storage_server_for_artifacts(artifacts), build)
1259         artifacts_arg = ','.join(artifacts) if artifacts else ''
1263                          ('artifacts=%s files=%s ' % (artifacts_arg, files_arg),
1266         staging_info = ('build=%s, artifacts=%s, files=%s, archive_url=%s' %
1267                         (build, artifacts, files, archive_url))
1268         logging.info('Staging artifacts on devserver %s: %s',
1273                          'artifacts': artifacts_arg,
1277             f = {'artifacts': artifacts_arg,
1284             logging.info('Finished staging artifacts: %s', staging_info)
1292                  'artifacts': artifacts_arg,
1299         """Helper method to make a urlopen call, and wait for artifacts staged.
1307     def _trigger_download(self, build, artifacts, files, synchronous=True,  argument
1316         staging before returning. Otherwise only the artifacts necessary
1319         artifacts have finished staging.
1339                   'artifacts': artifacts,
1355             self._finish_download(build, artifacts, files, **kwargs_build_info)
1358     def _finish_download(self, build, artifacts, files, **kwargs_build_info):  argument
1363         before all artifacts have been staged. This method contacts the
1379                   'artifacts': artifacts,
1393     def locate_file(self, file_name, artifacts, build, build_info):  argument
1397         the given file name inside specified build artifacts.
1400         @param artifacts: A list of artifact names to search for the file.
1414                                      'look for file %s in artifacts %s.' %
1415                                      (file_name, artifacts))
1417                   'artifacts': artifacts}
1423             # artifacts. Therefore, os_type for devserver calls is `android` for
1497     The calls to devserver to stage artifacts, including stage and download, are
1499     devserver to stage certain artifacts, devserver handles the call and starts
1500     staging artifacts in a new thread, and return |Success| without waiting for
1502     devserver's is_staged call until all artifacts are staged.
1504     running out, as staging artifacts might take long time, and cherrypy starts
1509         """A container for URLs of staged artifacts.
1526                                   artifacts='',
1529         """Polling devserver.is_staged until all artifacts are staged.
1532         @param artifacts: Comma separated list of artifacts to download.
1535         @return: True if all artifacts are staged in devserver.
1538                   'artifacts': artifacts,
1547                       artifacts,  argument
1552         """Helper method to make a urlopen call, and wait for artifacts staged.
1556         @param artifacts: Comma separated list of artifacts to download.
1564         @param clean: Force re-loading artifacts/files from cloud, ignoring
1573                 'artifacts': artifacts,
1582     def stage_artifacts(self, image=None, artifacts=None, files='',  argument
1584         """Tell the devserver to download and stage |artifacts| from |image|.
1586          This is the main call point for staging any specific artifacts for a
1587         given build. To see the list of artifacts one can stage see:
1594         @param artifacts: A list of artifacts.
1604         if not artifacts and not files:
1607         self._stage_artifacts(image, artifacts, files, archive_url, **kwargs)
1635         staging before returning. Otherwise only the artifacts necessary
1638         artifacts have finished staging.
1648         artifacts = _ARTIFACTS_TO_BE_STAGED_FOR_IMAGE
1649         self._trigger_download(image, artifacts, files='',
1681         before all artifacts have been staged. This method contacts the
1689         artifacts = _ARTIFACTS_TO_BE_STAGED_FOR_IMAGE_WITH_AUTOTEST
1690         self._finish_download(image, artifacts, files='')
1845     The calls to devserver to stage artifacts, including stage and download, are
1847     devserver to stage certain artifacts, devserver handles the call and starts
1848     staging artifacts in a new thread, and return |Success| without waiting for
1850     devserver's is_staged call until all artifacts are staged.
1852     running out, as staging artifacts might take long time, and cherrypy starts
1857                                   archive_url=None, artifacts='', files=''):
1858         """Polling devserver.is_staged until all artifacts are staged.
1865         @param artifacts: Comma separated list of artifacts to download.
1868         @return: True if all artifacts are staged in devserver.
1873                   'artifacts': artifacts,
1883                       artifacts, files, error_message,  argument
1885         """Helper method to make a urlopen call, and wait for artifacts staged.
1893         @param artifacts: Comma separated list of artifacts to download.
1909                   'artifacts': artifacts,
1920                         image=None, artifacts=None, files='', archive_url=None):
1921         """Tell the devserver to download and stage |artifacts| from |image|.
1923          This is the main call point for staging any specific artifacts for a
1924         given build. To see the list of artifacts one can stage see:
1936         @param artifacts: A list of artifacts.
1953         if not artifacts and not files:
1960         self._stage_artifacts(build, artifacts, files, archive_url,
1963     def trigger_download(self, target, build_id, branch, artifacts=None,  argument
1971         staging before returning. Otherwise only the artifacts necessary
1974         artifacts have finished staging.
1980         @param artifacts: A string of artifacts separated by comma. If None,
1981                use the default artifacts for Android or Brillo build.
1983         @param os: OS artifacts to download (android/brillo).
1994         if not artifacts:
1996             artifacts = (
1999         self._trigger_download(build, artifacts, files=files,
2007         before all artifacts have been staged. This method contacts the
2015         @param os: OS artifacts to download (android/brillo).
2024         artifacts = (
2027         self._finish_download(build, artifacts, files='', **android_build_info)