All Downloads are FREE. Search and download functionalities are using the official Maven repository.

scales.utils.Paths.scala Maven / Gradle / Ivy

There is a newer version: 0.5.0-M1
Show newest version
package scales.utils

import scala.collection.immutable.Stack
import scala.collection.IndexedSeqLike
import scala.collection.generic.CanBuildFrom

/**
 * Represents the Top for a given Path, there isn't a tree above this
 */ 
case class Top[Item <: LeftLike[Item, Tree[Item, Section, CC]], Section, CC[X] <: IndexedSeqLike[X, CC[X]]]() extends LeftLike[Top[Item, Section, CC], Path[Item, Section, CC]] 

/**
 * Positions only have meaning for a given Path(s).
 *
 * Their internal representation may change, as such its private to Paths.
 *
 * @author Chris
 *
 */
trait Position[Item <: LeftLike[Item, Tree[Item, Section, CC]], Section, CC[X] <: IndexedSeqLike[X, CC[X]]] {
  private[utils] val root: Path[Item, Section, CC]
  private[utils] val position: Stack[Int]
}

private[utils] case class PositionImpl[Item <: LeftLike[Item, Tree[Item, Section, CC]], Section, CC[X] <: IndexedSeqLike[X, CC[X]]](val position: Stack[Int], val root: Path[Item, Section, CC]) extends Position[Item, Section, CC]

/**
 * Position in a parent Paths children
 * 
 * @author Chris
 *
 */ // note - lazy is a perf killer for building, probably doesn't save much over interrogation either (given Iterator is used) 
case class Node[Item <: LeftLike[Item, Tree[Item, Section, CC]], Section, CC[X] <: IndexedSeqLike[X, CC[X]]](index: Int, focus: ItemOrTree[Item, Section, CC])

case class Path[Item <: LeftLike[Item, Tree[Item, Section, CC]], Section, CC[X] <: IndexedSeqLike[X, CC[X]]](top: EitherLike[Top[Item,Section,CC], Path[Item, Section, CC]], node: Node[Item, Section, CC])
     (implicit cbf : CanBuildFrom[CC[_], ItemOrTree[Item, Section, CC], CC[ItemOrTree[Item, Section, CC]]]) extends Iterable[Path[Item, Section, CC]] with RightLike[Top[Item, Section, CC], Path[Item, Section, CC]] { self =>

  // for some reason its not liking the types, probably  good one

  def parentTree : Tree[Item, Section, CC] = top.getRight.node.focus.getRight

  def parentCount = if (top.isLeft) 0 else parentTree.children.length

  /** Is there a previous sibling */
  def hasPreviousSibling = (node.index > 0 && node.index <= parentCount)

  /** Does it have a further sibling */
  def hasNextSibling = (node.index > -1 && node.index < (parentCount - 1))

  /**
   * Is the focus an Item?
   */
  def isItem = node.focus.isLeft

  /**
   * Does the focus have a child?
   */
  def hasChildren =
    if (isItem) false
    else children.length != 0

  /**
   * Folds over child or tree
   */ 
  def focus[R]( i : Item => R, t : Tree[Item,Section,CC] => R) : R =
    node.focus.fold(i, t)

  /**
   * Children for a path, don't call unless it is not an item
   */ 
  def children : CC[ItemOrTree[Item,Section,CC]]  = node.focus.right.get.children

  /**
   * Call hasPreviousSibling first to assert there is a previous sibling
   */
  def previousSibling = Path(top, Node(node.index - 1, parentTree.children.apply(node.index - 1)))

  /**
   * Call hasNextSibling first to assert there is a next sibling
   */
  def nextSibling = Path(top, Node(node.index + 1, parentTree.children(node.index + 1)))

  /**
   * get the tree (isItem == false)
   * @return
   */
  def tree() = node.focus.getRight

  /**
   * get the item (isItem == true)
   * @return
   */
  def item() = node.focus.getLeft

  private[this] class ItemIterator() extends Iterator[Path[Item,Section, CC]] { 
    def hasNext = false
    def next() = error("Cannot iterate over an item")
  }

  private[this] class TreeIterator() extends Iterator[Path[Item,Section, CC]] { 
    val c = children.iterator
    var index = -1
    
    def hasNext = c.hasNext

    def next() : Path[Item, Section, CC] = {
      index += 1
      Path(self, Node(index, c.next()))
    }
  }

  /**
   * Provide iterator to the path of the children
   */
  def iterator() = 
    if (isItem)
      new ItemIterator()
    else
      new TreeIterator()

  /**
   * Returns either the first child or none.  Note the child would still need to be unpacked
   * @return
   */
  def firstChild(): Option[Path[Item, Section, CC]] =
    if (!hasChildren) None // can't have a child if its just a data node
    else Some(Path(this, Node(0, children.head)))

  /**
   * Returns either the last child or none.  Note the child would still need to be unpacked
   * @return
   */
  def lastChild(): Option[Path[Item, Section, CC]] = // don't ask children twice
    if (isItem) None // items don't have children
    else {
      val c = children
      if (c.length == 0) None // no children
      else {
	val newPos = c.length - 1
	Some(Path(this,
	  Node(newPos, c(newPos))))
      }
    }
										   
  /**
   * zipUp returns this if it is already the top item (doesn't have a parent to zip), and a
   * newly zipped node when not if the focus has been modified
   */
  def zipUp(): Path[Item, Section, CC] =
    if (top.isLeft) this
    else {
      val path = top.right.get
      val pt = parentTree

      if (pt.children(node.index) eq node.focus) path
      else {
        val parentFocus = // ZIP IT, must be a tree
          subtree(pt.section, pt.children.updated(node.index, node.focus))

        Path(path.top, Node(path.node.index,
          parentFocus))
      }
    }

  /**
   * Replaces this paths focus returning the path for the returned node.
   * @param
   */
  def modify(newFocus: (ItemOrTree[Item, Section, CC]) => ItemOrTree[Item, Section, CC]) =
    Path(top, Node(node.index,
      newFocus(node.focus)))

  /**
   * Removes this node, returning the parent path or None if its top
   * @return
   */
  def removeAndUp(): Option[Path[Item, Section, CC]] =
    if (top.isLeft) None
    else {
      val path = top.right.get
      val tree = path.node.focus.right.get

      val parentFocus = {
	val c = parentTree.children

	if (c.size == 1) {
	  // optimising for pull parse onqnames, if its only one in the parent, set the parent to empty, sucks if its not traversable
	  subtree(tree.section, c.asInstanceOf[scala.collection.Traversable[ItemOrTree[Item, Section, CC]]].companion.empty.asInstanceOf[CC[ItemOrTree[Item, Section, CC]]])
	} else {
	  val parts = parentTree.children.splitAt(node.index)
	  subtree(tree.section, parts._1 ++ parts._2.tail)
	}
	
      }

      Some(
        Path(path.top, Node(path.node.index,
          parentFocus)))
    }

  /**
   * Gets the relative position of this Path
   * DOES NOT perform a zip
   */
  def position(): Position[Item, Section, CC] = {
    @scala.annotation.tailrec
    def makePosition(path: Path[Item, Section, CC], stack: Stack[Int]): (Stack[Int], Path[Item, Section, CC]) = {
      val newStack = stack.push(path.node.index)
      if (path.top.isLeft)
        (newStack, path)
      else
        makePosition(path.top.right.get, newStack)
    }

    val res = makePosition(this, Stack[Int]())
    new PositionImpl[Item,Section,CC](res._1, res._2)
  }

  /**
   * Gives a nicer representation then the standard (Paths(Paths(), Paths).  But still too much info
   *
   * Path( Section | Top, FocusSection | FocusItem)
   *
   * @return
   */
  override def toString(): String = {
    val builder = new java.lang.StringBuilder()

    builder.append("Path(");
    if (top.isLeft)
      builder.append("Top");
    else
      builder.append(top.right.get.tree.section);
    builder.append(",");
    builder.append(node.index);
    builder.append(",");
    if (isItem)
      builder.append(item);
    else
      builder.append(tree.section);
    builder.append(")");

    builder.toString
  }
}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy