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

Go to download
/*
 * 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

@deprecated("Please use org.scalatest.diagrams.AnchorValue of diagrams module.")
private[org] case class AnchorValue(anchor: Int, value: Any)

/**
 * A trait that represent an expression recorded by DiagrammedExprMacro, which includes the following members:
 *
 * 
 * a boolean value
 * an anchor that records the position of this expression
 * anchor values of this expression (including sub-expressions)
 * 
 *
 * DiagrammedExpr is used by code generated from DiagrammedAssertionsMacro, it needs to be public
 * so that the generated code can be compiled.  It is expected that ScalaTest users would ever need to use DiagrammedExpr
 * directly.
 */
@deprecated("Please use org.scalatest.diagrams.DiagrammedExpr of diagrams module.") 
trait DiagrammedExpr[T] {
  val anchor: Int
  def anchorValues: List[AnchorValue]
  def value: T

  protected[scalatest] def eliminateDuplicates(anchorValues: List[AnchorValue]): List[AnchorValue] =
    (anchorValues.groupBy(_.anchor).map { case (anchor, group) =>
      group.last
    }).toList
}

/**
 * DiagrammedExpr companion object that provides factory methods to create different sub types of DiagrammedExpr
 *
 * DiagrammedExpr is used by code generated from DiagrammedAssertionsMacro, it needs to be public
 * so that the generated code can be compiled.  It is expected that ScalaTest users would ever need to use DiagrammedExpr
 * directly.
 */
@deprecated("Please use org.scalatest.diagrams.DiagrammedExpr of diagrams module.") 
object DiagrammedExpr {

  /**
   * Create simple DiagrammedExpr that wraps expressions that is not Select, Apply or TypeApply.
   *
   * @param expression the expression value
   * @param anchor the anchor of the expression
   * @return a simple DiagrammedExpr
   */
  def simpleExpr[T](expression: T, anchor: Int): DiagrammedExpr[T] = new DiagrammedSimpleExpr(expression, anchor)

  /**
   * Create apply DiagrammedExpr that wraps Apply or TypeApply expression.
   *
   * @param qualifier the qualifier of the Apply or TypeApply expression
   * @param args the arguments of the Apply or TypeApply expression
   * @param value the expression value
   * @param anchor the anchor of the expression
   * @return an apply DiagrammedExpr
   */
  def applyExpr[T](qualifier: DiagrammedExpr[_], args: List[DiagrammedExpr[_]], value: T, anchor: Int): DiagrammedExpr[T] =
    new DiagrammedApplyExpr(qualifier, args, value, anchor)

  /**
   * Create select DiagrammedExpr that wraps Select expression.
   *
   * @param qualifier the qualifier of the Apply or TypeApply expression
   * @param value the expression value
   * @param anchor the anchor of the expression
   * @return a select DiagrammedExpr
   */
  def selectExpr[T](qualifier: DiagrammedExpr[_], value: T, anchor: Int): DiagrammedExpr[T] =
    new DiagrammedSelectExpr(qualifier, value, anchor)
}

@deprecated("Please use org.scalatest.diagrams.DiagrammedSimpleExpr of diagrams module.")
private[scalatest] class DiagrammedSimpleExpr[T](val value: T, val anchor: Int) extends DiagrammedExpr[T] {
  def anchorValues = List(AnchorValue(anchor, value))
}

@deprecated("Please use org.scalatest.diagrams.DiagrammedApplyExpr of diagrams module.")
private[scalatest] class DiagrammedApplyExpr[T](qualifier: DiagrammedExpr[_], args: List[DiagrammedExpr[_]], val value: T, val anchor: Int) extends DiagrammedExpr[T] {

  def anchorValues = {
    val quantifierAnchorValues = eliminateDuplicates(qualifier.anchorValues)

    val argsAnchorValues =
      args.flatMap { arg =>
        eliminateDuplicates(arg.anchorValues)
      }

    quantifierAnchorValues.toList ::: AnchorValue(anchor, value) :: argsAnchorValues.filter(_.anchor >= 0)
  }
}

@deprecated("Please use org.scalatest.diagrams.DiagrammedSelectExpr of diagrams module.")
private[scalatest] class DiagrammedSelectExpr[T](qualifier: DiagrammedExpr[_], val value: T, val anchor: Int) extends DiagrammedExpr[T] {
  def anchorValues = {
    val quantifierAnchorValues = eliminateDuplicates(qualifier.anchorValues)

    quantifierAnchorValues.toList ::: List(AnchorValue(anchor, value))
  }
}