aboutsummaryrefslogtreecommitdiff
path: root/skylark_library.bzl
blob: 5791b00bbc42a628ec3baf6989429e3812c540f5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
# Copyright 2017 The Bazel Authors. 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.

"""Skylib module containing a library rule for aggregating rules files."""

SkylarkLibraryInfo = provider(
    'Information on contained Skylark rules.',
    fields={
      'srcs': 'Top level rules files.',
      'transitive_srcs': 'Transitive closure of rules files required for ' +
          'interpretation of the srcs',
    },
)

def _skylark_library_impl(ctx):
  deps_files = [depset(x.files, order="postorder") for x in ctx.attr.deps]
  all_files = depset(ctx.files.srcs, order="postorder", transitive=deps_files)
  return [
      # All dependent files should be listed in both `files` and in `runfiles`;
      # this ensures that a `skylark_library` can be referenced as `data` from
      # a separate program, or from `tools` of a genrule().
      DefaultInfo(
          files=all_files,
          runfiles=ctx.runfiles(files=list(all_files)),
      ),

      # We also define our own provider struct, for aggregation and testing.
      SkylarkLibraryInfo(
          srcs=ctx.files.srcs,
          transitive_srcs=all_files,
      ),
  ]

skylark_library = rule(
    implementation=_skylark_library_impl,
    attrs={
        "srcs": attr.label_list(
            allow_files=[".bzl"],
        ),
        "deps": attr.label_list(
            allow_files=[".bzl"],
            providers=[
                [SkylarkLibraryInfo],
            ],
        )
    }
)
"""Creates a logical collection of Skylark .bzl files.

Args:
  srcs: List of `.bzl` files that are processed to create this target.
  deps: List of other `skylark_library` targets that are required by the
    Skylark files listed in `srcs`.

Example:
  Suppose your project has the following structure:

  ```
  [workspace]/
      WORKSPACE
      BUILD
      checkstyle/
          BUILD
          checkstyle.bzl
      lua/
          BUILD
          lua.bzl
          luarocks.bzl
  ```

  In this case, you can have `skylark_library` targets in `checkstyle/BUILD` and
  `lua/BUILD`:

  `checkstyle/BUILD`:

  ```python
  load("@bazel_skylib//:skylark_library.bzl", "skylark_library")

  skylark_library(
      name = "checkstyle-rules",
      srcs = ["checkstyle.bzl"],
  )
  ```

  `lua/BUILD`:

  ```python
  load("@bazel_skylib//:skylark_library.bzl", "skylark_library")

  skylark_library(
      name = "lua-rules",
      srcs = [
          "lua.bzl",
          "luarocks.bzl",
      ],
  )
  ```
"""