• Home
• org.scalatest
• scalatest-app_3
• 3.2.19
• source code
• Distributor.scala

×

Project download

Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $

You can buy this project and download/modify it how often you want.

org.scalatest.Distributor.scala Maven / Gradle / Ivy

/*
 * Copyright 2001-2013 Artima, Inc.
 *
 * 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 org.scalatest

/**
 * Trait whose instances facilitate parallel execution of Suites.
 * An optional Distributor is passed to the run method of Suite. If a
 * Distributor is indeed passed, trait Suite's implementation of run will
 * populate that Distributor with its nested Suites (by passing them to the Distributor's
 * apply method) rather than executing the nested Suites directly. It is then up to another thread or process
 * to execute those Suites.
 *
 * 

 * If you have a set of nested Suites that must be executed sequentially, you can mix in trait
 * SequentialNestedSuiteExecution, which overrides runNestedSuites and
 * calls super's runNestedSuites implementation, passing in None for the
 * Distributor.
 * 
 * 
 * 

 * Implementations of this trait must be thread safe.
 * 
 *
 * @author Bill Venners
 */
trait Distributor {
  
  /**
   * Puts a Suite into the Distributor.
   *
   * 

   * The Distributor can decide which, if any, of the passed ArgsSuite's apply method. For example, a Distributor
   * may pass itself wrapped in a Some in the Args it passes to the Suite's run
   * method instead of the args.distributor value.
   * 
   *
   * @param suite the Suite to put into the Distributor.
   * @param args a Args containing objects that may be passed to the Suite's
   *             run method via a Args instance.
   *
   * @throws NullArgumentException if either suite or tracker is null.
   */
  def apply(suite: Suite, args: Args): Status
}