src/main/java/com/google/devtools/build/lib/bugreport/BugReporter.java

// Copyright 2019 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.bugreport;

import java.util.List;

/**
 * Logs bug reports.
 *
 * <p>This interface is generally fulfilled by {@link #defaultInstance}. It exists to facilitate
 * alternate implementations in tests that intentionally send bug reports, since the default
 * instance throws if invoked during a test case.
 */
public interface BugReporter {

  static BugReporter defaultInstance() {
    return BugReport.REPORTER_INSTANCE;
  }

  /** Reports an exception, see {@link BugReport#sendBugReport(Throwable)}. */
  void sendBugReport(Throwable exception);

  /** Reports an exception, see {@link BugReport#sendBugReport(Throwable, List, String[])}. */
  void sendBugReport(Throwable exception, List<String> args, String... values);

  /** See {@link BugReport#handleCrash}. */
  RuntimeException handleCrash(Throwable throwable, String... args);
}