1 # Copyright 2013 The Chromium Authors. All rights reserved. 2 # Use of this source code is governed by a BSD-style license that can be 3 # found in the LICENSE file. 4 5 """A module for the prepare command.""" 6 7 import cr 8 9 10 class PrepareCommand(cr.Command): 11 """The implementation of the prepare command. 12 13 The prepare command is used to perform the steps needed to get an output 14 directory ready to use. These should not be the kind of things that need to 15 happen every time you build something, but the rarer things that you re-do 16 only when you get or add new source files, or change your build options. 17 This delegates all it's behavior to implementations of PrepareOut. These will 18 (mostly) be in the cr.actions package. 19 """ 20 21 def __init__(self): 22 super(PrepareCommand, self).__init__() 23 self.help = 'Prepares an output directory' 24 self.description = (""" 25 This does any preparation needed for the output directory, such as 26 running gyp. 27 """) 28 29 def Run(self): 30 self.Prepare() 31 32 @classmethod 33 def UpdateContext(cls): 34 for preparation in PrepareOut.Plugins(): 35 preparation.UpdateContext() 36 37 @classmethod 38 def Prepare(cls): 39 cls.UpdateContext() 40 for preparation in PrepareOut.Plugins(): 41 preparation.Prepare() 42 43 44 class PrepareOut(cr.Plugin, cr.Plugin.Type): 45 """Base class for output directory preparation plugins. 46 47 See PrepareCommand for details. 48 """ 49 50 def UpdateContext(self): 51 """Update the context if needed. 52 53 This is also used by commands that want the environment setup correctly, but 54 are not going to call Prepare directly (such as sync).""" 55 56 def Prepare(self): 57 """All PrepareOut plugins must override this method to do their work.""" 58 raise NotImplementedError('Must be overridden.') 59 60
