aboutsummaryrefslogtreecommitdiffhomepage
path: root/src/main/java/com/google/devtools/build/lib/packages/Target.java
diff options
context:
space:
mode:
Diffstat (limited to 'src/main/java/com/google/devtools/build/lib/packages/Target.java')
-rw-r--r--src/main/java/com/google/devtools/build/lib/packages/Target.java81
1 files changed, 81 insertions, 0 deletions
diff --git a/src/main/java/com/google/devtools/build/lib/packages/Target.java b/src/main/java/com/google/devtools/build/lib/packages/Target.java
new file mode 100644
index 0000000000..ec5bc86f94
--- /dev/null
+++ b/src/main/java/com/google/devtools/build/lib/packages/Target.java
@@ -0,0 +1,81 @@
+// Copyright 2014 Google Inc. 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.packages;
+
+import com.google.devtools.build.lib.events.Location;
+import com.google.devtools.build.lib.packages.License.DistributionType;
+import com.google.devtools.build.lib.syntax.Label;
+import com.google.devtools.build.lib.syntax.SkylarkCallable;
+import com.google.devtools.build.lib.syntax.SkylarkModule;
+
+import java.util.Set;
+
+/**
+ * A node in the build dependency graph, identified by a Label.
+ */
+@SkylarkModule(name = "target", doc = "A BUILD target.")
+public interface Target {
+
+ /**
+ * Returns the label of this target. (e.g. "//foo:bar")
+ */
+ @SkylarkCallable(name = "label", doc = "")
+ Label getLabel();
+
+ /**
+ * Returns the name of this rule (relative to its owning package).
+ */
+ @SkylarkCallable(name = "name", doc = "")
+ String getName();
+
+ /**
+ * Returns the Package to which this rule belongs.
+ */
+ Package getPackage();
+
+ /**
+ * Returns a string describing this kind of target: e.g. "cc_library rule",
+ * "source file", "generated file".
+ */
+ String getTargetKind();
+
+ /**
+ * Returns the rule associated with this target, if any.
+ *
+ * If this is a Rule, returns itself; it this is an OutputFile, returns its
+ * generating rule; if this is an input file, returns null.
+ */
+ Rule getAssociatedRule();
+
+ /**
+ * Returns the license associated with this target.
+ */
+ License getLicense();
+
+ /**
+ * Returns the place where the target was defined.
+ */
+ Location getLocation();
+
+ /**
+ * Returns the set of distribution types associated with this target.
+ */
+ Set<DistributionType> getDistributions();
+
+ /**
+ * Returns the visibility of this target.
+ */
+ RuleVisibility getVisibility();
+}