Cursor - Code Metrics - Maslosoft/Mangan - Measure and Improve Code Quality continuously with Scrutinizer

Cursor A
last analyzed 2021-06-22 16:13 UTC

↳ Parent: Project

Complexity

Total Complexity

Size/Duplication

Total Lines	144
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	1

Test Coverage

Coverage

57.58%

Importance

Changes

Metric	Value
wmc	13
lcom	1
cbo	1
dl	0
loc	144
ccs	19
cts	33
cp	0.5758
rs	10
c	0
b	0
f	0

11 Methods

Rating	Name	Size	Complexity
A	__construct()	6	2
A	getCursor()	4	1
A	current()	10	2
A	key()	4	1
A	next()	4	1
A	rewind()	4	1
A	valid()	4	1
A	count()	4	1
A	limit()	4	1
A	offset()	4	1
A	sort()	4	1

<?php

/**
 * This software package is licensed under AGPL or Commercial license.
 *
 * @package maslosoft/mangan
 * @licence AGPL or Commercial
 * @copyright Copyright (c) Piotr Masełkowski <[email protected]>
 * @copyright Copyright (c) Maslosoft
 * @copyright Copyright (c) Others as mentioned in code
 * @link https://maslosoft.com/mangan/
 */

namespace Maslosoft\Mangan;

use Countable;
use Iterator;
use Maslosoft\Addendum\Interfaces\AnnotatedInterface;
use Maslosoft\Mangan\Interfaces\Adapters\FinderCursorInterface;
use Maslosoft\Mangan\Transformers\RawArray;
use MongoCursor;
use UnexpectedValueException;

/**
 * Cursor
 *
 * Cursor object, that behaves much like the MongoCursor,
 * but this one returns instantiated objects
 * @author Ianaré Sévi
 * @author Dariusz Górecki <[email protected]>
 * @author Invenzzia Group, open-source division of CleverIT company http://www.invenzzia.org
 * @copyright 2011 CleverIT http://www.cleverit.com.pl
 * @since v1.3.4
 */
class Cursor implements Iterator, Countable
{

	/**
	 * MongoCursor returned by the query
	 * @var FinderCursorInterface|MongoCursor
	 * @since v1.3.4
	 */
	private $cursor;

	/**
	 * Model used for instantiating objects
	 * @var AnnotatedInterface
	 * @since v1.3.4
	 */
	private $model;

	/**
	 * Construct a new Cursor
	 *
	 * @param FinderCursorInterface|MongoCursor $cursor the cursor returned by the query
	 * @param AnnotatedInterface $model the model for instantiating objects
	 * @since v1.3.4
	 */
	public function __construct(Iterator $cursor, AnnotatedInterface $model)
	{
		assert($cursor instanceof FinderCursorInterface || $cursor instanceof MongoCursor, new UnexpectedValueException(sprintf('Expected `%s` or `%s` got `%s`', FinderCursorInterface::class, MongoCursor::class, get_class($cursor))));
		$this->cursor = $cursor;
		$this->model = $model;
	}

	/**
	 * Return MongoCursor for additional tuning
	 *
	 * @return FinderCursorInterface|MongoCursor the cursor used for this query
	 * @since v1.3.4
	 */
	public function getCursor()
	{
		return $this->cursor;
	}

	/**
	 * Return the current element
	 * @return AnnotatedInterface|Document|null
	 * @since v1.3.4
	 */
	public function current()
	{
		$document = $this->cursor->current();
		if (empty($document))
		{
			return null;
		}

		return RawArray::toModel($document, $this->model);
function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
	}

	/**
	 * Return the key of the current element
	 * @return scalar
	 * @since v1.3.4
	 */
	public function key()
	{
		return $this->cursor->key();
	}

	/**
	 * Move forward to next element
	 * @return void
	 * @since v1.3.4
	 */
	public function next()
	{
		$this->cursor->next();
	}

	/**
	 * Rewind the Iterator to the first element
	 * @return void
	 * @since v1.3.4
	 */
	public function rewind()
	{
		$this->cursor->rewind();
	}

	/**
	 * Checks if current position is valid
	 * @return boolean
	 * @since v1.3.4
	 */
	public function valid()
	{
		return $this->cursor->valid();
	}

	/**
	 * Returns the number of documents found
	 * {@see http://www.php.net/manual/en/mongocursor.count.php}
	 * @param boolean $foundOnly default FALSE
	 * @return integer count of documents found
	 * @since v1.3.4
	 */
	public function count($foundOnly = false)
	{
		return $this->cursor->count($foundOnly);
	}

	/**
	 * Apply a limit to this cursor
	 * {@see http://www.php.net/manual/en/mongocursor.limit.php}
	 * @param integer $limit new limit
	 * @since v1.3.4
	 */
	public function limit($limit)
	{
		$this->cursor->limit($limit);
	}

	/**
	 * Skip a $offset records
	 * {@see http://www.php.net/manual/en/mongocursor.skip.php}
	 * @param integer $offset new skip
	 * @since v1.3.4
	 */
	public function offset($offset)
	{
		$this->cursor->skip($offset);
	}

	/**
	 * Apply sorting directives
	 * {@see http://www.php.net/manual/en/mongocursor.sort.php}
	 * @param array $fields sorting directives
	 * @since v1.3.4
	 */
	public function sort(array $fields)
	{
		$this->cursor->sort($fields);
	}

}


1		<?php
2
3		/**
4		* This software package is licensed under AGPL or Commercial license.
5		*
6		* @package maslosoft/mangan
7		* @licence AGPL or Commercial
8		* @copyright Copyright (c) Piotr Masełkowski <[email protected]>
9		* @copyright Copyright (c) Maslosoft
10		* @copyright Copyright (c) Others as mentioned in code
11		* @link https://maslosoft.com/mangan/
12		*/
13
14		namespace Maslosoft\Mangan;
15
16		use Countable;
17		use Iterator;
18		use Maslosoft\Addendum\Interfaces\AnnotatedInterface;
19		use Maslosoft\Mangan\Interfaces\Adapters\FinderCursorInterface;
20		use Maslosoft\Mangan\Transformers\RawArray;
21		use MongoCursor;
22		use UnexpectedValueException;
23
24		/**
25		* Cursor
26		*
27		* Cursor object, that behaves much like the MongoCursor,
28		* but this one returns instantiated objects
29		* @author Ianaré Sévi
30		* @author Dariusz Górecki <[email protected]>
31		* @author Invenzzia Group, open-source division of CleverIT company http://www.invenzzia.org
32		* @copyright 2011 CleverIT http://www.cleverit.com.pl
33		* @since v1.3.4
34		*/
35		class Cursor implements Iterator, Countable
36		{
37
38		/**
39		* MongoCursor returned by the query
40		* @var FinderCursorInterface\|MongoCursor
41		* @since v1.3.4
42		*/
43		private $cursor;
44
45		/**
46		* Model used for instantiating objects
47		* @var AnnotatedInterface
48		* @since v1.3.4
49		*/
50		private $model;
51
52		/**
53		* Construct a new Cursor
54		*
55		* @param FinderCursorInterface\|MongoCursor $cursor the cursor returned by the query
56		* @param AnnotatedInterface $model the model for instantiating objects
57		* @since v1.3.4
58		*/
59	1	public function __construct(Iterator $cursor, AnnotatedInterface $model)
60		{
61	1	assert($cursor instanceof FinderCursorInterface \|\| $cursor instanceof MongoCursor, new UnexpectedValueException(sprintf('Expected `%s` or `%s` got `%s`', FinderCursorInterface::class, MongoCursor::class, get_class($cursor))));
62	1	$this->cursor = $cursor;
63	1	$this->model = $model;
64	1	}
65
66		/**
67		* Return MongoCursor for additional tuning
68		*
69		* @return FinderCursorInterface\|MongoCursor the cursor used for this query
70		* @since v1.3.4
71		*/
72		public function getCursor()
73		{
74		return $this->cursor;
75		}
76
77		/**
78		* Return the current element
79		* @return AnnotatedInterface\|Document\|null
80		* @since v1.3.4
81		*/
82	1	public function current()
83		{
84	1	$document = $this->cursor->current();
85	1	if (empty($document))
86		{
87		return null;
88		}
89
90	1	return RawArray::toModel($document, $this->model);
		0 ignored issues – show Documentation introduced 2019-08-27 12:35 UTC by Report Bug Copy Issue Report `$this->model` is of type `object<Maslosoft\Addendu...ces\AnnotatedInterface>`, but the function expects a `string\|null`. It seems like the type of the argument is not accepted by the function/method which you are calling. In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug. We suggest to add an explicit type cast like in the following example: function acceptsInteger($int) { } $x = '123'; // string "123" // Instead of acceptsInteger($x); // we recommend to use acceptsInteger((integer) $x); Loading history...
91		}
92
93		/**
94		* Return the key of the current element
95		* @return scalar
96		* @since v1.3.4
97		*/
98		public function key()
99		{
100		return $this->cursor->key();
101		}
102
103		/**
104		* Move forward to next element
105		* @return void
106		* @since v1.3.4
107		*/
108	1	public function next()
109		{
110	1	$this->cursor->next();
111	1	}
112
113		/**
114		* Rewind the Iterator to the first element
115		* @return void
116		* @since v1.3.4
117		*/
118	1	public function rewind()
119		{
120	1	$this->cursor->rewind();
121	1	}
122
123		/**
124		* Checks if current position is valid
125		* @return boolean
126		* @since v1.3.4
127		*/
128	1	public function valid()
129		{
130	1	return $this->cursor->valid();
131		}
132
133		/**
134		* Returns the number of documents found
135		* {@see http://www.php.net/manual/en/mongocursor.count.php}
136		* @param boolean $foundOnly default FALSE
137		* @return integer count of documents found
138		* @since v1.3.4
139		*/
140	1	public function count($foundOnly = false)
141		{
142	1	return $this->cursor->count($foundOnly);
143		}
144
145		/**
146		* Apply a limit to this cursor
147		* {@see http://www.php.net/manual/en/mongocursor.limit.php}
148		* @param integer $limit new limit
149		* @since v1.3.4
150		*/
151		public function limit($limit)
152		{
153		$this->cursor->limit($limit);
154		}
155
156		/**
157		* Skip a $offset records
158		* {@see http://www.php.net/manual/en/mongocursor.skip.php}
159		* @param integer $offset new skip
160		* @since v1.3.4
161		*/
162		public function offset($offset)
163		{
164		$this->cursor->skip($offset);
165		}
166
167		/**
168		* Apply sorting directives
169		* {@see http://www.php.net/manual/en/mongocursor.sort.php}
170		* @param array $fields sorting directives
171		* @since v1.3.4
172		*/
173		public function sort(array $fields)
174		{
175		$this->cursor->sort($fields);
176		}
177
178		}
179

Maslosoft / Mangan

Cursor A last analyzed 2021-06-22 16:13 UTC

Complexity

Size/Duplication

Coupling/Cohesion

Test Coverage

Importance

11 Methods

Duplication Side-by-Side

Filter issues like

Cursor A
last analyzed 2021-06-22 16:13 UTC