Completed
Push — master ( 103aa8...d82bf3 )
by Nicolas
16:05
created

ModuleGenerator::getAuthorNameReplacement()   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 49
    public function __construct(
73
        $name,
74
        Repository $module = null,
75
        Config $config = null,
76
        Filesystem $filesystem = null,
77
        Console $console = null
78
    ) {
79 49
        $this->name = $name;
80 49
        $this->config = $config;
81 49
        $this->filesystem = $filesystem;
82 49
        $this->console = $console;
83 49
        $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 49
    }
85
86
    /**
87
     * Set plain flag.
88
     *
89
     * @param bool $plain
90
     *
91
     * @return $this
92
     */
93 49
    public function setPlain($plain)
94
    {
95 49
        $this->plain = $plain;
96
97 49
        return $this;
98
    }
99
100
    /**
101
     * Get the name of module will created. By default in studly case.
102
     *
103
     * @return string
104
     */
105 49
    public function getName()
106
    {
107 49
        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 49
    public function setConfig($config)
128
    {
129 49
        $this->config = $config;
130
131 49
        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 49
    public function setFilesystem($filesystem)
152
    {
153 49
        $this->filesystem = $filesystem;
154
155 49
        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 49
    public function setConsole($console)
176
    {
177 49
        $this->console = $console;
178
179 49
        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 49
    public function setModule($module)
200
    {
201 49
        $this->module = $module;
202
203 49
        return $this;
204
    }
205
206
    /**
207
     * Get the list of folders will created.
208
     *
209
     * @return array
210
     */
211 49
    public function getFolders()
212
    {
213 49
        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 46
    public function getFiles()
222
    {
223 46
        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 49
    public function setForce($force)
234
    {
235 49
        $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 49
        return $this;
238
    }
239
240
    /**
241
     * Generate the module.
242
     */
243 49
    public function generate()
244
    {
245 49
        $name = $this->getName();
246
247 49
        if ($this->module->has($name)) {
248 2
            if ($this->force) {
249 1
                $this->module->delete($name);
250
            } else {
251 1
                $this->console->error("Module [{$name}] already exist!");
252
253 1
                return;
254
            }
255
        }
256
257 49
        $this->generateFolders();
258
259 49
        $this->generateModuleJsonFile();
260
261 49
        if ($this->plain !== true) {
262 46
            $this->generateFiles();
263 46
            $this->generateResources();
264
        }
265
266 49
        if ($this->plain === true) {
267 3
            $this->cleanModuleJsonFile();
268
        }
269
270 49
        $this->console->info("Module [{$name}] created successfully.");
271 49
    }
272
273
    /**
274
     * Generate the folders.
275
     */
276 49
    public function generateFolders()
277
    {
278 49
        foreach ($this->getFolders() as $folder) {
279 49
            $path = $this->module->getModulePath($this->getName()) . '/' . $folder;
280
281 49
            $this->filesystem->makeDirectory($path, 0755, true);
282
283 49
            $this->generateGitKeep($path);
284
        }
285 49
    }
286
287
    /**
288
     * Generate git keep to the specified path.
289
     *
290
     * @param string $path
291
     */
292 49
    public function generateGitKeep($path)
293
    {
294 49
        $this->filesystem->put($path . '/.gitkeep', '');
295 49
    }
296
297
    /**
298
     * Generate the files.
299
     */
300 46
    public function generateFiles()
301
    {
302 46
        foreach ($this->getFiles() as $stub => $file) {
303 46
            $path = $this->module->getModulePath($this->getName()) . $file;
304
305 46 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 46
                $this->filesystem->makeDirectory($dir, 0775, true);
307
            }
308
309 46
            $this->filesystem->put($path, $this->getStubContents($stub));
310
311 46
            $this->console->info("Created : {$path}");
312
        }
313 46
    }
314
315
    /**
316
     * Generate some resources.
317
     */
318 46
    public function generateResources()
319
    {
320 46
        $this->console->call('module:make-seed', [
321 46
            'name' => $this->getName(),
322 46
            'module' => $this->getName(),
323
            '--master' => true,
324
        ]);
325
326 46
        $this->console->call('module:make-provider', [
327 46
            'name' => $this->getName() . 'ServiceProvider',
328 46
            'module' => $this->getName(),
329
            '--master' => true,
330
        ]);
331
332 46
        $this->console->call('module:make-controller', [
333 46
            'controller' => $this->getName() . 'Controller',
334 46
            'module' => $this->getName(),
335
        ]);
336 46
    }
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 49
    protected function getStubContents($stub)
346
    {
347 49
        return (new Stub(
348 49
            '/' . $stub . '.stub',
349 49
            $this->getReplacement($stub))
350 49
        )->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 49
    protected function getReplacement($stub)
369
    {
370 49
        $replacements = $this->module->config('stubs.replacements');
371
372 49
        if (!isset($replacements[$stub])) {
373
            return [];
374
        }
375
376 49
        $keys = $replacements[$stub];
377
378 49
        $replaces = [];
379
380 49
        foreach ($keys as $key) {
381 49
            if (method_exists($this, $method = 'get' . ucfirst(studly_case(strtolower($key))) . 'Replacement')) {
382 49
                $replaces[$key] = call_user_func([$this, $method]);
383
            } else {
384 49
                $replaces[$key] = null;
385
            }
386
        }
387
388 49
        return $replaces;
389
    }
390
391
    /**
392
     * Generate the module.json file
393
     */
394 49
    private function generateModuleJsonFile()
395
    {
396 49
        $path = $this->module->getModulePath($this->getName()) . 'module.json';
397
398 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...
399
            $this->filesystem->makeDirectory($dir, 0775, true);
400
        }
401
402 49
        $this->filesystem->put($path, $this->getStubContents('json'));
403
404 49
        $this->console->info("Created : {$path}");
405 49
    }
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 3
    private function cleanModuleJsonFile()
412
    {
413 3
        $path = $this->module->getModulePath($this->getName()) . 'module.json';
414
415 3
        $content = $this->filesystem->get($path);
416 3
        $namespace = $this->getModuleNamespaceReplacement();
417 3
        $studlyName = $this->getStudlyNameReplacement();
418
419 3
        $provider = '"' . $namespace . '\\\\' . $studlyName . '\\\\Providers\\\\' . $studlyName . 'ServiceProvider"';
420
421 3
        $content = str_replace($provider, '', $content);
422
423 3
        $this->filesystem->put($path, $content);
424 3
    }
425
426
    /**
427
     * Get the module name in lower case.
428
     *
429
     * @return string
430
     */
431 49
    protected function getLowerNameReplacement()
432
    {
433 49
        return strtolower($this->getName());
434
    }
435
436
    /**
437
     * Get the module name in studly case.
438
     *
439
     * @return string
440
     */
441 49
    protected function getStudlyNameReplacement()
442
    {
443 49
        return $this->getName();
444
    }
445
446
    /**
447
     * Get replacement for $VENDOR$.
448
     *
449
     * @return string
450
     */
451 46
    protected function getVendorReplacement()
452
    {
453 46
        return $this->module->config('composer.vendor');
454
    }
455
456
    /**
457
     * Get replacement for $MODULE_NAMESPACE$.
458
     *
459
     * @return string
460
     */
461 49
    protected function getModuleNamespaceReplacement()
462
    {
463 49
        return str_replace('\\', '\\\\', $this->module->config('namespace'));
464
    }
465
466
    /**
467
     * Get replacement for $AUTHOR_NAME$.
468
     *
469
     * @return string
470
     */
471 46
    protected function getAuthorNameReplacement()
472
    {
473 46
        return $this->module->config('composer.author.name');
474
    }
475
476
    /**
477
     * Get replacement for $AUTHOR_EMAIL$.
478
     *
479
     * @return string
480
     */
481 46
    protected function getAuthorEmailReplacement()
482
    {
483 46
        return $this->module->config('composer.author.email');
484
    }
485
}
486