Module::boot() - Code Metrics - Inspection of "Feature/reduce injection" - nWidart/laravel-modules - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Pull Request — master (#781)

by Nicolas

created 2019-06-20 15:46 UTC

Module::boot() A

↳ Parent: Module

Complexity

Conditions	3
Paths	4

Size

Total Lines

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	3
CRAP Score	3.1406

Importance

Changes

Metric	Value
cc	3
nc	4
nop	0
dl	0
loc	12
ccs	3
cts	4
cp	0.75
crap	3.1406
rs	9.8666
c	0
b	0
f	0

<?php

namespace Nwidart\Modules;

use Illuminate\Cache\CacheManager;
use Illuminate\Container\Container;
use Illuminate\Filesystem\Filesystem;
use Illuminate\Support\Arr;
use Illuminate\Support\Str;
use Illuminate\Support\Traits\Macroable;
use Illuminate\Translation\Translator;

abstract class Module
{
    use Macroable;

    /**
     * The laravel|lumen application instance.
     *
     * @var \Illuminate\Contracts\Foundation\Application|\Laravel\Lumen\Application
     */
    protected $app;

    /**
     * The module name.
     *
     * @var
     */
    protected $name;

    /**
     * The module path.
     *
     * @var string
     */
    protected $path;

    /**
     * @var array of cached Json objects, keyed by filename
     */
    protected $moduleJson = [];
    /**
     * @var CacheManager
     */
    private $cache;
    /**
     * @var Filesystem
     */
    private $files;
    /**
     * @var Translator
     */
    private $translator;

    /**
     * The constructor.
     * @param Container $app
     * @param $name
     * @param $path
     */
    public function __construct(Container $app, string $name, $path)
    {
        $this->name = $name;
        $this->path = $path;
        $this->cache = $app['cache'];
        $this->files = $app['files'];
        $this->translator = $app['translator'];
        $this->app = $app;

    }

    /**
     * Get name.
     *
     * @return string
     */
    public function getName()
    {
        return $this->name;
    }

    /**
     * Get name in lower case.
     *
     * @return string
     */
    public function getLowerName()
    {
        return strtolower($this->name);
    }

    /**
     * Get name in studly case.
     *
     * @return string
     */
    public function getStudlyName()
    {
        return Str::studly($this->name);
    }

    /**
     * Get name in snake case.
     *
     * @return string
     */
    public function getSnakeName()
    {
        return Str::snake($this->name);
    }

    /**
     * Get description.
     *
     * @return string
     */
    public function getDescription()
    {
        return $this->get('description');
    }

    /**
     * Get alias.
     *
     * @return string
     */
    public function getAlias()
    {
        return $this->get('alias');
    }

    /**
     * Get priority.
     *
     * @return string
     */
    public function getPriority()
    {
        return $this->get('priority');
    }

    /**
     * Get module requirements.
     *
     * @return array
     */
    public function getRequires()
    {
        return $this->get('requires');
    }

    /**
     * Get path.
     *
     * @return string
     */
    public function getPath()
    {
        return $this->path;
    }

    /**
     * Set path.
     *
     * @param string $path
     *
     * @return $this
     */
    public function setPath($path)
    {
        $this->path = $path;

        return $this;
    }

    /**
     * Bootstrap the application events.
     */
    public function boot()
    {
        if (config('modules.register.translations', true) === true) {
            $this->registerTranslation();
        }

        if ($this->isLoadFilesOnBoot()) {
            $this->registerFiles();
        }

        $this->fireEvent('boot');
    }

    /**
     * Register module's translation.
     *
     * @return void
     */
    protected function registerTranslation()
    {
        $lowerName = $this->getLowerName();

        $langPath = $this->getPath() . '/Resources/lang';

        if (is_dir($langPath)) {
            $this->loadTranslationsFrom($langPath, $lowerName);
        }
    }

    /**
     * Get json contents from the cache, setting as needed.
     *
     * @param string $file
     *
     * @return Json
     */
    public function json($file = null) : Json
    {
        if ($file === null) {
            $file = 'module.json';
        }

        return Arr::get($this->moduleJson, $file, function () use ($file) {
            return $this->moduleJson[$file] = new Json($this->getPath() . '/' . $file, $this->files);
        });
    }

    /**
     * Get a specific data from json file by given the key.
     *
     * @param string $key
     * @param null $default
     *
     * @return mixed
     */
    public function get(string $key, $default = null)
    {
        return $this->json()->get($key, $default);
    }

    /**
     * Get a specific data from composer.json file by given the key.
     *
     * @param $key
     * @param null $default
     *
     * @return mixed
     */
    public function getComposerAttr($key, $default = null)
    {
        return $this->json('composer.json')->get($key, $default);
    }

    /**
     * Register the module.
     */
    public function register()
    {
        $this->registerAliases();

        $this->registerProviders();

        if ($this->isLoadFilesOnBoot() === false) {
            $this->registerFiles();
        }

        $this->fireEvent('register');
    }

    /**
     * Register the module event.
     *
     * @param string $event
     */
    protected function fireEvent($event)
    {
        $this->app['events']->dispatch(sprintf('modules.%s.' . $event, $this->getLowerName()), [$this]);
    }
    /**
     * Register the aliases from this module.
     */
    abstract public function registerAliases();

    /**
     * Register the service providers from this module.
     */
    abstract public function registerProviders();

    /**
     * Get the path to the cached *_module.php file.
     *
     * @return string
     */
    abstract public function getCachedServicesPath();

    /**
     * Register the files from this module.
     */
    protected function registerFiles()
    {
        foreach ($this->get('files', []) as $file) {
            include $this->path . '/' . $file;
        }
    }

    /**
     * Handle call __toString.
     *
     * @return string
     */
    public function __toString()
    {
        return $this->getStudlyName();
    }

    /**
     * Determine whether the given status same with the current module status.
     *
     * @param $status
     *
     * @return bool
     */
    public function isStatus($status) : bool
    {
        return $this->get('active', 0) === $status;
    }

    /**
     * Determine whether the current module activated.
     *
     * @return bool
     */
    public function enabled() : bool
    {
        return $this->isStatus(1);
    }

    /**
     *  Determine whether the current module not disabled.
     *
     * @return bool
     */
    public function disabled() : bool
    {
        return !$this->enabled();
    }

    /**
     * Set active state for current module.
     *
     * @param $active
     *
     * @return bool
     */
    public function setActive($active)
    {
        return $this->json()->set('active', $active)->save();
    }

    /**
     * Disable the current module.
     */
    public function disable()
    {
        $this->fireEvent('disabling');

        $this->setActive(0);
        $this->flushCache();

        $this->fireEvent('disabled');
    }

    /**
     * Enable the current module.
     */
    public function enable()
    {
        $this->fireEvent('enabling');

        $this->setActive(1);
        $this->flushCache();

        $this->fireEvent('enabled');
    }

    /**
     * Delete the current module.
     *
     * @return bool
     */
    public function delete()
    {
        return $this->json()->getFilesystem()->deleteDirectory($this->getPath());
    }

    /**
     * Get extra path.
     *
     * @param string $path
     *
     * @return string
     */
    public function getExtraPath(string $path) : string
    {
        return $this->getPath() . '/' . $path;
    }

    /**
     * Handle call to __get method.
     *
     * @param $key
     *
     * @return mixed
     */
    public function __get($key)
    {
        return $this->get($key);
    }

    /**
     * Check if can load files of module on boot method.
     *
     * @return bool
     */
    protected function isLoadFilesOnBoot()
    {
        return config('modules.register.files', 'register') === 'boot' &&
            // force register method if option == boot && app is AsgardCms
            !class_exists('\Modules\Core\Foundation\AsgardCms');
    }

    private function flushCache(): void
    {
        if (config('modules.cache.enabled')) {
            $this->cache->store()->flush();
        }
    }

    /**
     * Register a translation file namespace.
     *
     * @param  string  $path
     * @param  string  $namespace
     * @return void
     */
    private function loadTranslationsFrom(string $path, string $namespace): void
    {
        $this->translator->addNamespace($namespace, $path);
    }
}


1			<?php
2
3			namespace Nwidart\Modules;
4
5			use Illuminate\Cache\CacheManager;
6			use Illuminate\Container\Container;
7			use Illuminate\Filesystem\Filesystem;
8			use Illuminate\Support\Arr;
9			use Illuminate\Support\Str;
10			use Illuminate\Support\Traits\Macroable;
11			use Illuminate\Translation\Translator;
12
13			abstract class Module
14			{
15			use Macroable;
16
17			/**
18			* The laravel\|lumen application instance.
19			*
20			* @var \Illuminate\Contracts\Foundation\Application\|\Laravel\Lumen\Application
21			*/
22			protected $app;
23
24			/**
25			* The module name.
26			*
27			* @var
28			*/
29			protected $name;
30
31			/**
32			* The module path.
33			*
34			* @var string
35			*/
36			protected $path;
37
38			/**
39			* @var array of cached Json objects, keyed by filename
40			*/
41			protected $moduleJson = [];
42			/**
43			* @var CacheManager
44			*/
45			private $cache;
46			/**
47			* @var Filesystem
48	153		*/
49			private $files;
50	153		/**
51	153		* @var Translator
52	153		*/
53	153		private $translator;
54
55			/**
56			* The constructor.
57			* @param Container $app
58			* @param $name
59			* @param $path
60	1		*/
61		View Code Duplication	public function __construct(Container $app, string $name, $path)
62	1		{
63			$this->name = $name;
64			$this->path = $path;
65			$this->cache = $app['cache'];
66			$this->files = $app['files'];
67			$this->translator = $app['translator'];
68			$this->app = $app;
			0 ignored issues – show Documentation Bug introduced 2019-06-20 15:46 UTC by Report Bug Copy Issue Report It seems like `$app` of type `object<Illuminate\Container\Container>` is incompatible with the declared type `object<Illuminate\Contra...avel\Lumen\Application>` of property `$app`. Our type inference engine has found an assignment to a property that is incompatible with the declared type of that property. Either this assignment is in error or the assigned type should be added to the documentation/type hint for that property.. Loading history...
69			}
70	2
71			/**
72	2		* Get name.
73			*
74			* @return string
75			*/
76			public function getName()
77			{
78			return $this->name;
79			}
80	115
81			/**
82	115		* Get name in lower case.
83			*
84			* @return string
85			*/
86			public function getLowerName()
87			{
88			return strtolower($this->name);
89			}
90	101
91			/**
92	101		* Get name in studly case.
93			*
94			* @return string
95			*/
96			public function getStudlyName()
97			{
98			return Str::studly($this->name);
99			}
100	6
101			/**
102	6		* Get name in snake case.
103			*
104			* @return string
105			*/
106			public function getSnakeName()
107			{
108			return Str::snake($this->name);
109			}
110	2
111			/**
112	2		* Get description.
113			*
114			* @return string
115			*/
116			public function getDescription()
117			{
118			return $this->get('description');
119			}
120	4
121			/**
122	4		* Get alias.
123			*
124			* @return string
125			*/
126			public function getAlias()
127			{
128			return $this->get('alias');
129			}
130
131			/**
132			* Get priority.
133			*
134			* @return string
135			*/
136			public function getPriority()
137			{
138			return $this->get('priority');
139			}
140	3
141			/**
142	3		* Get module requirements.
143			*
144			* @return array
145			*/
146			public function getRequires()
147			{
148			return $this->get('requires');
149			}
150	136
151			/**
152	136		* Get path.
153			*
154			* @return string
155			*/
156			public function getPath()
157			{
158			return $this->path;
159			}
160
161			/**
162			* Set path.
163			*
164			* @param string $path
165			*
166			* @return $this
167			*/
168			public function setPath($path)
169			{
170			$this->path = $path;
171
172	2		return $this;
173			}
174	2
175	2		/**
176			* Bootstrap the application events.
177			*/
178	2		public function boot()
179			{
180			if (config('modules.register.translations', true) === true) {
181			$this->registerTranslation();
182	2		}
183	2
184			if ($this->isLoadFilesOnBoot()) {
185			$this->registerFiles();
186			}
187
188			$this->fireEvent('boot');
189			}
190	2
191			/**
192	2		* Register module's translation.
193			*
194	2		* @return void
195			*/
196	2		protected function registerTranslation()
197	2		{
198			$lowerName = $this->getLowerName();
199	2
200			$langPath = $this->getPath() . '/Resources/lang';
201
202			if (is_dir($langPath)) {
203			$this->loadTranslationsFrom($langPath, $lowerName);
204			}
205			}
206
207			/**
208	35		* Get json contents from the cache, setting as needed.
209			*
210	35		* @param string $file
211	33		*
212			* @return Json
213			*/
214			public function json($file = null) : Json
215	35		{
216	35		if ($file === null) {
217			$file = 'module.json';
218			}
219
220			return Arr::get($this->moduleJson, $file, function () use ($file) {
221			return $this->moduleJson[$file] = new Json($this->getPath() . '/' . $file, $this->files);
222			});
223			}
224
225			/**
226			* Get a specific data from json file by given the key.
227	24		*
228			* @param string $key
229	24		* @param null $default
230			*
231			* @return mixed
232			*/
233			public function get(string $key, $default = null)
234			{
235			return $this->json()->get($key, $default);
236			}
237
238			/**
239			* Get a specific data from composer.json file by given the key.
240	2		*
241			* @param $key
242	2		* @param null $default
243			*
244			* @return mixed
245			*/
246			public function getComposerAttr($key, $default = null)
247			{
248			return $this->json('composer.json')->get($key, $default);
249			}
250
251			/**
252			* Register the module.
253			*/
254			public function register()
255			{
256			$this->registerAliases();
257
258			$this->registerProviders();
259
260			if ($this->isLoadFilesOnBoot() === false) {
261			$this->registerFiles();
262			}
263
264			$this->fireEvent('register');
265			}
266	8
267			/**
268	8		* Register the module event.
269	8		*
270			* @param string $event
271			*/
272			protected function fireEvent($event)
273			{
274			$this->app['events']->dispatch(sprintf('modules.%s.' . $event, $this->getLowerName()), [$this]);
275			}
276			/**
277			* Register the aliases from this module.
278			*/
279			abstract public function registerAliases();
280
281			/**
282			* Register the service providers from this module.
283			*/
284			abstract public function registerProviders();
285
286			/**
287			* Get the path to the cached *_module.php file.
288			*
289			* @return string
290			*/
291			abstract public function getCachedServicesPath();
292
293			/**
294			* Register the files from this module.
295			*/
296			protected function registerFiles()
297			{
298			foreach ($this->get('files', []) as $file) {
299			include $this->path . '/' . $file;
300			}
301			}
302	3
303			/**
304	3		* Handle call __toString.
305			*
306			* @return string
307			*/
308			public function __toString()
309			{
310			return $this->getStudlyName();
311			}
312
313			/**
314	11		* Determine whether the given status same with the current module status.
315			*
316	11		* @param $status
317			*
318			* @return bool
319			*/
320			public function isStatus($status) : bool
321			{
322			return $this->get('active', 0) === $status;
323			}
324	6
325			/**
326	6		* Determine whether the current module activated.
327			*
328			* @return bool
329			*/
330			public function enabled() : bool
331			{
332			return $this->isStatus(1);
333			}
334	2
335			/**
336	2		* Determine whether the current module not disabled.
337			*
338			* @return bool
339			*/
340			public function disabled() : bool
341			{
342			return !$this->enabled();
343			}
344
345			/**
346	6		* Set active state for current module.
347			*
348	6		* @param $active
349			*
350			* @return bool
351			*/
352			public function setActive($active)
353			{
354	3		return $this->json()->set('active', $active)->save();
355			}
356	3
357			/**
358	3		* Disable the current module.
359	3		*/
360			public function disable()
361	3		{
362	3		$this->fireEvent('disabling');
363
364			$this->setActive(0);
365			$this->flushCache();
366
367	3		$this->fireEvent('disabled');
368			}
369	3
370			/**
371	3		* Enable the current module.
372	3		*/
373			public function enable()
374	3		{
375	3		$this->fireEvent('enabling');
376
377			$this->setActive(1);
378			$this->flushCache();
379
380			$this->fireEvent('enabled');
381			}
382	2
383			/**
384	2		* Delete the current module.
385			*
386			* @return bool
387			*/
388			public function delete()
389			{
390			return $this->json()->getFilesystem()->deleteDirectory($this->getPath());
391			}
392
393			/**
394	3		* Get extra path.
395			*
396	3		* @param string $path
397			*
398			* @return string
399			*/
400			public function getExtraPath(string $path) : string
401			{
402			return $this->getPath() . '/' . $path;
403			}
404
405			/**
406			* Handle call to __get method.
407			*
408			* @param $key
409			*
410			* @return mixed
411			*/
412			public function __get($key)
413			{
414			return $this->get($key);
415			}
416	2
417			/**
418	2		* Check if can load files of module on boot method.
419			*
420	2		* @return bool
421			*/
422			protected function isLoadFilesOnBoot()
423	6		{
424			return config('modules.register.files', 'register') === 'boot' &&
425	6		// force register method if option == boot && app is AsgardCms
426			!class_exists('\Modules\Core\Foundation\AsgardCms');
427			}
428	6
429			private function flushCache(): void
430			{
431			if (config('modules.cache.enabled')) {
432			$this->cache->store()->flush();
433			}
434			}
435
436			/**
437			* Register a translation file namespace.
438			*
439			* @param string $path
440			* @param string $namespace
441			* @return void
442			*/
443			private function loadTranslationsFrom(string $path, string $namespace): void
444			{
445			$this->translator->addNamespace($namespace, $path);
446			}
447			}
448

nWidart / laravel-modules

Pull Request — master (#781)

Module::boot() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like