// Copyright 2018 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.runtime;

import com.google.devtools.build.lib.buildeventstream.BuildEventArtifactUploader;
import com.google.devtools.build.lib.buildeventstream.LocalFilesArtifactUploader;
import java.io.IOException;

/** A factory for {@link BuildEventArtifactUploader}. */
public interface BuildEventArtifactUploaderFactory {

  BuildEventArtifactUploaderFactory LOCAL_FILES_UPLOADER_FACTORY =
      (CommandEnvironment env) -> new LocalFilesArtifactUploader();

  /**
   * Returns a new instance of a {@link BuildEventArtifactUploader}. The call is responsible for
   * calling {@link BuildEventArtifactUploader#release()} on the returned instance.
   */
  BuildEventArtifactUploader create(CommandEnvironment env)
      throws InvalidPackagePathSymlinkException;

  /**
   * If the factory reuses a BuildEventArtifactUploader across commands, tear down that uploader now
   * to prepare for <em>blaze</em> shutdown.
   */
  default void shutdown() {}

  /**
   * Exception thrown when initializing the BuildEventArtifactUploader fails due to the package path
   * following invalid symlinks.
   */
  class InvalidPackagePathSymlinkException extends IOException {

    public InvalidPackagePathSymlinkException(IOException e) {
      super(e);
    }
  }
}