tools/build/bazel/javadoc.bzl

# Copyright 2015 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.

JAVA_DOCS="-link https://docs.oracle.com/javase/8/docs/api/"

def _impl(ctx):
  dir = ctx.label.name
  jar = ctx.outputs.jar

  dep_list = []
  for dep in ctx.files.deps:
    dep_list += [dep.path]

  src_list = []
  for src in ctx.files.srcs:
    src_list += [src.path]

  cmd = [
      "mkdir %s" % dir,
      "javadoc -encoding utf8 -quiet -tag onos.rsModel:a:\"onos model\" %s -d %s -cp %s %s" \
          % (JAVA_DOCS, dir, ":".join(dep_list), " ".join(src_list)),
      "jar cf %s -C %s ." % (jar.path, dir),
  ]

  ctx.action(
      inputs = ctx.files.srcs + ctx.files.deps,
      outputs = [jar],
      progress_message = "Generating javadocs jar for %s" %  ctx.attr.name,
      command = ";\n".join(cmd)
  )

javadoc = rule(
    attrs = {
        "deps": attr.label_list(allow_files = True),
        "srcs": attr.label_list(allow_files = True),
    },
    implementation = _impl,
    outputs = {"jar" : "%{name}.jar"},
)