common/crashing_input_filename.h

// Copyright 2025 The Centipede Authors.
//
// 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
//
//      https://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.

#ifndef FUZZTEST_COMMON_CRASHING_INPUT_FILENAME_H_
#define FUZZTEST_COMMON_CRASHING_INPUT_FILENAME_H_

#include <string>
#include <string_view>

#include "absl/status/statusor.h"

namespace fuzztest::internal {

struct InputFileComponents {
  // The identifier that is used to keep track of the crash over time even if
  // the crash signature or the crashing input changes.
  std::string bug_id;
  // The hash of the crash metadata used to deduplicate crashes.
  std::string crash_signature;
  // The hash of the input.
  std::string input_signature;
};

// Returns the components of an input file extracted from the file name.
// The file name is expected to be in the format
// `<bug_id>-<crash_signature>-<input_signature>` or `<input_signature>` for
// backwards compatibility, where `<crash_signature>` and `<input_signature>`
// don't contain dashes.
absl::StatusOr<InputFileComponents> ParseCrashingInputFilename(
    std::string_view input_file_path);

}  // namespace fuzztest::internal

#endif  // FUZZTEST_COMMON_CRASHING_INPUT_FILENAME_H_