devtools/templates.mozbuild

   1 # -*- Mode: python; indent-tabs-mode: nil; tab-width: 40 -*-
   2 # vim: set filetype=python:
   3 # This Source Code Form is subject to the terms of the Mozilla Public
   4 # License, v. 2.0. If a copy of the MPL was not distributed with this
   5 # file, You can obtain one at http://mozilla.org/MPL/2.0/.
   6
   7 @template
   8 def DevToolsModules(*modules):
   9     '''Installs JS modules at a resource:// path that corresponds directly to
  10     their source tree location.
  11
  12     For this to work as intended, a moz.build file should be placed in each
  13     source directory which uses this template to install only the JS files in
  14     its own directory.  Subdirectories should use their own moz.build.
  15
  16     By following this pattern, there's less magic to require() and resource://
  17     paths, since they now match the source tree.'''
  18
  19     for m in modules:
  20         if '/' in m:
  21             error('DevToolsModules must be used from the same directory as ' +
  22                   'the files to be installed.')
  23
  24     # jar.mn manifest files are typically used to install files to chrome
  25     # locations.  Instead of doing this, use this DevToolsModules syntax via
  26     # moz.build files to do the installation so that we can enforce correct
  27     # paths based on source tree location.
  28     base = FINAL_TARGET_FILES.chrome.devtools.modules
  29     for dir in RELATIVEDIR.split('/'):
  30         base = base[dir]
  31     base += [m for m in modules]