// 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.common.collect.ImmutableSet; 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 Set eval(QueryEnvironment env, QueryExpression expression, List args) throws QueryException, InterruptedException { Set toSet = args.get(0).getExpression().eval(env); Set targets = args.get(1).getExpression().eval(env); ImmutableSet.Builder visible = ImmutableSet.builder(); for (T target : targets) { if (visibleToAll(env, toSet, target)) { visible.add(target); } } return visible.build(); } /** * Returns true if {@code target} is visible to all targets in {@code toSet}. */ private 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 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; } }