Mutator.swift

// Copyright 2019 Google LLC
//
// 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.

/// A mutator takes an existing program and mutates it in some way, thus producing a new program.
public class Mutator {
    public var stats = ProgramGeneratorStats()

    /// Mutates the given program.
    ///
    /// - Parameters:
    ///   - program: The program to mutate.
    ///   - fuzzer: The fuzzer context for the mutation.
    /// - Returns: The mutated program or nil if the given program could not be mutated.
    public func mutate(_ program: Program, for fuzzer: Fuzzer) -> Program? {
        let b = fuzzer.makeBuilder(forMutating: program)
        b.traceHeader("Mutating \(program.id) with \(name)")
        return mutate(program, using: b)
    }
    
    func mutate(_ program: Program, using b: ProgramBuilder) -> Program? {
        fatalError("This method must be overridden")
    }
    
    /// The name of this mutator.
    public var name: String {
        return String(describing: type(of: self))
    }
}