SP\Spiderling\TraverseTrait

Complexity

Total Complexity

22

Size/Duplication

Total Lines	254
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	8

Test Coverage

Coverage

100%

Importance

Changes	8
Bugs	0	Features	3

23 Methods

Rating	Name	Duplication	Size	Complexity
	getCrawler()	0	1	?
	queryIds()	0	1	?
A	getArray()	0	4	1
A	getLinkArray()	0	4	1
A	getButtonArray()	0	4	1
A	getFieldArray()	0	4	1
A	getLabelArray()	0	4	1
A	get()	0	4	1
A	getLink()	0	4	1
A	getButton()	0	4	1
A	getField()	0	4	1
A	getLabel()	0	4	1
A	newEmptyNode()	0	4	1
A	clickOn()	0	8	1
A	clickLink()	0	8	1
A	clickButton()	0	8	1
A	setField()	0	8	1
A	setFieldFile()	0	8	1
A	check()	0	8	1
A	newNode()	0	4	1
A	query()	0	7	1
A	queryFirst()	0	6	2
A	select()	0	9	1

<?php

namespace SP\Spiderling;

/**
 * @author    Ivan Kerin <ikerin@gmail.com>
 * @copyright 2015, Clippings Ltd.
 * @license   http://spdx.org/licenses/BSD-3-Clause
 */
trait TraverseTrait
{
    /**
     * @return CrawlerInterface
     */
    abstract public function getCrawler();

    /**
     * @param  Query\AbstractQuery $query
     * @return array
     */
    abstract public function queryIds(Query\AbstractQuery $query);

    /**
     * @param  string $id
     * @return Node
     */
    public function newNode($id)
    {
        return new Node($this->getCrawler(), $id);
    }

    /**
     * @return EmptyNode
     */
    public function newEmptyNode(Query\AbstractQuery $query = null)
    {
        return new EmptyNode($this->getCrawler(), $query);
    }

    /**
     * @param  Query\AbstractQuery $query
     * @return Node[]
     */
    public function query(Query\AbstractQuery $query)
    {
        return array_map(
            [$this, 'newNode'],
            $this->queryIds($query)
        );
    }

    /**
     * @param  Query\AbstractQuery $query
     * @return Node
     */
    public function queryFirst(Query\AbstractQuery $query)
    {
        $nodes = $this->query($query);

        return reset($nodes) ?: $this->newEmptyNode($query);
    }

    /**
     * @param  string         $selector
     * @param  Query\Filters  $filters
     * @return Node[]
     */
    public function getArray($selector, Query\Filters $filters = null)
    {
        return $this->query(new Query\Css($selector, $filters));
    }

    /**
     * @param  string         $selector
     * @param  Query\Filters  $filters
     * @return Node[]
     */
    public function getLinkArray($selector, Query\Filters $filters = null)
    {
        return $this->query(new Query\Link($selector, $filters));
    }

    /**
     * @param  string         $selector
     * @param  Query\Filters  $filters
     * @return Node[]
     */
    public function getButtonArray($selector, Query\Filters $filters = null)
    {
        return $this->query(new Query\Button($selector, $filters));
    }

    /**
     * @param  string         $selector
     * @param  Query\Filters  $filters
     * @return Node[]
     */
    public function getFieldArray($selector, Query\Filters $filters = null)
    {
        return $this->query(new Query\Field($selector, $filters));
    }

    /**
     * @param  string         $selector
     * @param  Query\Filters  $filters
     * @return Node[]
     */
    public function getLabelArray($selector, Query\Filters $filters = null)
    {
        return $this->query(new Query\Label($selector, $filters));
    }

    /**
     * @param  string         $selector
     * @param  Query\Filters  $filters
     * @return Node
     */
    public function get($selector, Query\Filters $filters = null)
    {
        return $this->queryFirst(new Query\Css($selector, $filters));
    }

    /**
     * @param  string         $selector
     * @param  Query\Filters  $filters
     * @return Node
     */
    public function getLink($selector, Query\Filters $filters = null)
    {
        return $this->queryFirst(new Query\Link($selector, $filters));
    }

    /**
     * @param  string         $selector
     * @param  Query\Filters  $filters
     * @return Node
     */
    public function getButton($selector, Query\Filters $filters = null)
    {
        return $this->queryFirst(new Query\Button($selector, $filters));
    }

    /**
     * @param  string         $selector
     * @param  Query\Filters  $filters
     * @return Node
     */
    public function getField($selector, Query\Filters $filters = null)
    {
        return $this->queryFirst(new Query\Field($selector, $filters));
    }

    /**
     * @param  string         $selector
     * @param  Query\Filters  $filters
     * @return Node
     */
    public function getLabel($selector, Query\Filters $filters = null)
    {
        return $this->queryFirst(new Query\Label($selector, $filters));
    }

    /**
     * @param  string         $selector
     * @param  Query\Filters  $filters
     * @return self
     */
    public function clickOn($selector, Query\Filters $filters = null)
    {
        $this
            ->get($selector, $filters)
            ->click();

        return $this;
    }

    /**
     * @param  string         $selector
     * @param  Query\Filters  $filters
     * @return self
     */
    public function clickLink($selector, Query\Filters $filters = null)
    {
        $this
            ->getLink($selector, $filters)
            ->click();

        return $this;
    }

    /**
     * @param  string         $selector
     * @param  Query\Filters  $filters
     * @return self
     */
    public function clickButton($selector, Query\Filters $filters = null)
    {
        $this
            ->getButton($selector, $filters)
            ->click();

        return $this;
    }

    /**
     * @param  string         $selector
     * @param  mixed          $value
     * @param  Query\Filters  $filters
     * @return self
     */
    public function setField($selector, $value, Query\Filters $filters = null)
    {
        $this
            ->getField($selector, $filters)
            ->setValue($value);

        return $this;
    }

    /**
     * @param  string         $selector
     * @param  mixed          $file
     * @param  Query\Filters  $filters
     * @return self
     */
    public function setFieldFile($selector, $file, Query\Filters $filters = null)
    {
        $this
            ->getField($selector, $filters)
            ->setFile($file);

        return $this;
    }

    /**
     * @param  string $selector
     * @return self
     */
    public function check($selector, Query\Filters $filters = null)
    {
        $this
            ->getField($selector, $filters)
            ->click();

        return $this;
    }

    /**
     * @param  string $selector
     * @param  string         $selector
     * @param  Query\Filters  $filters
     * @return self
     */
    public function select($selector, $optionText, Query\Filters $filters = null)
    {
        $this
            ->getField($selector, $filters)
                ->get('option', new Query\Filters(['text' => $optionText]))
                    ->select();

        return $this;
    }
}