Files
android_development/gsi/gsi_util/gsi_util.py
SzuWei Lin e3658bd0c1 gsi_util: adding pull subcommand
'pull' command can pull a file from an image file, folder or adb.

The patch includes a "mounter" framework to implement different
source of the system/vendor image. And also includes several
"mounter" implementations.

CompositeMounter integrates all possible mounter implementations.
Usually just using CompositeMounter is enough. With
CompositeMounter, you could access files in different target
with an unique interface, such files in an image file, a folder or
a device with an unique interface. pull.py is an basic example to
use CompositeMounter.

Here are some example to use 'pull' command:

$ ./gsi_util.py pull --system adb:AB0123456789 /system/manifest.xml
$ ./gsi_util.py pull --vendor adb /vendor/compatibility_matrix.xml
$ ./gsi_util.py pull --system system.img /system/build.prop
$ ./gsi_util.py pull --system my/out/folder/system /system/build.prop

As current implementation, accessing files in a the image file requires
root permission. gsi_util will need user to input the password for sudo.

For the detail usage, reference:

$ ./gsi_util.py pull --help

Bug: 71029338
Test: pull /system/build.prop from different targets
Change-Id: Iaeb6352c14ebc24860ed79fc30edd314e225aef9
2018-01-12 11:48:50 +08:00

75 lines
2.2 KiB
Python
Executable File

#!/usr/bin/env python
#
# Copyright 2017 - The Android Open Source Project
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
"""gsi_util command-line utility."""
import argparse
import logging
import sys
class GsiUtil(object):
"""Object for gsi_util command line tool."""
_GSI_UTIL_VERSION = '1.0'
# Adds gsi_util COMMAND here.
# TODO(bowgotsai): auto collect from gsi_util/commands/*.py
_COMMANDS = ['flash_gsi', 'pull', 'hello']
_LOGGING_FORMAT = '%(message)s'
_LOGGING_LEVEL = logging.WARNING
@staticmethod
def _get_module_name(command):
return 'gsi_util.commands.' + command
def run(self, argv):
"""Command-line processor."""
# Sets up default logging.
logging.basicConfig(format=self._LOGGING_FORMAT, level=self._LOGGING_LEVEL)
# Adds top-level --version/--debug argument.
parser = argparse.ArgumentParser()
parser.add_argument('-v', '--version', action='version',
version='%(prog)s {}'.format(self._GSI_UTIL_VERSION))
parser.add_argument(
'-d', '--debug', help='debug mode.', action='store_true')
# Adds subparsers for each COMMAND.
subparsers = parser.add_subparsers(title='COMMAND')
for command in self._COMMANDS:
module_name = self._get_module_name(command)
mod = __import__(module_name, globals(), locals(), ['setup_command_args'])
mod.setup_command_args(subparsers)
args = parser.parse_args(argv[1:])
if args.debug:
logging.getLogger().setLevel(logging.DEBUG)
try:
args.func(args)
except Exception as e:
logging.error('%s: %s', argv[0], e.message)
logging.exception(e)
sys.exit(1)
if __name__ == '__main__':
tool = GsiUtil()
tool.run(sys.argv)