TrackingManager::refreshItem() - Code Metrics - Inspection of "Define preserveCase in Service class" - stakx-io/stakx - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — master ( 89bfcf...4ab803 )

by Vladimir

created 2017-06-26 01:59 UTC

TrackingManager::refreshItem() A

↳ Parent: TrackingManager

Complexity

Conditions	1
Paths	1

Size

Total Lines	4
Code Lines	2

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	0
CRAP Score	2

Importance

Changes

Metric	Value
dl	0
loc	4
ccs	0
cts	2
cp	0
rs	10
c	0
b	0
f	0
cc	1
eloc	2
nc	1
nop	1
crap	2

<?php

/**
 * @copyright 2017 Vladimir Jimenez
 * @license   https://github.com/allejo/stakx/blob/master/LICENSE.md MIT
 */

namespace allejo\stakx\Manager;

use allejo\stakx\Command\BuildableCommand;
use allejo\stakx\Document\JailedDocument;
use allejo\stakx\Document\PageView;
use allejo\stakx\Document\TrackableDocument;
use allejo\stakx\Document\TwigDocument;
use allejo\stakx\Service;
use allejo\stakx\System\FileExplorer;
use Symfony\Component\Finder\SplFileInfo;

/**
 * Class TrackingManager.
 */
abstract class TrackingManager extends BaseManager
{
    /**
     * @var FileExplorer
     */
    protected $fileExplorer;

    /**
     * An array corresponding with $folderDefinitions to store metadata regarding a specificc folder.
     *
     * $folderDefinitionsOption['<folder path>'] = array()
     *
     * @var string[]
     */
    protected $folderDefinitionsOptions;


    /**
     * An array of folders which tracked items are stored in.
     *
     * $folderDefinitions[] = '<folder path>'
     *
     * @var string[]
     */
    protected $folderDefinitions;

    /**
     * The storage which contains the same information as $trackedItems but organized by relative file path instead of a
     * namespace or file name without extension.
     *
     * $trackedItemsOptions['<relative file path>'] = mixed
     *
     * @var TrackableDocument[]
     */
    protected $trackedItemsFlattened;


    /**
     * The storage used to cache any information needed for a specific FrontMatterObject or DataItem.
     *
     * For example, with a DataItem, which is just an array, the file path to the original file can be stored in this
     * array to be accessible in the future to refresh the contents without parsing all of the files again.
     *
     * $trackedItemsOptions['<relative file path>'] = array
     *
     * @var array
     */
    protected $trackedItemsOptions;

    /**
     * The storage used for TrackableDocuments in the respective static classes.
     *
     * $trackedItems['<namespace>']['<file name w/o extension>'] = mixed
     * $trackedItems['<file name w/o extension>'] = mixed
     *
     * @var TrackableDocument[]
     */
    protected $trackedItems;

    public function __construct()
    {
        parent::__construct();

        $this->folderDefinitionsOptions = array();
        $this->folderDefinitions = array();
        $this->trackedItemsFlattened = array();
        $this->trackedItemsOptions = array();
        $this->trackedItems = array();
    }

    /**
     * @param SplFileInfo|string $filePath
     *
     * @return mixed|null
     */
    public function createNewItem($filePath)
    {
        return $this->handleTrackableItem($filePath);

    }

    /**
     * Check whether a file is already being tracked.
     *
     * @param string $filePath The relative path of the file
     *
     * @return bool
     */
    public function isTracked($filePath)
    {
        return array_key_exists($filePath, $this->trackedItemsFlattened);
    }

    /**
     * Check to see if a given file path matches this tracker's definition and would be tracked.
     *
     * This function should be used to check whether or not to add a file to this tracker after the initial scan has
     * already happened.
     *
     * @param string $filePath
     *
     * @return bool True if the file is inside a tracked folder
     */
    public function shouldBeTracked($filePath)
    {
        foreach ($this->folderDefinitions as $folder)
        {
            if (substr($filePath, 0, strlen($folder)) === $folder)
            {
                return true;
            }
        }

        return false;
    }

    /**
     * Update the contents of a specified file.
     *
     * @param SplFileInfo|string $filePath The relative path of the file
     *
     * @return PageView
     */
    public function refreshItem($filePath)
    {
        return $this->handleTrackableItem($filePath);

    }

    ///
    // Internal object handling
    ///

    protected function addFileToTracker(SplFileInfo &$file)
    {
        $this->trackedItemsFlattened[$file->getRelativePathname()] = &$file;
    }

    protected function delFileFromTracker(SplFileInfo &$file)
    {
        unset($this->trackedItemsFlattened[$file->getRelativePathname()]);
    }

    /**
     * Add a TrackableDocument to the tracker.
     *
     * @param TrackableDocument $trackedItem
     * @param string|null       $namespace
     */
    protected function addObjectToTracker(TrackableDocument &$trackedItem, $namespace = null)
    {
        if ($namespace == null)

        {
            $this->trackedItems[$trackedItem->getObjectName()] = &$trackedItem;
        }
        else
        {
            $this->trackedItems[$namespace][$trackedItem->getObjectName()] = &$trackedItem;
        }

        $this->trackedItemsFlattened[$trackedItem->getRelativeFilePath()] = &$trackedItem;
    }

    /**
     * Remove an entry from the tracked items array.
     *
     * @param TrackableDocument $trackedItem
     * @param string|null       $namespace
     */
    protected function delObjectFromTracker(TrackableDocument &$trackedItem, $namespace = null)
    {
        if ($namespace == null)

        {
            unset($this->trackedItems[$trackedItem->getObjectName()]);
        }
        else
        {
            unset($this->trackedItems[$namespace][$trackedItem->getObjectName()]);
        }

        unset($this->trackedItemsFlattened[$trackedItem->getRelativeFilePath()]);
    }

    ///
    // Extra options stored for future use
    ///

    /**
     * Save a folder that is tracked by this manager and its respective options.
     *
     * @param string $folderPath
     * @param array  $options
     */
    protected function saveFolderDefinition($folderPath, array $options = array())
    {
        $this->folderDefinitions[] = $folderPath;
        $this->folderDefinitionsOptions[$folderPath] = $options;
    }

    /**
     * Save any options related to an item needed in order to refresh the content.
     *
     * @param string $filePath
     * @param array  $options
     */
    protected function saveTrackerOptions($filePath, array $options = array())
    {
        $this->trackedItemsOptions[$filePath] = $options;
    }

    /**
     * Delete any options that were saved corresponding to an item.
     *
     * @param string $filePath
     */
    protected function forgetTrackerOptions($filePath)
    {
        unset($this->trackedItemsOptions[$filePath]);
    }

    ///
    // Handling of trackable items
    ///

    /**
     * Parse the specified folder for items to track.
     *
     * @param string $path
     * @param array  $options  Special options that will be passed to the static::parseTrackableItem() implementation
     * @param array  $includes
     * @param array  $excludes
     */
    protected function scanTrackableItems($path, array $options = array(), array $includes = array(), array $excludes = array())
    {
        $this->folderDefinitions[] = $this->fs->getRelativePath($path);

        $excludes = empty($excludes) ? self::$documentIgnoreList : $excludes;


        $fileExplorerFlags = array_key_exists('fileExplorer', $options) ? $options['fileExplorer'] : null;
        $this->fileExplorer = FileExplorer::create($path, $excludes, $includes, $fileExplorerFlags);
        $fileExplorer = $this->fileExplorer->getExplorer();

        foreach ($fileExplorer as $file)
        {
            $this->handleTrackableItem($file, $options);
        }
    }

    /**
     * Handle a specific file type, parse it into the appropriate object type, and add it to the tracker.
     *
     * This function should make use of the appropriate functions:
     *
     *  - TrackingManager::addObjectToTracker()
     *  - TrackingManager::addFileToTracker()
     *  - TrackingManager::saveTrackerOptions()
     *
     * @param SplFileInfo $filePath
     * @param mixed       $options
     *
     * @return mixed|null
     */
    abstract protected function handleTrackableItem($filePath, array $options = array());

    ///
    // Utility functions
    ///

    /**
     * Return an array of JailedDocuments created from the tracked items
     *
     * @param array $elements
     *
     * @return JailedDocument[]|JailedDocument[][]
     */
    protected static function getJailedTrackedItems(array &$elements)
    {
        $jailItems = array();

        /**
         * @var string       $key
         * @var TwigDocument $item
         */
        foreach ($elements as &$item)
        {
            if (!Service::getParameter(BuildableCommand::USE_DRAFTS) && $item->isDraft()) { continue; }

            if (empty($item->getNamespace()))
            {
                $jailItems[$item->getObjectName()] = $item->createJail();
            }
            else
            {
                $jailItems[$item->getNamespace()][$item->getObjectName()] = $item->createJail();
            }
        }

        return $jailItems;
    }
}


1		<?php
2
3		/**
4		* @copyright 2017 Vladimir Jimenez
5		* @license https://github.com/allejo/stakx/blob/master/LICENSE.md MIT
6		*/
7
8		namespace allejo\stakx\Manager;
9
10		use allejo\stakx\Command\BuildableCommand;
11		use allejo\stakx\Document\JailedDocument;
12		use allejo\stakx\Document\PageView;
13		use allejo\stakx\Document\TrackableDocument;
14		use allejo\stakx\Document\TwigDocument;
15		use allejo\stakx\Service;
16		use allejo\stakx\System\FileExplorer;
17		use Symfony\Component\Finder\SplFileInfo;
18
19		/**
20		* Class TrackingManager.
21		*/
22		abstract class TrackingManager extends BaseManager
23		{
24		/**
25		* @var FileExplorer
26		*/
27		protected $fileExplorer;
28
29		/**
30		* An array corresponding with $folderDefinitions to store metadata regarding a specificc folder.
31		*
32		* $folderDefinitionsOption['<folder path>'] = array()
33		*
34		* @var string[]
35		*/
36		protected $folderDefinitionsOptions;
		0 ignored issues – show Comprehensibility Naming introduced 2017-03-25 02:33 UTC by Report Bug Copy Issue Report The variable name `$folderDefinitionsOptions` exceeds the maximum configured length of `20`. Very long variable names usually make code harder to read. It is therefore recommended not to make variable names too verbose. Loading history...
37
38		/**
39		* An array of folders which tracked items are stored in.
40		*
41		* $folderDefinitions[] = '<folder path>'
42		*
43		* @var string[]
44		*/
45		protected $folderDefinitions;
46
47		/**
48		* The storage which contains the same information as $trackedItems but organized by relative file path instead of a
49		* namespace or file name without extension.
50		*
51		* $trackedItemsOptions['<relative file path>'] = mixed
52		*
53		* @var TrackableDocument[]
54		*/
55		protected $trackedItemsFlattened;
		0 ignored issues – show Comprehensibility Naming introduced 2017-03-25 02:33 UTC by Report Bug Copy Issue Report The variable name `$trackedItemsFlattened` exceeds the maximum configured length of `20`. Very long variable names usually make code harder to read. It is therefore recommended not to make variable names too verbose. Loading history...
56
57		/**
58		* The storage used to cache any information needed for a specific FrontMatterObject or DataItem.
59		*
60		* For example, with a DataItem, which is just an array, the file path to the original file can be stored in this
61		* array to be accessible in the future to refresh the contents without parsing all of the files again.
62		*
63		* $trackedItemsOptions['<relative file path>'] = array
64		*
65		* @var array
66		*/
67		protected $trackedItemsOptions;
68
69		/**
70		* The storage used for TrackableDocuments in the respective static classes.
71		*
72		* $trackedItems['<namespace>']['<file name w/o extension>'] = mixed
73		* $trackedItems['<file name w/o extension>'] = mixed
74		*
75		* @var TrackableDocument[]
76		*/
77		protected $trackedItems;
78
79	42	public function __construct()
80		{
81	42	parent::__construct();
82
83	42	$this->folderDefinitionsOptions = array();
84	42	$this->folderDefinitions = array();
85	42	$this->trackedItemsFlattened = array();
86	42	$this->trackedItemsOptions = array();
87	42	$this->trackedItems = array();
88	42	}
89
90		/**
91		* @param SplFileInfo\|string $filePath
92		*
93		* @return mixed\|null
94		*/
95		public function createNewItem($filePath)
96		{
97		return $this->handleTrackableItem($filePath);
		0 ignored issues – show Bug introduced 2016-10-10 06:20 UTC by Report Bug Copy Issue Report It seems like `$filePath` defined by parameter `$filePath` on line 95 can also be of type `string`; however, `allejo\stakx\Manager\Tra...::handleTrackableItem()` does only seem to accept `object<Symfony\Component\Finder\SplFileInfo>`, maybe add an additional type check? This check looks at variables that have been passed in as parameters and are passed out again to other methods. If the outgoing method call has stricter type requirements than the method itself, an issue is raised. An additional type check may prevent trouble. Loading history...
98		}
99
100		/**
101		* Check whether a file is already being tracked.
102		*
103		* @param string $filePath The relative path of the file
104		*
105		* @return bool
106		*/
107	1	public function isTracked($filePath)
108		{
109	1	return array_key_exists($filePath, $this->trackedItemsFlattened);
110		}
111
112		/**
113		* Check to see if a given file path matches this tracker's definition and would be tracked.
114		*
115		* This function should be used to check whether or not to add a file to this tracker after the initial scan has
116		* already happened.
117		*
118		* @param string $filePath
119		*
120		* @return bool True if the file is inside a tracked folder
121		*/
122		public function shouldBeTracked($filePath)
123		{
124		foreach ($this->folderDefinitions as $folder)
125		{
126		if (substr($filePath, 0, strlen($folder)) === $folder)
127		{
128		return true;
129		}
130		}
131
132		return false;
133		}
134
135		/**
136		* Update the contents of a specified file.
137		*
138		* @param SplFileInfo\|string $filePath The relative path of the file
139		*
140		* @return PageView
141		*/
142		public function refreshItem($filePath)
143		{
144		return $this->handleTrackableItem($filePath);
		0 ignored issues – show Bug introduced 2017-04-09 23:54 UTC by Report Bug Copy Issue Report It seems like `$filePath` defined by parameter `$filePath` on line 142 can also be of type `string`; however, `allejo\stakx\Manager\Tra...::handleTrackableItem()` does only seem to accept `object<Symfony\Component\Finder\SplFileInfo>`, maybe add an additional type check? This check looks at variables that have been passed in as parameters and are passed out again to other methods. If the outgoing method call has stricter type requirements than the method itself, an issue is raised. An additional type check may prevent trouble. Loading history...
145		}
146
147		///
148		// Internal object handling
149		///
150
151		protected function addFileToTracker(SplFileInfo &$file)
152		{
153		$this->trackedItemsFlattened[$file->getRelativePathname()] = &$file;
154		}
155
156		protected function delFileFromTracker(SplFileInfo &$file)
157		{
158		unset($this->trackedItemsFlattened[$file->getRelativePathname()]);
159		}
160
161		/**
162		* Add a TrackableDocument to the tracker.
163		*
164		* @param TrackableDocument $trackedItem
165		* @param string\|null $namespace
166		*/
167	41	protected function addObjectToTracker(TrackableDocument &$trackedItem, $namespace = null)
168		{
169	41	if ($namespace == null)
		0 ignored issues – show Bug introduced 2017-06-26 02:02 UTC by Report Bug Copy Issue Report It seems like you are loosely comparing `$namespace` of type `string\|null` against `null`; this is ambiguous if the string can be empty. Consider using a strict comparison `===` instead. Loading history...
170		{
171	1	$this->trackedItems[$trackedItem->getObjectName()] = &$trackedItem;
172		}
173		else
174		{
175	40	$this->trackedItems[$namespace][$trackedItem->getObjectName()] = &$trackedItem;
176		}
177
178	41	$this->trackedItemsFlattened[$trackedItem->getRelativeFilePath()] = &$trackedItem;
179	41	}
180
181		/**
182		* Remove an entry from the tracked items array.
183		*
184		* @param TrackableDocument $trackedItem
185		* @param string\|null $namespace
186		*/
187		protected function delObjectFromTracker(TrackableDocument &$trackedItem, $namespace = null)
188		{
189		if ($namespace == null)
		0 ignored issues – show Bug introduced 2017-06-26 02:02 UTC by Report Bug Copy Issue Report It seems like you are loosely comparing `$namespace` of type `string\|null` against `null`; this is ambiguous if the string can be empty. Consider using a strict comparison `===` instead. Loading history...
190		{
191		unset($this->trackedItems[$trackedItem->getObjectName()]);
192		}
193		else
194		{
195		unset($this->trackedItems[$namespace][$trackedItem->getObjectName()]);
196		}
197
198		unset($this->trackedItemsFlattened[$trackedItem->getRelativeFilePath()]);
199		}
200
201		///
202		// Extra options stored for future use
203		///
204
205		/**
206		* Save a folder that is tracked by this manager and its respective options.
207		*
208		* @param string $folderPath
209		* @param array $options
210		*/
211	39	protected function saveFolderDefinition($folderPath, array $options = array())
212		{
213	39	$this->folderDefinitions[] = $folderPath;
214	39	$this->folderDefinitionsOptions[$folderPath] = $options;
215	39	}
216
217		/**
218		* Save any options related to an item needed in order to refresh the content.
219		*
220		* @param string $filePath
221		* @param array $options
222		*/
223	2	protected function saveTrackerOptions($filePath, array $options = array())
224		{
225	2	$this->trackedItemsOptions[$filePath] = $options;
226	2	}
227
228		/**
229		* Delete any options that were saved corresponding to an item.
230		*
231		* @param string $filePath
232		*/
233		protected function forgetTrackerOptions($filePath)
234		{
235		unset($this->trackedItemsOptions[$filePath]);
236		}
237
238		///
239		// Handling of trackable items
240		///
241
242		/**
243		* Parse the specified folder for items to track.
244		*
245		* @param string $path
246		* @param array $options Special options that will be passed to the static::parseTrackableItem() implementation
247		* @param array $includes
248		* @param array $excludes
249		*/
250	41	protected function scanTrackableItems($path, array $options = array(), array $includes = array(), array $excludes = array())
251		{
252	41	$this->folderDefinitions[] = $this->fs->getRelativePath($path);
253
254	41	$excludes = empty($excludes) ? self::$documentIgnoreList : $excludes;
		0 ignored issues – show Coding Style introduced 2017-04-27 17:59 UTC by Report Bug Copy Issue Report Consider using a different name than the parameter `$excludes`. This often makes code more readable. Loading history...
255
256	41	$fileExplorerFlags = array_key_exists('fileExplorer', $options) ? $options['fileExplorer'] : null;
257	41	$this->fileExplorer = FileExplorer::create($path, $excludes, $includes, $fileExplorerFlags);
258	41	$fileExplorer = $this->fileExplorer->getExplorer();
259
260	41	foreach ($fileExplorer as $file)
261		{
262	41	$this->handleTrackableItem($file, $options);
263		}
264	41	}
265
266		/**
267		* Handle a specific file type, parse it into the appropriate object type, and add it to the tracker.
268		*
269		* This function should make use of the appropriate functions:
270		*
271		* - TrackingManager::addObjectToTracker()
272		* - TrackingManager::addFileToTracker()
273		* - TrackingManager::saveTrackerOptions()
274		*
275		* @param SplFileInfo $filePath
276		* @param mixed $options
277		*
278		* @return mixed\|null
279		*/
280		abstract protected function handleTrackableItem($filePath, array $options = array());
281
282		///
283		// Utility functions
284		///
285
286		/**
287		* Return an array of JailedDocuments created from the tracked items
288		*
289		* @param array $elements
290		*
291		* @return JailedDocument[]\|JailedDocument[][]
292		*/
293	21	protected static function getJailedTrackedItems(array &$elements)
294		{
295	21	$jailItems = array();
296
297		/**
298		* @var string $key
299		* @var TwigDocument $item
300		*/
301	21	foreach ($elements as &$item)
302		{
303	21	if (!Service::getParameter(BuildableCommand::USE_DRAFTS) && $item->isDraft()) { continue; }
304
305	21	if (empty($item->getNamespace()))
306		{
307	1	$jailItems[$item->getObjectName()] = $item->createJail();
308		}
309		else
310		{
311	21	$jailItems[$item->getNamespace()][$item->getObjectName()] = $item->createJail();
312		}
313		}
314
315	21	return $jailItems;
316		}
317		}
318

stakx-io / stakx

Push — master ( 89bfcf...4ab803 )

TrackingManager::refreshItem() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like