blob: 171b846ef3a939ef0a0d0b02d17cdc590899571a [file] [log] [blame]
# 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 dump(obj):
print(dir(obj))
for attr in dir(obj):
print("obj.%s = %r" % (attr, getattr(obj, attr)))
def _impl(ctx):
dir = ctx.label.name
jar = ctx.outputs.jar
classpath = ""
for dep in ctx.files.deps:
classpath += ":" + dep.path
src_list = ""
for src in ctx.files.srcs:
if src.path.endswith(".jar"):
src_list += " " + src.path
group_list = ""
for group in ctx.attr.groups:
packages = ""
for p in ctx.attr.groups[group]:
packages += ":" + p
group_list += " -group \"%s\" %s" % (group, packages.replace(":", "", 1))
cmd = [
"mkdir src; cd src",
"for s in %s; do jar xf ../$s; done" % src_list,
"rm -f META-INF/MANIFEST.MF",
"cd ..",
"cp -r docs/src/main/javadoc/* .",
"ls -lR doc-files overview.html",
]
if ctx.attr.internal:
cmd += ["find src -type f | egrep -v 'src/(OSGI|WEB)-INF' >> FILES"]
else:
cmd += ["find src -type f | egrep -v 'src/(OSGI|WEB)-INF' | egrep -v '/(impl|internal)/' >> FILES"]
cmd += [
"javadoc -encoding UTF-8 -overview overview.html -doctitle '%s' -windowtitle '%s' %s -d apidocs -classpath %s -sourcepath src %s @FILES" %
(ctx.attr.title, ctx.attr.title, group_list, classpath.replace(":", "", 1), JAVA_DOCS),
"cp -r doc-files apidocs/doc-files",
"jar cf %s apidocs" % jar.path,
]
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),
)
project_javadoc = rule(
attrs = {
"title": attr.string(),
"overview": attr.string(default = "src/main/javadoc/overview.html"),
"groups": attr.string_list_dict(),
"deps": attr.label_list(allow_files = True),
"srcs": attr.label_list(allow_files = True),
"internal": attr.bool(default = False),
},
implementation = _impl,
outputs = {"jar": "%{name}.jar"},
)