// 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. package com.google.devtools.build.lib.query2.engine; import com.google.common.collect.ImmutableList; import com.google.devtools.build.lib.query2.engine.QueryEnvironment.Argument; import com.google.devtools.build.lib.query2.engine.QueryEnvironment.ArgumentType; import com.google.devtools.build.lib.query2.engine.QueryEnvironment.QueryFunction; import java.util.List; import java.util.Set; /** * A visible(x, y) query expression, which computes the subset of nodes in y * that are visible from all nodes in x. * *
expr ::= VISIBILE '(' expr ',' expr ')'
* *

Example: return targets from the package //bar/baz that are visible to //foo. * *

 * visible(//foo, //bar/baz:*)
 * 
*/ public class VisibleFunction implements QueryFunction { @Override public String getName() { return "visible"; } @Override public int getMandatoryArguments() { return 2; } @Override public List getArgumentTypes() { return ImmutableList.of(ArgumentType.EXPRESSION, ArgumentType.EXPRESSION); } @Override public void eval( final QueryEnvironment env, VariableContext context, QueryExpression expression, List args, final Callback callback) throws QueryException, InterruptedException { final Set toSet = QueryUtil.evalAll(env, context, args.get(0).getExpression()); env.eval(args.get(1).getExpression(), context, new Callback() { @Override public void process(Iterable partialResult) throws QueryException, InterruptedException { for (T t : partialResult) { if (visibleToAll(env, toSet, t)) { callback.process(ImmutableList.of(t)); } } } }); } /** * Returns true if {@code target} is visible to all targets in {@code toSet}. */ private static boolean visibleToAll( QueryEnvironment env, Set toSet, T target) throws QueryException { for (T to : toSet) { if (!visible(env, to, target)) { return false; } } return true; } /** * Returns true if the target {@code from} is visible to the target {@code to}. */ public static boolean visible(QueryEnvironment env, T to, T from) throws QueryException { Set> visiblePackages = env.getAccessor().getVisibility(from); for (QueryVisibility spec : visiblePackages) { if (spec.contains(to)) { return true; } } return false; } }