// Copyright 2014 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.rules.objc; import com.google.common.base.Optional; import com.google.common.collect.ImmutableList; import com.google.common.collect.Iterables; import com.google.devtools.build.lib.actions.Artifact; import com.google.devtools.build.lib.util.Preconditions; /** * Artifacts related to compilation. Any rule containing compilable sources will create an instance * of this class. */ final class CompilationArtifacts { static class Builder { // TODO(bazel-team): Should these be sets instead of just iterables? private Iterable<Artifact> srcs = ImmutableList.of(); private Iterable<Artifact> nonArcSrcs = ImmutableList.of(); private Iterable<Artifact> additionalHdrs = ImmutableList.of(); private Iterable<Artifact> privateHdrs = ImmutableList.of(); private Iterable<Artifact> precompiledSrcs = ImmutableList.of(); private Optional<Artifact> pchFile; private IntermediateArtifacts intermediateArtifacts; Builder addSrcs(Iterable<Artifact> srcs) { this.srcs = Iterables.concat(this.srcs, srcs); return this; } Builder addNonArcSrcs(Iterable<Artifact> nonArcSrcs) { this.nonArcSrcs = Iterables.concat(this.nonArcSrcs, nonArcSrcs); return this; } /** * Adds header artifacts that should be directly accessible to dependers, but aren't specified * in the hdrs attribute. {@code additionalHdrs} should not be a {@link NestedSet}, as it will * be flattened when added. */ Builder addAdditionalHdrs(Iterable<Artifact> additionalHdrs) { this.additionalHdrs = Iterables.concat(this.additionalHdrs, additionalHdrs); return this; } /** * Adds header artifacts that should not be directly accessible to dependers. * {@code privateHdrs} should not be a {@link NestedSet}, as it will be flattened when added. */ Builder addPrivateHdrs(Iterable<Artifact> privateHdrs) { this.privateHdrs = Iterables.concat(this.privateHdrs, privateHdrs); return this; } /** * Adds precompiled sources (.o files). */ Builder addPrecompiledSrcs(Iterable<Artifact> precompiledSrcs) { this.precompiledSrcs = Iterables.concat(this.precompiledSrcs, precompiledSrcs); return this; } Builder setPchFile(Optional<Artifact> pchFile) { Preconditions.checkState(this.pchFile == null, "pchFile is already set to: %s", this.pchFile); this.pchFile = Preconditions.checkNotNull(pchFile); return this; } Builder setIntermediateArtifacts(IntermediateArtifacts intermediateArtifacts) { Preconditions.checkState(this.intermediateArtifacts == null, "intermediateArtifacts is already set to: %s", this.intermediateArtifacts); this.intermediateArtifacts = intermediateArtifacts; return this; } Builder addAllSources(CompilationArtifacts otherArtifacts) { return this.addNonArcSrcs(otherArtifacts.getNonArcSrcs()) .addSrcs(otherArtifacts.getSrcs()) .addPrecompiledSrcs(otherArtifacts.getPrecompiledSrcs()) .addPrivateHdrs(otherArtifacts.getPrivateHdrs()) .addAdditionalHdrs(otherArtifacts.getAdditionalHdrs()); } CompilationArtifacts build() { Optional<Artifact> archive = Optional.absent(); if (!Iterables.isEmpty(srcs) || !Iterables.isEmpty(nonArcSrcs) || !Iterables.isEmpty(precompiledSrcs)) { archive = Optional.of(intermediateArtifacts.archive()); } return new CompilationArtifacts( srcs, nonArcSrcs, additionalHdrs, privateHdrs, precompiledSrcs, archive, pchFile); } } private final Iterable<Artifact> srcs; private final Iterable<Artifact> nonArcSrcs; private final Optional<Artifact> archive; private final Iterable<Artifact> additionalHdrs; private final Iterable<Artifact> privateHdrs; private final Iterable<Artifact> precompiledSrcs; private final Optional<Artifact> pchFile; private CompilationArtifacts( Iterable<Artifact> srcs, Iterable<Artifact> nonArcSrcs, Iterable<Artifact> additionalHdrs, Iterable<Artifact> privateHdrs, Iterable<Artifact> precompiledSrcs, Optional<Artifact> archive, Optional<Artifact> pchFile) { this.srcs = Preconditions.checkNotNull(srcs); this.nonArcSrcs = Preconditions.checkNotNull(nonArcSrcs); this.additionalHdrs = Preconditions.checkNotNull(additionalHdrs); this.privateHdrs = Preconditions.checkNotNull(privateHdrs); this.precompiledSrcs = Preconditions.checkNotNull(precompiledSrcs); this.archive = Preconditions.checkNotNull(archive); this.pchFile = Preconditions.checkNotNull(pchFile); } public Iterable<Artifact> getSrcs() { return srcs; } public Iterable<Artifact> getNonArcSrcs() { return nonArcSrcs; } /** * Returns the public headers that aren't included in the hdrs attribute. */ public Iterable<Artifact> getAdditionalHdrs() { return additionalHdrs; } /** * Returns the private headers from the srcs attribute, which may by imported by any source or * header in this target, but not by sources or headers of dependers. */ public Iterable<Artifact> getPrivateHdrs() { return privateHdrs; } /** * Returns .o files provided to the build directly as srcs. */ public Iterable<Artifact> getPrecompiledSrcs() { return precompiledSrcs; } /** * Returns the output archive library (.a) file created by combining object files of the srcs, * non arc srcs, and precompiled srcs of this artifact collection. Returns absent if there * are no such source files for which to create an archive library. */ public Optional<Artifact> getArchive() { return archive; } public Optional<Artifact> getPchFile() { return pchFile; } }