Completed
Push — master ( 247ae6...f93a8c )
by Nicolas
03:59
created

ModuleGenerator::getLowerNameReplacement()   A

Complexity

Conditions 1
Paths 1

Size

Total Lines 4
Code Lines 2

Duplication

Lines 0
Ratio 0 %

Code Coverage

Tests 2
CRAP Score 1

Importance

Changes 0
Metric Value
dl 0
loc 4
rs 10
c 0
b 0
f 0
ccs 2
cts 2
cp 1
cc 1
eloc 2
nc 1
nop 0
crap 1
1
<?php
2
3
namespace Nwidart\Modules\Generators;
4
5
use Illuminate\Config\Repository as Config;
6
use Illuminate\Console\Command as Console;
7
use Illuminate\Filesystem\Filesystem;
8
use Illuminate\Support\Str;
9
use Nwidart\Modules\Repository;
10
use Nwidart\Modules\Support\Stub;
11
12
class ModuleGenerator extends Generator
13
{
14
    /**
15
     * The module name will created.
16
     *
17
     * @var string
18
     */
19
    protected $name;
20
21
    /**
22
     * The laravel config instance.
23
     *
24
     * @var Config
25
     */
26
    protected $config;
27
28
    /**
29
     * The laravel filesystem instance.
30
     *
31
     * @var Filesystem
32
     */
33
    protected $filesystem;
34
35
    /**
36
     * The laravel console instance.
37
     *
38
     * @var Console
39
     */
40
    protected $console;
41
42
    /**
43
     * The pingpong module instance.
44
     *
45
     * @var Module
46
     */
47
    protected $module;
48
49
    /**
50
     * Force status.
51
     *
52
     * @var bool
53
     */
54
    protected $force = false;
55
56
    /**
57
     * Generate a plain module.
58
     *
59
     * @var bool
60
     */
61
    protected $plain = false;
62
63
    /**
64
     * The constructor.
65
     *
66
     * @param $name
67
     * @param Repository $module
68
     * @param Config     $config
69
     * @param Filesystem $filesystem
70
     * @param Console    $console
71
     */
72 55
    public function __construct(
73
        $name,
74
        Repository $module = null,
75
        Config $config = null,
76
        Filesystem $filesystem = null,
77
        Console $console = null
78
    ) {
79 55
        $this->name = $name;
80 55
        $this->config = $config;
81 55
        $this->filesystem = $filesystem;
82 55
        $this->console = $console;
83 55
        $this->module = $module;
0 ignored issues
show
Documentation Bug introduced by
It seems like $module can also be of type object<Nwidart\Modules\Repository>. However, the property $module is declared as type object<Nwidart\Modules\Generators\Module>. Maybe add an additional type check?

Our type inference engine has found a suspicous assignment of a value to a property. This check raises an issue when a value that can be of a mixed type is assigned to a property that is type hinted more strictly.

For example, imagine you have a variable $accountId that can either hold an Id object or false (if there is no account id yet). Your code now assigns that value to the id property of an instance of the Account class. This class holds a proper account, so the id value must no longer be false.

Either this assignment is in error or a type check should be added for that assignment.

class Id
{
    public $id;

    public function __construct($id)
    {
        $this->id = $id;
    }

}

class Account
{
    /** @var  Id $id */
    public $id;
}

$account_id = false;

if (starsAreRight()) {
    $account_id = new Id(42);
}

$account = new Account();
if ($account instanceof Id)
{
    $account->id = $account_id;
}
Loading history...
84 55
    }
85
86
    /**
87
     * Set plain flag.
88
     *
89
     * @param bool $plain
90
     *
91
     * @return $this
92
     */
93 55
    public function setPlain($plain)
94
    {
95 55
        $this->plain = $plain;
96
97 55
        return $this;
98
    }
99
100
    /**
101
     * Get the name of module will created. By default in studly case.
102
     *
103
     * @return string
104
     */
105 55
    public function getName()
106
    {
107 55
        return Str::studly($this->name);
108
    }
109
110
    /**
111
     * Get the laravel config instance.
112
     *
113
     * @return Config
114
     */
115
    public function getConfig()
116
    {
117
        return $this->config;
118
    }
119
120
    /**
121
     * Set the laravel config instance.
122
     *
123
     * @param Config $config
124
     *
125
     * @return $this
126
     */
127 55
    public function setConfig($config)
128
    {
129 55
        $this->config = $config;
130
131 55
        return $this;
132
    }
133
134
    /**
135
     * Get the laravel filesystem instance.
136
     *
137
     * @return Filesystem
138
     */
139
    public function getFilesystem()
140
    {
141
        return $this->filesystem;
142
    }
143
144
    /**
145
     * Set the laravel filesystem instance.
146
     *
147
     * @param Filesystem $filesystem
148
     *
149
     * @return $this
150
     */
151 55
    public function setFilesystem($filesystem)
152
    {
153 55
        $this->filesystem = $filesystem;
154
155 55
        return $this;
156
    }
157
158
    /**
159
     * Get the laravel console instance.
160
     *
161
     * @return Console
162
     */
163
    public function getConsole()
164
    {
165
        return $this->console;
166
    }
167
168
    /**
169
     * Set the laravel console instance.
170
     *
171
     * @param Console $console
172
     *
173
     * @return $this
174
     */
175 55
    public function setConsole($console)
176
    {
177 55
        $this->console = $console;
178
179 55
        return $this;
180
    }
181
182
    /**
183
     * Get the pingpong module instance.
184
     *
185
     * @return Module
186
     */
187
    public function getModule()
188
    {
189
        return $this->module;
190
    }
191
192
    /**
193
     * Set the pingpong module instance.
194
     *
195
     * @param mixed $module
196
     *
197
     * @return $this
198
     */
199 55
    public function setModule($module)
200
    {
201 55
        $this->module = $module;
202
203 55
        return $this;
204
    }
205
206
    /**
207
     * Get the list of folders will created.
208
     *
209
     * @return array
210
     */
211 55
    public function getFolders()
212
    {
213 55
        return array_values($this->module->config('paths.generator'));
214
    }
215
216
    /**
217
     * Get the list of files will created.
218
     *
219
     * @return array
220
     */
221 49
    public function getFiles()
222
    {
223 49
        return $this->module->config('stubs.files');
224
    }
225
226
    /**
227
     * Set force status.
228
     *
229
     * @param bool|int $force
230
     *
231
     * @return $this
232
     */
233 55
    public function setForce($force)
234
    {
235 55
        $this->force = $force;
0 ignored issues
show
Documentation Bug introduced by
It seems like $force can also be of type integer. However, the property $force is declared as type boolean. Maybe add an additional type check?

Our type inference engine has found a suspicous assignment of a value to a property. This check raises an issue when a value that can be of a mixed type is assigned to a property that is type hinted more strictly.

For example, imagine you have a variable $accountId that can either hold an Id object or false (if there is no account id yet). Your code now assigns that value to the id property of an instance of the Account class. This class holds a proper account, so the id value must no longer be false.

Either this assignment is in error or a type check should be added for that assignment.

class Id
{
    public $id;

    public function __construct($id)
    {
        $this->id = $id;
    }

}

class Account
{
    /** @var  Id $id */
    public $id;
}

$account_id = false;

if (starsAreRight()) {
    $account_id = new Id(42);
}

$account = new Account();
if ($account instanceof Id)
{
    $account->id = $account_id;
}
Loading history...
236
237 55
        return $this;
238
    }
239
240
    /**
241
     * Generate the module.
242
     */
243 55
    public function generate()
244
    {
245 55
        $name = $this->getName();
246
247 55
        if ($this->module->has($name)) {
248 2
            if ($this->force) {
249 1
                $this->module->delete($name);
250 1
            } else {
251 1
                $this->console->error("Module [{$name}] already exist!");
252
253 1
                return;
254
            }
255 1
        }
256
257 55
        $this->generateFolders();
258
259 55
        $this->generateModuleJsonFile();
260
261 55
        if ($this->plain !== true) {
262 49
            $this->generateFiles();
263 49
            $this->generateResources();
264 49
        }
265
266 55
        if ($this->plain === true) {
267 6
            $this->cleanModuleJsonFile();
268 6
        }
269
270 55
        $this->console->info("Module [{$name}] created successfully.");
271 55
    }
272
273
    /**
274
     * Generate the folders.
275
     */
276 55
    public function generateFolders()
277
    {
278 55
        foreach ($this->getFolders() as $folder) {
279 55
            $path = $this->module->getModulePath($this->getName()) . '/' . $folder;
280
281 55
            $this->filesystem->makeDirectory($path, 0755, true);
282
283 55
            $this->generateGitKeep($path);
284 55
        }
285 55
    }
286
287
    /**
288
     * Generate git keep to the specified path.
289
     *
290
     * @param string $path
291
     */
292 55
    public function generateGitKeep($path)
293
    {
294 55
        $this->filesystem->put($path . '/.gitkeep', '');
295 55
    }
296
297
    /**
298
     * Generate the files.
299
     */
300 49
    public function generateFiles()
301
    {
302 49
        foreach ($this->getFiles() as $stub => $file) {
303 49
            $path = $this->module->getModulePath($this->getName()) . $file;
304
305 49 View Code Duplication
            if (!$this->filesystem->isDirectory($dir = dirname($path))) {
0 ignored issues
show
Duplication introduced by
This code seems to be duplicated across your project.

Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation.

You can also find more detailed suggestions in the “Code” section of your repository.

Loading history...
306 49
                $this->filesystem->makeDirectory($dir, 0775, true);
307 49
            }
308
309 49
            $this->filesystem->put($path, $this->getStubContents($stub));
310
311 49
            $this->console->info("Created : {$path}");
312 49
        }
313 49
    }
314
315
    /**
316
     * Generate some resources.
317
     */
318 49
    public function generateResources()
319
    {
320 49
        $this->console->call('module:make-seed', [
321 49
            'name' => $this->getName(),
322 49
            'module' => $this->getName(),
323 49
            '--master' => true,
324 49
        ]);
325
326 49
        $this->console->call('module:make-provider', [
327 49
            'name' => $this->getName() . 'ServiceProvider',
328 49
            'module' => $this->getName(),
329 49
            '--master' => true,
330 49
        ]);
331
332 49
        $this->console->call('module:make-controller', [
333 49
            'controller' => $this->getName() . 'Controller',
334 49
            'module' => $this->getName(),
335 49
        ]);
336 49
    }
337
338
    /**
339
     * Get the contents of the specified stub file by given stub name.
340
     *
341
     * @param $stub
342
     *
343
     * @return string
344
     */
345 55
    protected function getStubContents($stub)
346
    {
347 55
        return (new Stub(
348 55
            '/' . $stub . '.stub',
349 55
            $this->getReplacement($stub))
350 55
        )->render();
351
    }
352
353
    /**
354
     * get the list for the replacements.
355
     */
356
    public function getReplacements()
357
    {
358
        return $this->module->config('stubs.replacements');
359
    }
360
361
    /**
362
     * Get array replacement for the specified stub.
363
     *
364
     * @param $stub
365
     *
366
     * @return array
367
     */
368 55
    protected function getReplacement($stub)
369
    {
370 55
        $replacements = $this->module->config('stubs.replacements');
371
372 55
        if (!isset($replacements[$stub])) {
373
            return [];
374
        }
375
376 55
        $keys = $replacements[$stub];
377
378 55
        $replaces = [];
379
380 55
        foreach ($keys as $key) {
381 55
            if (method_exists($this, $method = 'get' . ucfirst(studly_case(strtolower($key))) . 'Replacement')) {
382 55
                $replaces[$key] = call_user_func([$this, $method]);
383 55
            } else {
384
                $replaces[$key] = null;
385
            }
386 55
        }
387
388 55
        return $replaces;
389
    }
390
391
    /**
392
     * Generate the module.json file
393
     */
394 55
    private function generateModuleJsonFile()
395
    {
396 55
        $path = $this->module->getModulePath($this->getName()) . 'module.json';
397
398 55 View Code Duplication
        if (!$this->filesystem->isDirectory($dir = dirname($path))) {
0 ignored issues
show
Duplication introduced by
This code seems to be duplicated across your project.

Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation.

You can also find more detailed suggestions in the “Code” section of your repository.

Loading history...
399
            $this->filesystem->makeDirectory($dir, 0775, true);
400
        }
401
402 55
        $this->filesystem->put($path, $this->getStubContents('json'));
403
404 55
        $this->console->info("Created : {$path}");
405 55
    }
406
407
    /**
408
     * Remove the default service provider that was added in the module.json file
409
     * This is needed when a --plain module was created
410
     */
411 6
    private function cleanModuleJsonFile()
412
    {
413 6
        $path = $this->module->getModulePath($this->getName()) . 'module.json';
414
415 6
        $content = $this->filesystem->get($path);
416 6
        $namespace = $this->getModuleNamespaceReplacement();
417 6
        $studlyName = $this->getStudlyNameReplacement();
418
419 6
        $provider = '"' . $namespace . '\\\\' . $studlyName . '\\\\Providers\\\\' . $studlyName . 'ServiceProvider"';
420
421 6
        $content = str_replace($provider, '', $content);
422
423 6
        $this->filesystem->put($path, $content);
424 6
    }
425
426
    /**
427
     * Get the module name in lower case.
428
     *
429
     * @return string
430
     */
431 55
    protected function getLowerNameReplacement()
432
    {
433 55
        return strtolower($this->getName());
434
    }
435
436
    /**
437
     * Get the module name in studly case.
438
     *
439
     * @return string
440
     */
441 55
    protected function getStudlyNameReplacement()
442
    {
443 55
        return $this->getName();
444
    }
445
446
    /**
447
     * Get replacement for $VENDOR$.
448
     *
449
     * @return string
450
     */
451 49
    protected function getVendorReplacement()
452
    {
453 49
        return $this->module->config('composer.vendor');
454
    }
455
456
    /**
457
     * Get replacement for $MODULE_NAMESPACE$.
458
     *
459
     * @return string
460
     */
461 55
    protected function getModuleNamespaceReplacement()
462
    {
463 55
        return str_replace('\\', '\\\\', $this->module->config('namespace'));
464
    }
465
466
    /**
467
     * Get replacement for $AUTHOR_NAME$.
468
     *
469
     * @return string
470
     */
471 49
    protected function getAuthorNameReplacement()
472
    {
473 49
        return $this->module->config('composer.author.name');
474
    }
475
476
    /**
477
     * Get replacement for $AUTHOR_EMAIL$.
478
     *
479
     * @return string
480
     */
481 49
    protected function getAuthorEmailReplacement()
482
    {
483 49
        return $this->module->config('composer.author.email');
484
    }
485
}
486