third_party/pigweed/repo/pw_build/py/pw_build/nop.py

   1 # Copyright 2019 The Pigweed Authors
   2 #
   3 # Licensed under the Apache License, Version 2.0 (the "License"); you may not
   4 # use this file except in compliance with the License. You may obtain a copy of
   5 # the License at
   6 #
   7 #     https://www.apache.org/licenses/LICENSE-2.0
   8 #
   9 # Unless required by applicable law or agreed to in writing, software
  10 # distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
  11 # WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
  12 # License for the specific language governing permissions and limitations under
  13 # the License.
  14 """Does nothing.
  15
  16 The purpose of this script is to allow for source file dependencies within GN
  17 to be attached to targets that do not typically support them, such as groups.
  18
  19 For example, instead of creating a group target, a pw_python_action target to
  20 run this script can be created. The script can be given a list of input files,
  21 causing GN to rebuild the target and everything that depends on it whenever any
  22 input file is modified.
  23
  24 This is useful in the case where metadata is attached to a group of files but
  25 not collected into a generated_file until a later target.
  26 """