Quelle  hooks.go   Sprache: unbekannt

// Copyright 2016 Google Inc. All rights reserved.
//
// 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.

package android

import (
 "fmt"
 "path"
 "reflect"
 "runtime"

 "github.com/google/blueprint"
 "github.com/google/blueprint/proptools"
)

// This file implements hooks that external module types can use to inject logic into existing
// module types.  Each hook takes an interface as a parameter so that new methods can be added
// to the interface without breaking existing module types.

// Load hooks are run after the module's properties have been filled from the blueprint file, but
// before the module has been split into architecture variants, and before defaults modules have
// been applied.
type LoadHookContext interface {
 EarlyModuleContext

 AppendProperties(...interface{})
 PrependProperties(...interface{})
 CreateModule(ModuleFactory, ...interface{}) Module
 CreateModuleInDirectory(ModuleFactory, string, ...interface{}) Module

 registerScopedModuleType(name string, factory blueprint.ModuleFactory)
 moduleFactories() map[string]blueprint.ModuleFactory
}

// Add a hook that will be called once the module has been loaded, i.e. its
// properties have been initialized from the Android.bp file.
//
// Consider using SetDefaultableHook to register a hook for any module that implements
// DefaultableModule as the hook is called after any defaults have been applied to the
// module which could reduce duplication and make it easier to use.
func AddLoadHook(m blueprint.Module, hook func(LoadHookContext)) {
 blueprint.AddLoadHook(m, func(ctx blueprint.LoadHookContext) {
  actx := &loadHookContext{
   earlyModuleContext: m.(Module).base().earlyModuleContextFactory(ctx),
   bp:                 ctx,
  }
  hook(actx)
 })
}

func AddLoadHookWithPriority(m blueprint.Module, hook func(LoadHookContext), priority int) {
 blueprint.AddLoadHookWithPriority(m, func(ctx blueprint.LoadHookContext) {
  actx := &loadHookContext{
   earlyModuleContext: m.(Module).base().earlyModuleContextFactory(ctx),
   bp:                 ctx,
  }
  hook(actx)
 }, priority)
}

type loadHookContext struct {
 earlyModuleContext
 bp     blueprint.LoadHookContext
 module Module
}

func (l *loadHookContext) moduleFactories() map[string]blueprint.ModuleFactory {
 return l.bp.ModuleFactories()
}

func (l *loadHookContext) appendPrependHelper(props []interface{},
 extendFn func([]interface{}, interface{}, proptools.ExtendPropertyFilterFunc) error) {
 for _, p := range props {
  err := extendFn(l.Module().base().GetProperties(), p, nil)
  if err != nil {
   if propertyErr, ok := err.(*proptools.ExtendPropertyError); ok {
    l.PropertyErrorf(propertyErr.Property, "%s", propertyErr.Err.Error())
   } else {
    panic(err)
   }
  }
 }
}
func (l *loadHookContext) AppendProperties(props ...interface{}) {
 l.appendPrependHelper(props, proptools.AppendMatchingProperties)
}

func (l *loadHookContext) Config() Config {
 // LoadHookContext cannot be generic, but must read all configuration values
 // because it is called before loading module properties.
 return l.earlyModuleContext.EarlyModuleContext.Config().(Config)
}

func (l *loadHookContext) PrependProperties(props ...interface{}) {
 l.appendPrependHelper(props, proptools.PrependMatchingProperties)
}

func (l *loadHookContext) createModule(factory blueprint.ModuleFactory, name string, props ...interface{}) Module {
 return bpModuleToModule(l.bp.CreateModule(factory, name, props...))
}

func (l *loadHookContext) createModuleInDirectory(factory blueprint.ModuleFactory, name, moduleDir string, props ...interface{}) Module {
 return bpModuleToModule(l.bp.CreateModuleInDirectory(factory, name, moduleDir, props...))
}

type specifyDirectory struct {
 specified bool
 directory string
}

func doesNotSpecifyDirectory() specifyDirectory {
 return specifyDirectory{
  specified: false,
  directory: "",
 }
}

func specifiesDirectory(directory string) specifyDirectory {
 return specifyDirectory{
  specified: true,
  directory: directory,
 }
}

type createModuleContext interface {
 Module() Module
 HasMutatorFinished(mutatorName string) bool
 createModule(blueprint.ModuleFactory, string, ...interface{}) Module
 createModuleInDirectory(blueprint.ModuleFactory, string, string, ...interface{}) Module
}

func createModule(ctx createModuleContext, factory ModuleFactory, ext string, specifyDirectory specifyDirectory, props ...interface{}) Module {
 if ctx.HasMutatorFinished("defaults") {
  // Creating modules late is oftentimes problematic, because they don't have earlier
  // mutators run on them. Prevent making modules after the defaults mutator has run.
  panic("Cannot create a module after the defaults mutator has finished")
 }

 inherited := []interface{}{&ctx.Module().base().commonProperties}

 var typeName string
 if typeNameLookup, ok := ModuleTypeByFactory()[reflect.ValueOf(factory)]; ok {
  typeName = typeNameLookup
 } else {
  factoryPtr := reflect.ValueOf(factory).Pointer()
  factoryFunc := runtime.FuncForPC(factoryPtr)
  filePath, _ := factoryFunc.FileLine(factoryPtr)
  typeName = fmt.Sprintf("%s_%s", path.Base(filePath), factoryFunc.Name())
 }
 typeName = typeName + "_" + ext

 var module Module
 if specifyDirectory.specified {
  module = ctx.createModuleInDirectory(ModuleFactoryAdaptor(factory), typeName, specifyDirectory.directory, append(inherited, props...)...).(Module)
 } else {
  module = ctx.createModule(ModuleFactoryAdaptor(factory), typeName, append(inherited, props...)...).(Module)
 }

 if ctx.Module().base().variableProperties != nil && module.base().variableProperties != nil {
  src := ctx.Module().base().variableProperties
  dst := []interface{}{
   module.base().variableProperties,
   // Put an empty copy of the src properties into dst so that properties in src that are not in dst
   // don't cause a "failed to find property to extend" error.
   proptools.CloneEmptyProperties(reflect.ValueOf(src)).Interface(),
  }
  err := proptools.AppendMatchingProperties(dst, src, nil)
  if err != nil {
   panic(err)
  }
 }

 return module
}

func (l *loadHookContext) CreateModule(factory ModuleFactory, props ...interface{}) Module {
 return createModule(l, factory, "_loadHookModule", doesNotSpecifyDirectory(), props...)
}

func (l *loadHookContext) CreateModuleInDirectory(factory ModuleFactory, directory string, props ...interface{}) Module {
 return createModule(l, factory, "_loadHookModule", specifiesDirectory(directory), props...)
}

func (l *loadHookContext) registerScopedModuleType(name string, factory blueprint.ModuleFactory) {
 l.bp.RegisterScopedModuleType(name, factory)
}

type InstallHookContext interface {
 ModuleContext
 SrcPath() Path
 Path() InstallPath
 Symlink() bool
}

// Install hooks are run after a module creates a rule to install a file or symlink.
// The installed path is available from InstallHookContext.Path(), and
// InstallHookContext.Symlink() will be true if it was a symlink.
func AddInstallHook(m blueprint.Module, hook func(InstallHookContext)) {
 h := &m.(Module).base().hooks
 h.install = append(h.install, hook)
}

type installHookContext struct {
 ModuleContext
 srcPath Path
 path    InstallPath
 symlink bool
}

var _ InstallHookContext = &installHookContext{}

func (x *installHookContext) SrcPath() Path {
 return x.srcPath
}

func (x *installHookContext) Path() InstallPath {
 return x.path
}

func (x *installHookContext) Symlink() bool {
 return x.symlink
}

func (x *hooks) runInstallHooks(ctx ModuleContext, srcPath Path, path InstallPath, symlink bool) {
 if len(x.install) > 0 {
  mctx := &installHookContext{
   ModuleContext: ctx,
   srcPath:       srcPath,
   path:          path,
   symlink:       symlink,
  }
  for _, x := range x.install {
   x(mctx)
   if mctx.Failed() {
    return
   }
  }
 }
}

// AddPostGenerateAndroidBuildActionsHook adds a hook that runs immediately after
// the module's GenerateAndroidBuildActions method is called, allowing modules
// to inject custom logic when sharing that method.
func AddPostGenerateAndroidBuildActionsHook(m blueprint.Module, hook func(ctx ModuleContext)) {
 h := &m.(Module).base().hooks
 h.postGenerateAndroidBuildActions = append(h.postGenerateAndroidBuildActions, hook)
}

func (x *hooks) runPostGenerateAndroidBuildActionsHooks(ctx ModuleContext) {
 if len(x.postGenerateAndroidBuildActions) > 0 {
  for _, x := range x.postGenerateAndroidBuildActions {
   x(ctx)
   if ctx.Failed() {
    return
   }
  }
 }
}

type hooks struct {
 install                         []func(InstallHookContext)
 postGenerateAndroidBuildActions []func(ModuleContext)
}