├── .editorconfig
├── .gitattributes
├── .gitignore
├── README.md
├── app
    ├── Application
    │   ├── Analyze
    │   │   ├── AnalyzeAction.php
    │   │   ├── AnalyzeMetric.php
    │   │   ├── AnalyzePresenter.php
    │   │   ├── AnalyzeRequest.php
    │   │   ├── AnalyzeResponse.php
    │   │   └── AnalyzeResponseMapper.php
    │   ├── Cyclic
    │   │   ├── CyclicAction.php
    │   │   ├── CyclicPresenter.php
    │   │   ├── CyclicRequest.php
    │   │   ├── CyclicResponse.php
    │   │   └── CyclicResponseMapper.php
    │   └── Weakness
    │   │   ├── WeaknessAction.php
    │   │   ├── WeaknessPresenter.php
    │   │   ├── WeaknessRequest.php
    │   │   ├── WeaknessResponse.php
    │   │   └── WeaknessResponseMapper.php
    ├── Commands
    │   ├── AbstractCommand.php
    │   ├── Analyze
    │   │   ├── Class
    │   │   │   ├── AnalyzeCommand.php
    │   │   │   ├── Graph
    │   │   │   │   ├── GraphPresenterFactory.php
    │   │   │   │   └── GraphSettingsFactory.php
    │   │   │   ├── PresenterFactory.php
    │   │   │   ├── Summary
    │   │   │   │   ├── SummaryPresenterFactory.php
    │   │   │   │   └── SummarySettingsFactory.php
    │   │   │   └── TransformerFactory.php
    │   │   └── Component
    │   │   │   ├── ComponentCommand.php
    │   │   │   ├── Factories
    │   │   │       ├── PresenterFactory.php
    │   │   │       └── TransformerFactory.php
    │   │   │   ├── Graph
    │   │   │       ├── GraphPresenterFactory.php
    │   │   │       └── GraphSettingsFactory.php
    │   │   │   └── Summary
    │   │   │       ├── SummaryPresenterFactory.php
    │   │   │       └── SummarySettingsFactory.php
    │   ├── Cyclic
    │   │   ├── CyclicCommand.php
    │   │   ├── SummaryPresenterFactory.php
    │   │   └── SummarySettingsFactory.php
    │   └── Weakness
    │   │   ├── SummaryPresenterFactory.php
    │   │   ├── SummarySettingsFactory.php
    │   │   └── WeaknessCommand.php
    ├── Domain
    │   ├── Aggregators
    │   │   └── DependencyAggregator.php
    │   ├── Entities
    │   │   └── ClassDependencies.php
    │   ├── Ports
    │   │   ├── Aggregators
    │   │   │   └── FileAggregator.php
    │   │   └── Repositories
    │   │   │   └── FileRepository.php
    │   ├── Services
    │   │   ├── Cycle.php
    │   │   ├── CyclicDependency.php
    │   │   ├── Stack.php
    │   │   └── Visited.php
    │   └── ValueObjects
    │   │   ├── Abstractness.php
    │   │   ├── Coupling.php
    │   │   ├── Dependencies.php
    │   │   ├── Fqcn.php
    │   │   ├── IsAbstract.php
    │   │   ├── IsInterface.php
    │   │   └── SimpleBoolean.php
    ├── Infrastructure
    │   ├── Analyze
    │   │   ├── Adapters
    │   │   │   ├── Jerowork
    │   │   │   │   ├── ClassDependenciesParserAdapter.php
    │   │   │   │   ├── Collectors
    │   │   │   │   │   └── ClassTypeCollector.php
    │   │   │   │   ├── DataTransferObjects
    │   │   │   │   │   └── ClassAnalysisAdapter.php
    │   │   │   │   ├── NativeDecliner.php
    │   │   │   │   ├── NodeTraverserFactory.php
    │   │   │   │   └── Visitors
    │   │   │   │   │   └── DetectClassTypeVisitor.php
    │   │   │   └── Services
    │   │   │   │   └── AnalyzerServiceAdapter.php
    │   │   └── Ports
    │   │   │   ├── AnalyzerService.php
    │   │   │   ├── ClassAnalysis.php
    │   │   │   └── ClassDependenciesParser.php
    │   ├── File
    │   │   ├── Adapters
    │   │   │   ├── Aggregators
    │   │   │   │   └── FileAggregatorAdapter.php
    │   │   │   ├── DataTransferObjects
    │   │   │   │   └── FileAdapter.php
    │   │   │   └── Repositories
    │   │   │   │   └── FileRepositoryAdapter.php
    │   │   └── Ports
    │   │   │   └── File.php
    │   ├── Graph
    │   │   └── Adapters
    │   │   │   └── Cytoscape
    │   │   │       ├── CytoscapeNetwork.php
    │   │   │       ├── CytoscapeNetworkBuilder.php
    │   │   │       ├── Edges.php
    │   │   │       └── Nodes.php
    │   └── Views
    │   │   └── Adapters
    │   │       └── SystemFileLauncherAdapter.php
    ├── Presenter
    │   ├── Analyze
    │   │   ├── Class
    │   │   │   ├── Graph
    │   │   │   │   ├── GraphEnums.php
    │   │   │   │   ├── GraphMapper.php
    │   │   │   │   ├── GraphPresenter.php
    │   │   │   │   ├── GraphSettings.php
    │   │   │   │   ├── GraphView.php
    │   │   │   │   └── GraphViewModel.php
    │   │   │   ├── Shared
    │   │   │   │   ├── Metric.php
    │   │   │   │   └── MetricMapper.php
    │   │   │   └── Summary
    │   │   │   │   ├── SummaryMapper.php
    │   │   │   │   ├── SummaryPresenter.php
    │   │   │   │   ├── SummarySettings.php
    │   │   │   │   ├── SummaryView.php
    │   │   │   │   └── SummaryViewModel.php
    │   │   ├── Component
    │   │   │   ├── Graph
    │   │   │   │   ├── GraphMapper.php
    │   │   │   │   ├── GraphPresenter.php
    │   │   │   │   ├── GraphSettings.php
    │   │   │   │   ├── GraphView.php
    │   │   │   │   └── GraphViewModel.php
    │   │   │   ├── Shared
    │   │   │   │   ├── Collector.php
    │   │   │   │   ├── Component.php
    │   │   │   │   ├── ComponentFactory.php
    │   │   │   │   └── ComponentMapper.php
    │   │   │   └── Summary
    │   │   │   │   ├── SummaryMapper.php
    │   │   │   │   ├── SummaryPresenter.php
    │   │   │   │   ├── SummarySettings.php
    │   │   │   │   ├── SummaryView.php
    │   │   │   │   └── SummaryViewModel.php
    │   │   └── Shared
    │   │   │   ├── Calculators
    │   │   │       ├── AbstractnessCalculator.php
    │   │   │       ├── Calculator.php
    │   │   │       ├── MaintainabilityCalculator.php
    │   │   │       └── StabilityCalculator.php
    │   │   │   ├── Filters
    │   │   │       ├── Collectors
    │   │   │       │   ├── Components.php
    │   │   │       │   ├── Depth.php
    │   │   │       │   └── Metrics.php
    │   │   │       ├── Contracts
    │   │   │       │   └── Transformer.php
    │   │   │       └── Transformers
    │   │   │       │   ├── ComponentTransformer.php
    │   │   │       │   ├── NullTransformer.php
    │   │   │       │   └── TargetTransformer.php
    │   │   │   ├── Network
    │   │   │       ├── Network.php
    │   │   │       ├── NetworkAttribute.php
    │   │   │       ├── NetworkAttributesMapper.php
    │   │   │       ├── NetworkBuilder.php
    │   │   │       └── Networkable.php
    │   │   │   └── Views
    │   │   │       └── SystemFileLauncher.php
    │   ├── ArrayFormatter.php
    │   ├── Cyclic
    │   │   └── Summary
    │   │   │   ├── CycleHelper.php
    │   │   │   ├── CyclicPresenterMapper.php
    │   │   │   ├── SummaryPresenter.php
    │   │   │   ├── SummarySettings.php
    │   │   │   ├── SummaryView.php
    │   │   │   └── SummaryViewModel.php
    │   ├── NameFormatter.php
    │   └── Weakness
    │   │   └── Summary
    │   │       ├── SummaryPresenter.php
    │   │       ├── SummarySettings.php
    │   │       ├── SummaryView.php
    │   │       ├── SummaryViewModel.php
    │   │       └── WeaknessPresenterMapper.php
    └── Providers
    │   ├── AppServiceProvider.php
    │   └── Custom
    │       └── CustomNodeTraverserFactory.php
├── arts
    ├── graph.png
    └── home.png
├── bootstrap
    ├── app.php
    └── providers.php
├── box.json
├── builds
    └── class-dependencies-analyzer
├── class-dependencies-analyzer
├── composer.json
├── composer.lock
├── config
    ├── app.php
    ├── commands.php
    └── view.php
├── phpunit.xml.dist
├── resources
    └── views
    │   ├── class-graph.blade.php
    │   └── components-graph.blade.php
├── storage
    ├── app
    │   └── .gitignore
    └── framework
    │   └── views
    │       └── .gitignore
└── tests
    ├── Builders
        ├── AnalyzeMetricBuilder.php
        ├── ClassDependenciesBuilder.php
        ├── DependencyAggregatorBuilder.php
        └── WeaknessResponseBuilder.php
    ├── CreatesApplication.php
    ├── Feature
        ├── AnalyzeClassTest.php
        ├── CyclicTest.php
        └── WeaknessTest.php
    ├── Pest.php
    ├── TestCase.php
    └── Unit
        ├── Domain
            ├── Aggregators
            │   └── DependencyAggregatorTest.php
            ├── Entities
            │   └── ClassDependenciesTest.php
            ├── Services
            │   └── CyclicDependencyTest.php
            └── ValueObjects
            │   ├── CouplingTest.php
            │   └── FqcnTest.php
        ├── Infrastructure
            └── Services
            │   ├── AnalyzerServiceAdapterTest.php
            │   ├── FileStub.php
            │   └── Stubs
            │       ├── A.php
            │       └── Native.php
        └── Presenter
            ├── Calculators
                └── MaintainabilityCalculatorTest.php
            ├── ComponentMapperTest.php
            ├── Filters
                └── TargetFilterTest.php
            ├── Formatters
                ├── ArrayFormatterTest.php
                └── NameFormatterTest.php
            ├── Helpers
                └── CycleHelperTest.php
            ├── WeaknessSummaryPresenterTest.php
            └── WeaknessSummaryViewSpy.php


/.editorconfig:
--------------------------------------------------------------------------------
 1 | root = true
 2 | 
 3 | [*]
 4 | charset = utf-8
 5 | end_of_line = lf
 6 | insert_final_newline = true
 7 | indent_style = space
 8 | indent_size = 4
 9 | trim_trailing_whitespace = true
10 | 
11 | [*.md]
12 | trim_trailing_whitespace = false
13 | 
14 | [*.yml]
15 | indent_size = 2
16 | 


--------------------------------------------------------------------------------
/.gitattributes:
--------------------------------------------------------------------------------
1 | * text=auto eol=lf
2 | /.github export-ignore
3 | .scrutinizer.yml export-ignore
4 | BACKERS.md export-ignore
5 | CONTRIBUTING.md export-ignore
6 | CHANGELOG.md export-ignore
7 | 


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 | /vendor
2 | /.idea
3 | /.vscode
4 | /.vagrant
5 | .phpunit.result.cache
6 | 
7 | graph.html
8 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | <p align="center">
 2 | <img src="https://github.com/DeGraciaMathieu/php-smelly-code-detector/blob/master/arts/robot.png" width="250">
 3 | </p>
 4 | 
 5 | 
 6 | 
 7 | # php-class-dependencies-analyzer
 8 | 
 9 | [![testing](https://github.com/DeGraciaMathieu/php-class-dependencies-analyzer/actions/workflows/testing.yml/badge.svg)](https://github.com/DeGraciaMathieu/php-class-dependencies-analyzer/actions/workflows/testing.yml)
10 | ![GitHub Tag](https://img.shields.io/github/v/tag/DeGraciaMathieu/php-class-dependencies-analyzer)
11 | 
12 | ## Phar
13 | This tool is distributed as a [PHP Archive (PHAR)](https://www.php.net/phar):
14 | 
15 | ```
16 | wget https://github.com/DeGraciaMathieu/php-class-dependencies-analyzer/raw/main/builds/class-dependencies-analyzer
17 | ```
18 | 
19 | ```
20 | php class-dependencies-analyzer --version
21 | ```
22 | 
23 | ## Documentation
24 | 
25 | Full documentation [here](https://php-quality-tools.com/class-dependencies-analyzer/).
26 | 
27 | <p align="center">
28 | <img src="https://github.com/DeGraciaMathieu/php-class-dependencies-analyzer/blob/main/arts/home.png?raw=true" width="600">
29 | </p>
30 | 
31 | > 🇫🇷 For French developers, an [article](https://laravel-france.com/posts/des-dependances-stables-pour-une-architecture-de-qualite) on Laravel France explores these stable dependency concepts.
32 | 
33 | > [!TIP]  
34 | > Other analysis [tools](https://github.com/DeGraciaMathieu) are available.
35 | 


--------------------------------------------------------------------------------
/app/Application/Analyze/AnalyzeAction.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Application\Analyze;
 4 | 
 5 | use Throwable;
 6 | use App\Application\Analyze\AnalyzeRequest;
 7 | use App\Application\Analyze\AnalyzePresenter;
 8 | use App\Domain\Ports\Repositories\FileRepository;
 9 | use App\Application\Analyze\AnalyzeResponseMapper;
10 | 
11 | class AnalyzeAction
12 | {
13 |     public function __construct(
14 |         private FileRepository $fileRepository,
15 |         private AnalyzeResponseMapper $mapper,
16 |     ) {}
17 | 
18 |     public function execute(AnalyzeRequest $request, AnalyzePresenter $presenter): void
19 |     {
20 |         try {
21 | 
22 |             $presenter->hello();
23 | 
24 |             $fileAggregator = $this->fileRepository->find($request->path);
25 | 
26 |             $dependencyAggregator = $fileAggregator->getAllDependencies();
27 | 
28 |             $dependencyAggregator->calculateInstability();
29 | 
30 |             $dependencyAggregator->calculateAbstractness();
31 | 
32 |             $dependencyAggregator->filter($request->only, $request->exclude);
33 | 
34 |             $presenter->present(
35 |                 $this->mapper->from($dependencyAggregator),
36 |             );
37 | 
38 |         } catch (Throwable $e) {
39 |             $presenter->error($e);
40 |         }
41 |     }
42 | }
43 | 


--------------------------------------------------------------------------------
/app/Application/Analyze/AnalyzeMetric.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Application\Analyze;
 4 | 
 5 | class AnalyzeMetric
 6 | {
 7 |     public function __construct(
 8 |         private readonly array $metric,
 9 |     ) {}
10 | 
11 |     public function name(): string
12 |     {
13 |         return $this->metric['name'];
14 |     }
15 | 
16 |     public function dependencies(): array
17 |     {
18 |         return $this->metric['dependencies'];
19 |     }
20 | 
21 |     public function abstract(): bool
22 |     {
23 |         return $this->metric['abstract'];
24 |     }
25 | 
26 |     public function efferentCoupling(): float
27 |     {
28 |         return $this->metric['coupling']['efferent'];
29 |     }
30 | 
31 |     public function afferentCoupling(): float
32 |     {
33 |         return $this->metric['coupling']['afferent'];
34 |     }
35 | 
36 |     public function instability(): float
37 |     {
38 |         return $this->metric['coupling']['instability'];
39 |     }
40 | 
41 |     public function numberOfAbstractDependencies(): int
42 |     {
43 |         return $this->metric['abstractness']['numberOfAbstractDependencies'];
44 |     }
45 | 
46 |     public function abstractnessRatio(): float
47 |     {
48 |         return $this->metric['abstractness']['ratio'];
49 |     }
50 | }
51 | 


--------------------------------------------------------------------------------
/app/Application/Analyze/AnalyzePresenter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Application\Analyze;
 4 | 
 5 | use Throwable;
 6 | use App\Application\Analyze\AnalyzeResponse;
 7 | 
 8 | interface AnalyzePresenter
 9 | {
10 |     public function hello(): void;
11 |     public function present(AnalyzeResponse $response): void;
12 |     public function error(Throwable $e): void;
13 | }
14 | 


--------------------------------------------------------------------------------
/app/Application/Analyze/AnalyzeRequest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Application\Analyze;
 4 | 
 5 | class AnalyzeRequest
 6 | {
 7 |     public function __construct(
 8 |         public readonly string $path,
 9 |         public readonly array $only = [],
10 |         public readonly array $exclude = [],
11 |     ) {}
12 | }
13 | 


--------------------------------------------------------------------------------
/app/Application/Analyze/AnalyzeResponse.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Application\Analyze;
 4 | 
 5 | class AnalyzeResponse
 6 | {
 7 |     public function __construct(
 8 |         public readonly int $count,
 9 |         public readonly array $metrics,
10 |     ) {}
11 | }
12 | 


--------------------------------------------------------------------------------
/app/Application/Analyze/AnalyzeResponseMapper.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Application\Analyze;
 4 | 
 5 | use App\Application\Analyze\AnalyzeResponse;
 6 | use App\Domain\Aggregators\DependencyAggregator;
 7 | 
 8 | class AnalyzeResponseMapper
 9 | {
10 |     public function from(DependencyAggregator $dependencyAggregator): AnalyzeResponse
11 |     {
12 |         return new AnalyzeResponse(
13 |             count: $dependencyAggregator->count(),
14 |             metrics: $this->map($dependencyAggregator),
15 |         );
16 |     }
17 | 
18 |     private function map(DependencyAggregator $dependencyAggregator): array
19 |     {
20 |         return array_map(function (array $metric) {
21 |             return new AnalyzeMetric($metric);
22 |         }, $dependencyAggregator->toArray());
23 |     }
24 | }   
25 | 


--------------------------------------------------------------------------------
/app/Application/Cyclic/CyclicAction.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Application\Cyclic;
 4 | 
 5 | use Throwable;
 6 | use App\Application\Cyclic\CyclicRequest;
 7 | use App\Application\Cyclic\CyclicPresenter;
 8 | use App\Application\Cyclic\CyclicResponseMapper;
 9 | use App\Domain\Ports\Repositories\FileRepository;
10 | 
11 | class CyclicAction
12 | {
13 |     public function __construct(
14 |         private FileRepository $fileRepository,
15 |         private CyclicResponseMapper $mapper,
16 |     ) {}
17 | 
18 |     public function execute(CyclicRequest $request, CyclicPresenter $presenter): void
19 |     {
20 |         try {
21 | 
22 |             $presenter->hello();
23 | 
24 |             $fileAggregator = $this->fileRepository->find($request->path);
25 | 
26 |             $dependencyAggregator = $fileAggregator->getAllDependencies();
27 | 
28 |             $dependencyAggregator->filter($request->only, $request->exclude);
29 | 
30 |             $cycles = $dependencyAggregator->detectCycles();
31 | 
32 |             $presenter->present(
33 |                 $this->mapper->from($cycles),
34 |             );
35 | 
36 |         } catch (Throwable $e) {
37 |             $presenter->error($e);
38 |         }
39 |     }
40 | }
41 | 


--------------------------------------------------------------------------------
/app/Application/Cyclic/CyclicPresenter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Application\Cyclic;
 4 | 
 5 | use Throwable;
 6 | use App\Application\Cyclic\CyclicResponse;
 7 | 
 8 | interface CyclicPresenter
 9 | {
10 |     public function hello(): void;
11 |     public function present(CyclicResponse $response): void;
12 |     public function error(Throwable $e): void;
13 | }
14 | 


--------------------------------------------------------------------------------
/app/Application/Cyclic/CyclicRequest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Application\Cyclic;
 4 | 
 5 | class CyclicRequest
 6 | {
 7 |     public function __construct(
 8 |         public readonly string $path,
 9 |         public readonly array $only = [],
10 |         public readonly array $exclude = [],
11 |     ) {}
12 | }
13 | 


--------------------------------------------------------------------------------
/app/Application/Cyclic/CyclicResponse.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Application\Cyclic;
 4 | 
 5 | class CyclicResponse
 6 | {
 7 |     public function __construct(
 8 |         public readonly int $count,
 9 |         public readonly array $cycles,
10 |     ) {}
11 | }
12 | 


--------------------------------------------------------------------------------
/app/Application/Cyclic/CyclicResponseMapper.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Application\Cyclic;
 4 | 
 5 | use App\Domain\Services\Cycle;
 6 | use App\Application\Cyclic\CyclicResponse;
 7 | 
 8 | class CyclicResponseMapper
 9 | {
10 |     public function from(Cycle $cycles): CyclicResponse
11 |     {
12 |         return new CyclicResponse(
13 |             count: $cycles->count(),
14 |             cycles: $cycles->all(),
15 |         );
16 |     }
17 | }
18 | 


--------------------------------------------------------------------------------
/app/Application/Weakness/WeaknessAction.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Application\Weakness;
 4 | 
 5 | use Throwable;
 6 | use App\Application\Weakness\WeaknessRequest;
 7 | use App\Application\Weakness\WeaknessPresenter;
 8 | use App\Domain\Ports\Repositories\FileRepository;
 9 | 
10 | class WeaknessAction
11 | {
12 |     public function __construct(
13 |         private FileRepository $fileRepository,
14 |         private WeaknessResponseMapper $mapper,
15 |     ) {}
16 | 
17 |     public function execute(WeaknessRequest $request, WeaknessPresenter $presenter): void
18 |     {
19 |         try {
20 | 
21 |             $presenter->hello();
22 | 
23 |             $fileAggregator = $this->fileRepository->find($request->path);
24 | 
25 |             $dependencyAggregator = $fileAggregator->getAllDependencies();
26 | 
27 |             $dependencyAggregator->calculateInstability();
28 | 
29 |             $dependencyAggregator->filter($request->only, $request->exclude);
30 | 
31 |             $presenter->present(
32 |                 $this->mapper->from($dependencyAggregator),
33 |             );
34 | 
35 |         } catch (Throwable $e) {
36 |             $presenter->error($e);
37 |         }
38 |     }
39 | }
40 | 


--------------------------------------------------------------------------------
/app/Application/Weakness/WeaknessPresenter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Application\Weakness;
 4 | 
 5 | use Throwable;
 6 | use App\Application\Weakness\WeaknessResponse;
 7 | 
 8 | interface WeaknessPresenter
 9 | {
10 |     public function hello(): void;
11 |     public function present(WeaknessResponse $response): void;
12 |     public function error(Throwable $exception): void;
13 | }
14 | 


--------------------------------------------------------------------------------
/app/Application/Weakness/WeaknessRequest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Application\Weakness;
 4 | 
 5 | class WeaknessRequest
 6 | {
 7 |     public function __construct(
 8 |         public readonly string $path,
 9 |         public readonly array $only = [],
10 |         public readonly array $exclude = [],
11 |     ) {}
12 | }


--------------------------------------------------------------------------------
/app/Application/Weakness/WeaknessResponse.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Application\Weakness;
 4 | 
 5 | class WeaknessResponse
 6 | {
 7 |     public function __construct(
 8 |         public readonly int $count,
 9 |         public readonly array $metrics,
10 |     ) {}
11 | }


--------------------------------------------------------------------------------
/app/Application/Weakness/WeaknessResponseMapper.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Application\Weakness;
 4 | 
 5 | use App\Domain\Aggregators\DependencyAggregator;
 6 | 
 7 | class WeaknessResponseMapper
 8 | {
 9 |     public function from(DependencyAggregator $dependencyAggregator): WeaknessResponse
10 |     {
11 |         $classes = $dependencyAggregator->toArray();
12 | 
13 |         return new WeaknessResponse(
14 |             count: $dependencyAggregator->count(),
15 |             metrics: $this->formatClassesMetrics($classes),
16 |         );
17 |     }
18 | 
19 |     private function formatClassesMetrics(array $classes): array
20 |     {
21 |         $metrics = [];
22 | 
23 |         foreach ($classes as $class) {
24 | 
25 |             $instability = $class['coupling']['instability'];
26 | 
27 |             foreach ($class['dependencies'] as $dependency) {
28 | 
29 |                 $dependency = $classes[$dependency] ?? null;
30 | 
31 |                 if ($dependency && $dependency['coupling']['instability'] > $instability) {
32 | 
33 |                     $metrics[] = [
34 |                         'class' => $class['name'],
35 |                         'class_instability' => $instability,
36 |                         'dependency' => $dependency['name'],
37 |                         'dependency_instability' => $dependency['coupling']['instability'],
38 |                         'delta' => $dependency['coupling']['instability'] - $instability,
39 |                     ];
40 |                 }
41 |             }
42 |         }
43 | 
44 |         return $metrics;
45 |     }
46 | }
47 | 


--------------------------------------------------------------------------------
/app/Commands/AbstractCommand.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Commands;
 4 | 
 5 | use LaravelZero\Framework\Commands\Command;
 6 | 
 7 | abstract class AbstractCommand extends Command
 8 | {
 9 |     public function optionToList(string $key): array
10 |     {
11 |         $value = $this->option($key);
12 | 
13 |         return $this->stringToList($value);
14 |     }
15 | 
16 |     public function argumentToList(string $key): array
17 |     {
18 |         $value = $this->argument($key);
19 | 
20 |         return $this->stringToList($value);
21 |     }
22 | 
23 |     private function stringToList(?string $value): array
24 |     {
25 |         return $value === null ? [] : explode(',', $value);
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/app/Commands/Analyze/Class/AnalyzeCommand.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Commands\Analyze\Class;
 4 | 
 5 | use App\Commands\AbstractCommand;
 6 | use App\Application\Analyze\AnalyzeAction;
 7 | use App\Application\Analyze\AnalyzeRequest;
 8 | use App\Application\Analyze\AnalyzePresenter;
 9 | 
10 | class AnalyzeCommand extends AbstractCommand
11 | {
12 |     protected $signature = 'analyze:class {path} 
13 |         {--graph} 
14 |         {--only=} 
15 |         {--exclude=} 
16 |         {--target=}
17 |         {--depth-limit=}
18 |         {--debug}
19 |         {--info}
20 |         {--human-readable : Display human readable metrics}
21 |     ';
22 | 
23 |     protected $description = 'Analyze the given path';
24 | 
25 |     public function handle(AnalyzeAction $action): void
26 |     {
27 |         $action->execute(
28 |             request: $this->makeRequest(),
29 |             presenter: $this->makePresenter(),
30 |         );
31 |     }
32 | 
33 |     private function makeRequest(): AnalyzeRequest
34 |     {
35 |         return new AnalyzeRequest(
36 |             path: $this->argument('path'), 
37 |             only: $this->optionToList('only'),
38 |             exclude: $this->optionToList('exclude'),
39 |         );
40 |     }
41 | 
42 |     private function makePresenter(): AnalyzePresenter
43 |     {
44 |         return app(PresenterFactory::class)->make($this);
45 |     }
46 | }
47 | 


--------------------------------------------------------------------------------
/app/Commands/Analyze/Class/Graph/GraphPresenterFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Commands\Analyze\Class\Graph;
 4 | 
 5 | use LaravelZero\Framework\Commands\Command;
 6 | use App\Presenter\Analyze\Class\Graph\GraphView;
 7 | use App\Commands\Analyze\Class\TransformerFactory;
 8 | use App\Presenter\Analyze\Class\Graph\GraphMapper;
 9 | use App\Presenter\Analyze\Class\Graph\GraphPresenter;
10 | use App\Commands\Analyze\Class\Graph\GraphSettingsFactory;
11 | 
12 | class GraphPresenterFactory
13 | {
14 |     public function __construct(
15 |         private readonly GraphView $view,
16 |         private readonly GraphMapper $mapper,
17 |         private readonly GraphSettingsFactory $settingsFactory,
18 |         private readonly TransformerFactory $transformerFactory,
19 |     ) {}
20 | 
21 |     public function make(Command $command): GraphPresenter
22 |     {
23 |         return new GraphPresenter(
24 |             view: $this->view,
25 |             mapper: $this->mapper,
26 |             transformer: $this->transformerFactory->make($command),
27 |             settings: $this->settingsFactory->make($command),
28 |         );
29 |     }
30 | }
31 | 


--------------------------------------------------------------------------------
/app/Commands/Analyze/Class/Graph/GraphSettingsFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Commands\Analyze\Class\Graph;
 4 | 
 5 | use LaravelZero\Framework\Commands\Command;
 6 | use App\Presenter\Analyze\Class\Graph\GraphSettings;
 7 | 
 8 | class GraphSettingsFactory
 9 | {
10 |     public function make(Command $command): GraphSettings
11 |     {
12 |         return new GraphSettings(
13 |             debug: $command->option('debug'),
14 |         );
15 |     }
16 | }
17 | 


--------------------------------------------------------------------------------
/app/Commands/Analyze/Class/PresenterFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Commands\Analyze\Class;
 4 | 
 5 | use Illuminate\Console\Command;
 6 | use App\Application\Analyze\AnalyzePresenter;
 7 | use App\Commands\Analyze\Class\Graph\GraphPresenterFactory;
 8 | use App\Commands\Analyze\Class\Summary\SummaryPresenterFactory;
 9 | 
10 | class PresenterFactory
11 | {
12 |     public function __construct(
13 |         private readonly GraphPresenterFactory $graphPresenterFactory,
14 |         private readonly SummaryPresenterFactory $summaryPresenterFactory,
15 |     ) {}
16 | 
17 |     public function make(Command $command): AnalyzePresenter
18 |     {
19 |         return $command->option('graph')
20 |             ? $this->makeGraphPresenter($command)
21 |             : $this->makeSummaryPresenter($command);
22 |     }
23 | 
24 |     private function makeGraphPresenter(Command $command): AnalyzePresenter
25 |     {
26 |         return $this->graphPresenterFactory->make($command);
27 |     }
28 | 
29 |     private function makeSummaryPresenter(Command $command): AnalyzePresenter
30 |     {
31 |         return $this->summaryPresenterFactory->make($command);
32 |     }
33 | }
34 | 


--------------------------------------------------------------------------------
/app/Commands/Analyze/Class/Summary/SummaryPresenterFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Commands\Analyze\Class\Summary;
 4 | 
 5 | use LaravelZero\Framework\Commands\Command;
 6 | use App\Commands\Analyze\Class\TransformerFactory;
 7 | use App\Presenter\Analyze\Class\Summary\SummaryView;
 8 | use App\Presenter\Analyze\Class\Summary\SummaryMapper;
 9 | use App\Presenter\Analyze\Class\Summary\SummaryPresenter;
10 | use App\Commands\Analyze\Class\Summary\SummarySettingsFactory;
11 | 
12 | class SummaryPresenterFactory
13 | {
14 |     public function __construct(
15 |         private readonly SummaryView $view,
16 |         private readonly SummaryMapper $mapper,
17 |         private readonly SummarySettingsFactory $settingsFactory,
18 |         private readonly TransformerFactory $transformerFactory,
19 |     ) {}
20 | 
21 |     public function make(Command $command): SummaryPresenter
22 |     {
23 |         return new SummaryPresenter(
24 |             view: $this->view,
25 |             mapper: $this->mapper,
26 |             transformer: $this->transformerFactory->make($command),
27 |             settings: $this->settingsFactory->make($command),
28 |         );
29 |     }
30 | }
31 | 


--------------------------------------------------------------------------------
/app/Commands/Analyze/Class/Summary/SummarySettingsFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Commands\Analyze\Class\Summary;
 4 | 
 5 | use LaravelZero\Framework\Commands\Command;
 6 | use App\Presenter\Analyze\Class\Summary\SummarySettings;
 7 | 
 8 | class SummarySettingsFactory
 9 | {
10 |     public function make(Command $command): SummarySettings
11 |     {
12 |         return new SummarySettings(
13 |             debug: $command->option('debug'),
14 |             info: $command->option('info'),
15 |             humanReadable: $command->option('human-readable'),
16 |         );
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/app/Commands/Analyze/Class/TransformerFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Commands\Analyze\Class;
 4 | 
 5 | use LaravelZero\Framework\Commands\Command;
 6 | use App\Presenter\Analyze\Shared\Filters\Contracts\Transformer;
 7 | use App\Presenter\Analyze\Shared\Filters\Transformers\NullTransformer;
 8 | use App\Presenter\Analyze\Shared\Filters\Transformers\TargetTransformer;
 9 | 
10 | class TransformerFactory
11 | {
12 |     public static function make(Command $command): Transformer
13 |     {
14 |         return match ($command->option('target')) {
15 |             default => self::makeTargetTransformer($command),
16 |             null => self::makeNullTransformer(),
17 |         };
18 |     }
19 | 
20 |     private static function makeTargetTransformer(Command $command): Transformer
21 |     {
22 |         return app(TargetTransformer::class, [
23 |             'target' => $command->option('target'),
24 |             'depthLimit' => $command->option('depth-limit'),
25 |         ]);
26 |     }
27 | 
28 |     private static function makeNullTransformer(): Transformer
29 |     {
30 |         return app(NullTransformer::class);
31 |     }
32 | }
33 | 


--------------------------------------------------------------------------------
/app/Commands/Analyze/Component/ComponentCommand.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Commands\Analyze\Component;
 4 | 
 5 | use App\Commands\AbstractCommand;
 6 | use App\Application\Analyze\AnalyzeAction;
 7 | use App\Application\Analyze\AnalyzeRequest;
 8 | use App\Application\Analyze\AnalyzePresenter;
 9 | use App\Commands\Analyze\Component\Factories\PresenterFactory;
10 | 
11 | class ComponentCommand extends AbstractCommand
12 | {
13 |     protected $signature = 'analyze:component {path} {components}
14 |         {--graph} 
15 |         {--debug}
16 |         {--info}
17 |         {--human-readable : Display human readable metrics}
18 |     ';
19 | 
20 |     protected $description = '';
21 | 
22 |     public function handle(AnalyzeAction $action): void
23 |     {
24 |         $action->execute(
25 |             request: $this->makeRequest(),
26 |             presenter: $this->makePresenter(),
27 |         );
28 |     }
29 | 
30 |     private function makeRequest(): AnalyzeRequest
31 |     {
32 |         return new AnalyzeRequest(
33 |             path: $this->argument('path'),
34 |         );
35 |     }
36 | 
37 |     private function makePresenter(): AnalyzePresenter
38 |     {
39 |         return app(PresenterFactory::class)->make($this);
40 |     }
41 | }
42 | 


--------------------------------------------------------------------------------
/app/Commands/Analyze/Component/Factories/PresenterFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Commands\Analyze\Component\Factories;
 4 | 
 5 | use Illuminate\Console\Command;
 6 | use App\Application\Analyze\AnalyzePresenter;
 7 | use App\Commands\Analyze\Component\Graph\GraphPresenterFactory;
 8 | use App\Commands\Analyze\Component\Summary\SummaryPresenterFactory;
 9 | 
10 | class PresenterFactory
11 | {
12 |     public function __construct(
13 |         private readonly GraphPresenterFactory $graphPresenterFactory,
14 |         private readonly SummaryPresenterFactory $summaryPresenterFactory,
15 |     ) {}
16 | 
17 |     public function make(Command $command): AnalyzePresenter
18 |     {
19 |         return $command->option('graph')
20 |             ? $this->makeGraphPresenter($command)
21 |             : $this->makeSummaryPresenter($command);
22 |     }
23 | 
24 |     private function makeGraphPresenter(Command $command): AnalyzePresenter
25 |     {
26 |         return $this->graphPresenterFactory->make($command);
27 |     }
28 | 
29 |     private function makeSummaryPresenter(Command $command): AnalyzePresenter
30 |     {
31 |         return $this->summaryPresenterFactory->make($command);
32 |     }
33 | }
34 | 


--------------------------------------------------------------------------------
/app/Commands/Analyze/Component/Factories/TransformerFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Commands\Analyze\Component\Factories;
 4 | 
 5 | use LaravelZero\Framework\Commands\Command;
 6 | use App\Presenter\Analyze\Shared\Filters\Contracts\Transformer;
 7 | use App\Presenter\Analyze\Shared\Filters\Transformers\ComponentTransformer;
 8 | 
 9 | class TransformerFactory
10 | {
11 |     public static function make(Command $command): Transformer
12 |     {
13 |         return app(ComponentTransformer::class, [
14 |             'targetedComponents' => $command->argumentToList('components'), 
15 |         ]);
16 |     }
17 | }
18 | 


--------------------------------------------------------------------------------
/app/Commands/Analyze/Component/Graph/GraphPresenterFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Commands\Analyze\Component\Graph;
 4 | 
 5 | use LaravelZero\Framework\Commands\Command;
 6 | use App\Application\Analyze\AnalyzePresenter;
 7 | use App\Presenter\Analyze\Component\Graph\GraphView;
 8 | use App\Presenter\Analyze\Component\Graph\GraphMapper;
 9 | use App\Presenter\Analyze\Component\Graph\GraphPresenter;
10 | use App\Commands\Analyze\Component\Graph\GraphSettingsFactory;
11 | use App\Commands\Analyze\Component\Factories\TransformerFactory;
12 | 
13 | class GraphPresenterFactory
14 | {
15 |     public function __construct(
16 |         private readonly GraphView $view,
17 |         private readonly GraphMapper $mapper,
18 |         private readonly TransformerFactory $transformerFactory,
19 |         private readonly GraphSettingsFactory $settingsFactory,
20 |     ) {}
21 | 
22 |     public function make(Command $command): AnalyzePresenter
23 |     {
24 |         return new GraphPresenter(
25 |             view: $this->view,
26 |             mapper: $this->mapper,
27 |             transformer: $this->transformerFactory->make($command),
28 |             settings: $this->settingsFactory->make($command),
29 |         );
30 |     }
31 | }
32 | 


--------------------------------------------------------------------------------
/app/Commands/Analyze/Component/Graph/GraphSettingsFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Commands\Analyze\Component\Graph;
 4 | 
 5 | use LaravelZero\Framework\Commands\Command;
 6 | use App\Presenter\Analyze\Component\Graph\GraphSettings;
 7 | 
 8 | class GraphSettingsFactory
 9 | {
10 |     public function make(Command $command): GraphSettings
11 |     {
12 |         return new GraphSettings(
13 |             components: $command->argumentToList('components'),
14 |             info: $command->option('info'),
15 |             debug: $command->option('debug'),
16 |         );
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/app/Commands/Analyze/Component/Summary/SummaryPresenterFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Commands\Analyze\Component\Summary;
 4 | 
 5 | use LaravelZero\Framework\Commands\Command;
 6 | use App\Application\Analyze\AnalyzePresenter;
 7 | use App\Presenter\Analyze\Component\Summary\SummaryView;
 8 | use App\Presenter\Analyze\Component\Summary\SummaryMapper;
 9 | use App\Presenter\Analyze\Component\Summary\SummaryPresenter;
10 | use App\Commands\Analyze\Component\Factories\TransformerFactory;
11 | use App\Commands\Analyze\Component\Summary\SummarySettingsFactory;
12 | 
13 | class SummaryPresenterFactory
14 | {
15 |     public function __construct(
16 |         private readonly SummaryView $view,
17 |         private readonly SummaryMapper $mapper,
18 |         private readonly TransformerFactory $transformerFactory,
19 |         private readonly SummarySettingsFactory $settingsFactory,
20 |     ) {}
21 | 
22 |     public function make(Command $command): AnalyzePresenter
23 |     {
24 |         return new SummaryPresenter(
25 |             view: $this->view,
26 |             mapper: $this->mapper,
27 |             transformer: $this->transformerFactory->make($command),
28 |             settings: $this->settingsFactory->make($command),
29 |         );
30 |     }
31 | }
32 | 


--------------------------------------------------------------------------------
/app/Commands/Analyze/Component/Summary/SummarySettingsFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Commands\Analyze\Component\Summary;
 4 | 
 5 | use LaravelZero\Framework\Commands\Command;
 6 | use App\Presenter\Analyze\Component\Summary\SummarySettings;
 7 | 
 8 | class SummarySettingsFactory
 9 | {
10 |     public function make(Command $command): SummarySettings
11 |     {
12 |         return new SummarySettings(
13 |             components: $command->argumentToList('components'),
14 |             info: $command->option('info'),
15 |             debug: $command->option('debug'),
16 |         );
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/app/Commands/Cyclic/CyclicCommand.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Commands\Cyclic;
 4 | 
 5 | use App\Commands\AbstractCommand;
 6 | use App\Application\Cyclic\CyclicAction;
 7 | use App\Application\Cyclic\CyclicRequest;
 8 | use App\Application\Cyclic\CyclicPresenter;
 9 | use App\Commands\Cyclic\SummaryPresenterFactory;
10 | 
11 | class CyclicCommand extends AbstractCommand
12 | {
13 |     protected $signature = 'cyclic {path} 
14 |         {--only=} 
15 |         {--exclude=} 
16 |         {--debug}
17 |     ';
18 | 
19 |     protected $description = 'Detect cyclic dependencies in the given path';
20 | 
21 |     public function handle(CyclicAction $action): void
22 |     {
23 |         $action->execute(
24 |             request: $this->makeRequest(),
25 |             presenter: $this->makePresenter(),
26 |         );
27 |     }
28 | 
29 |     private function makeRequest(): CyclicRequest
30 |     {
31 |         return new CyclicRequest(
32 |             path: $this->argument('path'),
33 |             only: $this->optionToList('only'),
34 |             exclude: $this->optionToList('exclude'),
35 |         );
36 |     }
37 | 
38 |     private function makePresenter(): CyclicPresenter
39 |     {
40 |         return app(SummaryPresenterFactory::class)->make($this);
41 |     }
42 | }
43 | 


--------------------------------------------------------------------------------
/app/Commands/Cyclic/SummaryPresenterFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Commands\Cyclic;
 4 | 
 5 | use LaravelZero\Framework\Commands\Command;
 6 | use App\Presenter\Cyclic\Summary\SummaryView;
 7 | use App\Commands\Cyclic\SummarySettingsFactory;
 8 | use App\Presenter\Cyclic\Summary\SummaryPresenter;
 9 | use App\Presenter\Cyclic\Summary\CyclicPresenterMapper;
10 | 
11 | class SummaryPresenterFactory
12 | {
13 |     public function __construct(
14 |         private readonly SummaryView $view,
15 |         private readonly CyclicPresenterMapper $mapper,
16 |         private readonly SummarySettingsFactory $settingsFactory,
17 |     ) {}
18 | 
19 |     public function make(Command $command): SummaryPresenter
20 |     {
21 |         return new SummaryPresenter(
22 |             view: $this->view,
23 |             mapper: $this->mapper,
24 |             settings: $this->settingsFactory->make($command),
25 |         );
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/app/Commands/Cyclic/SummarySettingsFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Commands\Cyclic;
 4 | 
 5 | use LaravelZero\Framework\Commands\Command;
 6 | use App\Presenter\Cyclic\Summary\SummarySettings;
 7 | 
 8 | class SummarySettingsFactory
 9 | {
10 |     public function make(Command $command): SummarySettings
11 |     {
12 |         return new SummarySettings(
13 |             debug: $command->option('debug'),
14 |         );
15 |     }
16 | }
17 | 


--------------------------------------------------------------------------------
/app/Commands/Weakness/SummaryPresenterFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Commands\Weakness;
 4 | 
 5 | use LaravelZero\Framework\Commands\Command;
 6 | use App\Presenter\Weakness\Summary\SummaryView;
 7 | use App\Commands\Weakness\SummarySettingsFactory;
 8 | use App\Presenter\Weakness\Summary\SummaryPresenter;
 9 | 
10 | class SummaryPresenterFactory
11 | {
12 |     public function __construct(
13 |         private readonly SummaryView $view,
14 |         private readonly SummarySettingsFactory $settingsFactory,
15 |     ) {}
16 | 
17 |     public function make(Command $command): SummaryPresenter
18 |     {
19 |         return new SummaryPresenter(
20 |             view: $this->view,
21 |             settings: $this->settingsFactory->make($command),
22 |         );
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/app/Commands/Weakness/SummarySettingsFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Commands\Weakness;
 4 | 
 5 | use LaravelZero\Framework\Commands\Command;
 6 | use App\Presenter\Weakness\Summary\SummarySettings;
 7 | 
 8 | class SummarySettingsFactory
 9 | {
10 |     public function make(Command $command): SummarySettings
11 |     {
12 |         return new SummarySettings(
13 |             limit: $command->option('limit') ?? null,
14 |             minDelta: $command->option('min-delta') ?? null,
15 |             debug: $command->option('debug') ?? false,
16 |         );
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/app/Commands/Weakness/WeaknessCommand.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Commands\Weakness;    
 4 | 
 5 | use App\Commands\AbstractCommand;
 6 | use App\Application\Weakness\WeaknessAction;
 7 | use App\Application\Weakness\WeaknessRequest;
 8 | use App\Application\Weakness\WeaknessPresenter;
 9 | use App\Commands\Weakness\SummaryPresenterFactory;
10 | 
11 | class WeaknessCommand extends AbstractCommand
12 | {
13 |     protected $signature = 'weakness {path} 
14 |         {--only=} 
15 |         {--exclude=} 
16 |         {--limit=}
17 |         {--min-delta=}
18 |         {--debug}
19 |     ';
20 | 
21 |     protected $description = 'Find weaknesses dependencies in the code';
22 | 
23 |     public function handle(WeaknessAction $action): void
24 |     {
25 |         $action->execute(
26 |             request: $this->makeRequest(),
27 |             presenter: $this->makePresenter(),
28 |         );
29 |     }
30 | 
31 |     private function makeRequest(): WeaknessRequest
32 |     {
33 |         return new WeaknessRequest(
34 |             path: $this->argument('path'),
35 |             only: $this->optionToList('only'),
36 |             exclude: $this->optionToList('exclude'),
37 |         );
38 |     }
39 | 
40 |     private function makePresenter(): WeaknessPresenter
41 |     {
42 |         return app(SummaryPresenterFactory::class)->make($this);
43 |     }
44 | }
45 | 


--------------------------------------------------------------------------------
/app/Domain/Aggregators/DependencyAggregator.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace App\Domain\Aggregators;
  4 | 
  5 | use App\Domain\Services\Cycle;
  6 | use App\Domain\Services\CyclicDependency;
  7 | use App\Domain\Entities\ClassDependencies;
  8 | 
  9 | class DependencyAggregator
 10 | {
 11 |     private array $classes = [];
 12 | 
 13 |     public function __construct(
 14 |         private CyclicDependency $cyclicDependency,
 15 |     ) {}
 16 | 
 17 |     public function aggregate(ClassDependencies $classDependencies): void
 18 |     {
 19 |         $this->classes[$classDependencies->getName()] = $classDependencies;
 20 |     }
 21 | 
 22 |     public function count(): int
 23 |     {
 24 |         return count($this->classes);
 25 |     }
 26 | 
 27 |     public function classes(): array
 28 |     {
 29 |         return $this->classes;
 30 |     }
 31 | 
 32 |     public function get(string $fqcn): ?ClassDependencies
 33 |     {
 34 |         return $this->classes[$fqcn] ?? null;
 35 |     }
 36 | 
 37 |     public function calculateInstability(): void
 38 |     {
 39 |         foreach ($this->classes as $givenClass) {
 40 | 
 41 |             foreach ($this->classes as $otherClass) {
 42 | 
 43 |                 if ($givenClass->is($otherClass)) {
 44 |                     continue;
 45 |                 }
 46 | 
 47 |                 if ($otherClass->isDependentOn($givenClass)) {
 48 |                     $givenClass->incrementAfferent();
 49 |                 }
 50 |             }
 51 | 
 52 |             $givenClass->calculateInstability();
 53 |         }
 54 |     }
 55 | 
 56 |     public function calculateAbstractness(): void
 57 |     {
 58 |         foreach ($this->classes as $givenClass) {
 59 | 
 60 |             foreach ($givenClass->getDependencies() as $dependency) {
 61 | 
 62 |                 $dependencyClass = $this->get($dependency);
 63 |                 
 64 |                 if ($dependencyClass && $dependencyClass->isAbstract()) {
 65 |                     $givenClass->incrementNumberOfAbstractDependencies();
 66 |                 }
 67 |             }
 68 | 
 69 |             $givenClass->calculateAbstractness();
 70 |         }
 71 |     }
 72 | 
 73 |     public function detectCycles(): Cycle
 74 |     {
 75 |         return $this->cyclicDependency->detect($this->classes);
 76 |     }
 77 | 
 78 |     public function filter(array $only = [], array $exclude = []): void
 79 |     {
 80 |         $this->classes = array_filter($this->classes, function ($givenClass) use ($only, $exclude) {
 81 | 
 82 |             if ($only) {
 83 |                 return $givenClass->looksLike($only);
 84 |             }
 85 | 
 86 |             if ($exclude) {
 87 |                 return ! $givenClass->looksLike($exclude);
 88 |             }
 89 | 
 90 |             return true;
 91 |         });
 92 |     }
 93 | 
 94 |     public function toArray(): array
 95 |     {
 96 |         return array_map(function (ClassDependencies $class) {
 97 |             return $class->toArray();
 98 |         }, $this->classes);
 99 |     }
100 | }
101 | 


--------------------------------------------------------------------------------
/app/Domain/Entities/ClassDependencies.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Domain\Entities;
 4 | 
 5 | use App\Domain\ValueObjects\Fqcn;
 6 | use App\Domain\ValueObjects\Coupling;
 7 | use App\Domain\ValueObjects\IsAbstract;
 8 | use App\Domain\ValueObjects\IsInterface;
 9 | use App\Domain\ValueObjects\Abstractness;
10 | use App\Domain\ValueObjects\Dependencies;
11 | 
12 | class ClassDependencies
13 | {
14 |     public Coupling $coupling;
15 | 
16 |     public function __construct(
17 |         public Fqcn $fqcn,
18 |         public Dependencies $dependencies,
19 |         public IsInterface $isInterface,
20 |         public IsAbstract $isAbstract,
21 |         public Abstractness $abstractness = new Abstractness(),
22 |     ) {
23 |         $this->initializeCouplings();
24 |     }
25 | 
26 |     private function initializeCouplings(): void
27 |     {
28 |         $this->coupling = new Coupling(efferent: $this->dependencies->count());
29 |     }
30 | 
31 |     public function getName(): string
32 |     {
33 |         return $this->fqcn->getValue();
34 |     }
35 | 
36 |     public function looksLike(array $filters): bool
37 |     {
38 |         return $this->fqcn->looksLike($filters);
39 |     }
40 | 
41 |     public function is(ClassDependencies $otherClass): bool
42 |     {
43 |         return $this->fqcn->is($otherClass->fqcn);
44 |     }
45 | 
46 |     public function incrementAfferent(): void
47 |     {
48 |         $this->coupling->incrementAfferent();
49 |     }
50 | 
51 |     public function isDependentOn(ClassDependencies $otherClass): bool
52 |     {
53 |         return $this->dependencies->knows($otherClass->fqcn);
54 |     }
55 | 
56 |     public function calculateInstability(): void
57 |     {
58 |         $this->coupling->calculateInstability();
59 |     }
60 | 
61 |     public function isAbstract(): bool
62 |     {
63 |         return $this->isAbstract->isTrue() || $this->isInterface->isTrue();
64 |     }
65 | 
66 |     public function getDependencies(): array
67 |     {
68 |         return $this->dependencies->getValues();
69 |     }
70 | 
71 |     public function toArray(): array
72 |     {
73 |         return [
74 |             'name' => $this->getName(),
75 |             'dependencies' => $this->getDependencies(),
76 |             'abstract' => $this->isAbstract(),
77 |             'coupling' => $this->coupling->toArray(),
78 |             'abstractness' => $this->abstractness->toArray(),
79 |         ];
80 |     }
81 | 
82 |     public function hasNoDependencies(): bool
83 |     {
84 |         return $this->coupling->nobodyUsesThis();
85 |     }
86 | 
87 |     public function incrementNumberOfAbstractDependencies(): void
88 |     {
89 |         $this->abstractness->increment();
90 |     }
91 | 
92 |     public function calculateAbstractness(): void
93 |     {
94 |         $this->abstractness->calculate($this->coupling->efferent);
95 |     }
96 | }
97 | 


--------------------------------------------------------------------------------
/app/Domain/Ports/Aggregators/FileAggregator.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Domain\Ports\Aggregators;
 4 | 
 5 | use Generator;
 6 | use App\Domain\Aggregators\DependencyAggregator;
 7 | 
 8 | interface FileAggregator
 9 | {
10 |     public function aggregate(Generator $files): void;
11 |     public function getAllDependencies(): DependencyAggregator;
12 | }
13 | 


--------------------------------------------------------------------------------
/app/Domain/Ports/Repositories/FileRepository.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Domain\Ports\Repositories;
 4 | 
 5 | use App\Domain\Ports\Aggregators\FileAggregator;
 6 | 
 7 | interface FileRepository
 8 | {
 9 |     public function find(string $path): FileAggregator;
10 | }
11 | 


--------------------------------------------------------------------------------
/app/Domain/Services/Cycle.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Domain\Services;
 4 | 
 5 | class Cycle
 6 | {
 7 |     public array $cycles = [];
 8 | 
 9 |     public function add(array $cycle): void
10 |     {
11 |         $this->cycles[] = $cycle;
12 |     }
13 | 
14 |     public function isEmpty(): bool
15 |     {
16 |         return empty($this->cycles);
17 |     }
18 | 
19 |     public function count(): int
20 |     {
21 |         return count($this->cycles);
22 |     }
23 | 
24 |     public function all(): array
25 |     {
26 |         return $this->cycles;
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/app/Domain/Services/CyclicDependency.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Domain\Services;
 4 | 
 5 | use App\Domain\Services\Visited;
 6 | use App\Domain\Services\Cycle;
 7 | use App\Domain\Services\Stack;
 8 | 
 9 | class CyclicDependency
10 | {
11 |     public function __construct(
12 |         private Visited $visited,
13 |         private Stack $stack,
14 |         private Cycle $cycle,
15 |     ) {}
16 | 
17 |     public function detect(array $classes): Cycle
18 |     {
19 |         foreach ($classes as $givenClass => $_) {
20 | 
21 |             if ($this->visited->unknown($givenClass)) {
22 |                 $this->deepDive($givenClass, $classes);
23 |             }
24 |         }
25 | 
26 |         return $this->cycle;
27 |     }
28 | 
29 |     private function deepDive(string $class, array $classes): void
30 |     {
31 |         /**
32 |          * Duplicate class can exist in the array.
33 |          * If the class is already visited, we can switch to another class.
34 |          */
35 |         if ($this->visited->isMarked($class)) {
36 |             return;
37 |         }
38 | 
39 |         /**
40 |          * This stack is used to detect cycles.
41 |          * Progressively, we push dependencies in the stack.
42 |          * If the class is already in the stack, we have a cycle.
43 |          */
44 |         if ($this->stack->contains($class)) {
45 | 
46 |             $cycle = $this->stack->extractCycle($class);
47 | 
48 |             $this->cycle->add($cycle);
49 | 
50 |             /**
51 |              * Stop the recursion, we can switch to another class.
52 |              */
53 |             return;
54 |         } 
55 | 
56 |         $this->stack->push($class);
57 | 
58 |         $this->visited->mark($class, false);
59 | 
60 |         foreach ($classes[$class]->getDependencies() as $dependency) {
61 |             if (isset($classes[$dependency])) {
62 |                 $this->deepDive($dependency, $classes);
63 |             }
64 |         }
65 | 
66 |         /**
67 |          * Remove the class from the stack.
68 |          */
69 |         $this->stack->pop();
70 | 
71 |         /**
72 |          * Mark the class as fully explored to avoid infinite loops.
73 |          */
74 |         $this->visited->mark($class, true);
75 |     }
76 | }
77 | 


--------------------------------------------------------------------------------
/app/Domain/Services/Stack.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Domain\Services;
 4 | 
 5 | class Stack
 6 | {
 7 |     public array $stack = [];
 8 | 
 9 |     public function contains(string $class): bool
10 |     {
11 |         return in_array($class, $this->stack, true);
12 |     }
13 | 
14 |     public function push(string $class): void
15 |     {
16 |         $this->stack[] = $class;
17 |     }
18 | 
19 |     public function extractCycle(string $class): array
20 |     {
21 |         /**
22 |          * Get the index of the class in the stack.
23 |          */
24 |         $index = array_search($class, $this->stack);
25 | 
26 |         /**
27 |          * Get the cycle by slicing the stack from the index of the class to the end.
28 |          */
29 |         return array_slice($this->stack, $index);
30 |     }
31 | 
32 |     public function pop(): void
33 |     {
34 |         array_pop($this->stack);
35 |     }
36 | }
37 | 


--------------------------------------------------------------------------------
/app/Domain/Services/Visited.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Domain\Services;
 4 | 
 5 | class Visited
 6 | {
 7 |     private array $visited = [];
 8 | 
 9 |     public function unknown(string $key): bool
10 |     {
11 |         return ! isset($this->visited[$key]);
12 |     }
13 | 
14 |     public function mark(string $key, bool $value): void
15 |     {
16 |         $this->visited[$key] = $value;
17 |     }
18 | 
19 |     public function isMarked(string $key): bool
20 |     {
21 |         return $this->visited[$key] ?? false;
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/app/Domain/ValueObjects/Abstractness.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Domain\ValueObjects;
 4 | 
 5 | class Abstractness
 6 | {
 7 |     public function __construct(
 8 |         private float $ratio = 0,
 9 |         private int $numberOfAbstractDependencies = 0
10 |     ) {}
11 | 
12 |     public function getNumberOfAbstractDependencies(): int
13 |     {
14 |         return $this->numberOfAbstractDependencies;
15 |     }
16 | 
17 |     public function increment(): void
18 |     {
19 |         $this->numberOfAbstractDependencies++;
20 |     }
21 | 
22 |     public function calculate(int $totalDependencies): void
23 |     {
24 |         $this->ratio = $totalDependencies === 0
25 |             ? 0
26 |             : number_format($this->numberOfAbstractDependencies / $totalDependencies, 2);
27 |     }
28 | 
29 |     public function toArray(): array
30 |     {
31 |         return [
32 |             'ratio' => $this->ratio,
33 |             'numberOfAbstractDependencies' => $this->numberOfAbstractDependencies,
34 |         ];
35 |     }
36 | }
37 | 


--------------------------------------------------------------------------------
/app/Domain/ValueObjects/Coupling.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Domain\ValueObjects;
 4 | 
 5 | class Coupling
 6 | {
 7 |     public function __construct(
 8 |         public int $efferent = 0,
 9 |         public int $afferent = 0,
10 |         public float $instability = 0,
11 |     ) {}
12 | 
13 |     public function incrementAfferent(): void
14 |     {
15 |         $this->afferent++;
16 |     }
17 | 
18 |     public function nobodyUsesThis(): bool
19 |     {
20 |         return $this->afferent === 0;
21 |     }
22 | 
23 |     public function calculateInstability(): void
24 |     {
25 |         $instability = $this->efferent / (($this->afferent + $this->efferent) ?: 1);
26 | 
27 |         $this->instability = number_format($instability, 2);
28 |     }
29 | 
30 |     public function toArray(): array
31 |     {
32 |         return [
33 |             'afferent' => $this->afferent,
34 |             'efferent' => $this->efferent,
35 |             'instability' => $this->instability,
36 |         ];
37 |     }
38 | }
39 | 


--------------------------------------------------------------------------------
/app/Domain/ValueObjects/Dependencies.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Domain\ValueObjects;
 4 | 
 5 | use App\Domain\ValueObjects\Fqcn;
 6 | 
 7 | class Dependencies
 8 | {
 9 |     public function __construct(
10 |         public readonly array $values,
11 |     ) {}
12 | 
13 |     public function knows(Fqcn $fqcn): bool
14 |     {
15 |         return in_array($fqcn->getValue(), $this->values);
16 |     }
17 | 
18 |     public function count(): int
19 |     {
20 |         return count($this->values);
21 |     }
22 | 
23 |     public function getValues(): array
24 |     {
25 |         return $this->values;
26 |     }
27 | 
28 |     public static function fromArray(array $values): self
29 |     {
30 |         return new self($values);
31 |     }
32 | }
33 | 


--------------------------------------------------------------------------------
/app/Domain/ValueObjects/Fqcn.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Domain\ValueObjects;
 4 | 
 5 | class Fqcn
 6 | {
 7 |     public function __construct(
 8 |         private readonly string $value,
 9 |     ) {}
10 | 
11 |     public function looksLike(array $filters): bool
12 |     {
13 |         $pattern = '#' . implode('|', array_map('preg_quote', $filters)) . '#';
14 | 
15 |         return (bool) preg_match($pattern, $this->value);
16 |     }
17 | 
18 |     public function getValue(): string
19 |     {
20 |         return $this->value;
21 |     }
22 | 
23 |     public function is(Fqcn $otherFqcn): bool
24 |     {
25 |         return $this->getValue() === $otherFqcn->getValue();
26 |     }
27 | 
28 |     public static function fromString(string $value): self
29 |     {
30 |         return new self($value);
31 |     }
32 | }
33 | 


--------------------------------------------------------------------------------
/app/Domain/ValueObjects/IsAbstract.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Domain\ValueObjects;
 4 | 
 5 | use App\Domain\ValueObjects\SimpleBoolean;
 6 | 
 7 | class IsAbstract extends SimpleBoolean
 8 | {
 9 |     //
10 | }
11 | 


--------------------------------------------------------------------------------
/app/Domain/ValueObjects/IsInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Domain\ValueObjects;
 4 | 
 5 | use App\Domain\ValueObjects\SimpleBoolean;
 6 | 
 7 | class IsInterface extends SimpleBoolean
 8 | {
 9 |     //
10 | }
11 | 


--------------------------------------------------------------------------------
/app/Domain/ValueObjects/SimpleBoolean.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Domain\ValueObjects;
 4 | 
 5 | abstract class SimpleBoolean
 6 | {
 7 |     public function __construct(
 8 |         public bool $value = false,
 9 |     ) {}
10 | 
11 |     public function isTrue(): bool
12 |     {
13 |         return (bool) $this->value;
14 |     }
15 | 
16 |     public static function fromBool(bool $value): self
17 |     {
18 |         return new static($value);
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/app/Infrastructure/Analyze/Adapters/Jerowork/ClassDependenciesParserAdapter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Infrastructure\Analyze\Adapters\Jerowork;
 4 | 
 5 | use PhpParser\Parser;
 6 | use App\Infrastructure\Analyze\Ports\ClassAnalysis;
 7 | use App\Infrastructure\Analyze\Ports\ClassDependenciesParser;
 8 | use App\Infrastructure\Analyze\Adapters\Jerowork\NodeTraverserFactory;
 9 | use Jerowork\ClassDependenciesParser\ClassDependencies as ClassDependenciesCollector;
10 | use App\Infrastructure\Analyze\Adapters\Jerowork\DataTransferObjects\ClassAnalysisAdapter;
11 | use App\Infrastructure\Analyze\Adapters\Jerowork\Collectors\ClassTypeCollector;
12 | 
13 | class ClassDependenciesParserAdapter implements ClassDependenciesParser
14 | {
15 |     public function __construct(
16 |         private readonly Parser $parser,
17 |         private readonly NodeTraverserFactory $traverserFactory,
18 |     ) {}
19 | 
20 |     public function parse(string $filePath): ClassAnalysis
21 |     {
22 |         $fileContent = $this->getFileContent($filePath);
23 |         
24 |         $ast = $this->parseContent($fileContent);
25 |         
26 |         $collectors = $this->makeCollectors($filePath);
27 | 
28 |         $this->traverse($ast, $collectors);
29 | 
30 |         return ClassAnalysisAdapter::fromArray($collectors);
31 |     }
32 | 
33 |     private function getFileContent(string $filePath): ?string
34 |     {
35 |         return file_get_contents($filePath);
36 |     }
37 | 
38 |     private function parseContent(string $content): ?array
39 |     {
40 |         return $this->parser->parse($content);
41 |     }
42 | 
43 |     private function makeCollectors(string $filePath): array
44 |     {
45 |         return [
46 |             'dependencies' => new ClassDependenciesCollector($filePath),
47 |             'type' => new ClassTypeCollector($filePath),
48 |         ];
49 |     }
50 | 
51 |     private function traverse(array $ast, array &$collectors): void
52 |     {
53 |         $traverser = $this->traverserFactory->createTraverser($collectors);
54 | 
55 |         $traverser->traverse($ast);
56 |     }
57 | }
58 | 


--------------------------------------------------------------------------------
/app/Infrastructure/Analyze/Adapters/Jerowork/Collectors/ClassTypeCollector.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Infrastructure\Analyze\Adapters\Jerowork\Collectors;
 4 | 
 5 | class ClassTypeCollector
 6 | {
 7 |     public ?string $namespace = null;
 8 |     public ?string $className = null;
 9 |     public ?bool $isAbstract = false;
10 |     public ?bool $isInterface = false;
11 | 
12 |     public function __construct(
13 |         public string $filePath,
14 |     ) {}
15 | 
16 |     public function isInterface(): bool
17 |     {
18 |         return $this->isInterface;
19 |     }
20 | 
21 |     public function isAbstract(): bool
22 |     {
23 |         return $this->isAbstract;
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/app/Infrastructure/Analyze/Adapters/Jerowork/DataTransferObjects/ClassAnalysisAdapter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Infrastructure\Analyze\Adapters\Jerowork\DataTransferObjects;
 4 | 
 5 | use App\Infrastructure\Analyze\Ports\ClassAnalysis;
 6 | use App\Infrastructure\Analyze\Adapters\Jerowork\Collectors\ClassTypeCollector;
 7 | use Jerowork\ClassDependenciesParser\ClassDependencies as ClassDependenciesCollector;
 8 | 
 9 | class ClassAnalysisAdapter implements ClassAnalysis
10 | {
11 |     public function __construct(
12 |         private ClassDependenciesCollector $classDependencies,
13 |         private ClassTypeCollector $classType,
14 |     ) {}
15 | 
16 |     public function fqcn(): string
17 |     {
18 |         return $this->classDependencies->getFqn() ?? '';
19 |     }
20 | 
21 |     public function dependencies(): array
22 |     {
23 |         return $this->classDependencies->getDependencyList();
24 |     }
25 | 
26 |     public function isInterface(): bool
27 |     {
28 |         return $this->classType->isInterface();
29 |     }
30 | 
31 |     public function isAbstract(): bool
32 |     {
33 |         return $this->classType->isAbstract();
34 |     }
35 | 
36 |     public static function fromArray(array $attributes): self
37 |     {
38 |         return new self(
39 |             $attributes['dependencies'],
40 |             $attributes['type'],
41 |         );
42 |     }
43 | }
44 | 


--------------------------------------------------------------------------------
/app/Infrastructure/Analyze/Adapters/Jerowork/NativeDecliner.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Infrastructure\Analyze\Adapters\Jerowork;
 4 | 
 5 | use PhpParser\Node;
 6 | use PhpParser\Node\Name;
 7 | use Jerowork\ClassDependenciesParser\ClassDependencies;
 8 | use Jerowork\ClassDependenciesParser\PhpParser\NodeVisitor\InlineFqnParser\Decliner\InlineFqnDecliner;
 9 | 
10 | final class NativeDecliner implements InlineFqnDecliner
11 | {
12 |     private array $primitiveTypes = [
13 |         'string',
14 |         'int',
15 |         'float',
16 |         'bool',
17 |         'array',
18 |         'object',
19 |         'null',
20 |         'void',
21 |         'mixed',
22 |         'never',
23 |         'callable',
24 |         'iterable',
25 |         'false',
26 |         'true',
27 |         'self',
28 |         'parent',
29 |         'static',
30 |         'PHP_EOL',
31 |     ];
32 | 
33 |     public function shouldDecline(Node $parent, Name $name, ClassDependencies $classDependencies): bool
34 |     {
35 |         $fqn = $name->toString();
36 | 
37 |         return $this->isNativePrimitiveType($fqn) || $this->isNativePhpClass($fqn);
38 |     }
39 | 
40 |     private function isNativePrimitiveType(string $fqn): bool
41 |     {
42 |         return in_array(strtolower($fqn), $this->primitiveTypes, true);
43 |     }
44 | 
45 |     private function isNativePhpClass(string $fqn): bool
46 |     {
47 |         return function_exists($fqn) ||
48 |             class_exists($fqn, false) ||
49 |             interface_exists($fqn, false);
50 |     }
51 | }
52 | 


--------------------------------------------------------------------------------
/app/Infrastructure/Analyze/Adapters/Jerowork/NodeTraverserFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Infrastructure\Analyze\Adapters\Jerowork;
 4 | 
 5 | use PhpParser\NodeTraverser;
 6 | use PhpParser\NodeTraverserInterface;
 7 | use PhpParser\NodeVisitor\ParentConnectingVisitor;
 8 | use App\Infrastructure\Analyze\Adapters\Jerowork\NativeDecliner;
 9 | use App\Infrastructure\Analyze\Adapters\Jerowork\Visitors\DetectClassTypeVisitor;
10 | use Jerowork\ClassDependenciesParser\PhpParser\NodeVisitor\ParseClassFqnNodeVisitor;
11 | use Jerowork\ClassDependenciesParser\PhpParser\NodeVisitor\ParseInlineFqnNodeVisitor;
12 | use Jerowork\ClassDependenciesParser\PhpParser\NodeVisitor\ParseImportedFqnNodeVisitor;
13 | use Jerowork\ClassDependenciesParser\PhpParser\NodeVisitor\InlineFqnParser\Decliner\NamespaceDecliner;
14 | use Jerowork\ClassDependenciesParser\PhpParser\NodeVisitor\InlineFqnParser\Decliner\ImportedFqnDecliner;
15 | use Jerowork\ClassDependenciesParser\PhpParser\NodeVisitor\InlineFqnParser\Decliner\PhpNativeAccessorDecliner;
16 | use Jerowork\ClassDependenciesParser\PhpParser\NodeVisitor\InlineFqnParser\Processor\RootLevelFunctionProcessor;
17 | use Jerowork\ClassDependenciesParser\PhpParser\NodeVisitor\InlineFqnParser\Processor\FullyQualifiedNameProcessor;
18 | use Jerowork\ClassDependenciesParser\PhpParser\NodeVisitor\InlineFqnParser\Processor\InlineFqnIsImportedProcessor;
19 | use Jerowork\ClassDependenciesParser\PhpParser\NodeVisitor\InlineFqnParser\Processor\InlineFqnIsImportedAsAliasProcessor;
20 | use Jerowork\ClassDependenciesParser\PhpParser\NodeVisitor\InlineFqnParser\Processor\InlineFqnWithinSameNamespaceProcessor;
21 | 
22 | class NodeTraverserFactory
23 | {
24 |     public function createTraverser(array &$collectors): NodeTraverserInterface
25 |     {
26 |         $traverser = new NodeTraverser();
27 | 
28 |         $traverser->addVisitor(new ParentConnectingVisitor());
29 |         $traverser->addVisitor(new ParseClassFqnNodeVisitor($collectors['dependencies']));
30 |         $traverser->addVisitor(new ParseImportedFqnNodeVisitor($collectors['dependencies']));
31 |         $traverser->addVisitor(new DetectClassTypeVisitor($collectors['type']));
32 |         $traverser->addVisitor(new ParseInlineFqnNodeVisitor(
33 |             $collectors['dependencies'],
34 |             [
35 |                 new NamespaceDecliner(),
36 |                 new ImportedFqnDecliner(),
37 |                 new PhpNativeAccessorDecliner(),
38 |                 new NativeDecliner(),
39 |             ],
40 |             [
41 |                 new FullyQualifiedNameProcessor(),
42 |                 new RootLevelFunctionProcessor(),
43 |                 new InlineFqnIsImportedProcessor(),
44 |                 new InlineFqnIsImportedAsAliasProcessor(),
45 |                 new InlineFqnWithinSameNamespaceProcessor(),
46 |             ],
47 |         ));
48 | 
49 | 
50 |         return $traverser;
51 |     }
52 | }
53 | 


--------------------------------------------------------------------------------
/app/Infrastructure/Analyze/Adapters/Jerowork/Visitors/DetectClassTypeVisitor.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Infrastructure\Analyze\Adapters\Jerowork\Visitors;
 4 | 
 5 | use PhpParser\Node;
 6 | use PhpParser\Node\Stmt\Enum_;
 7 | use PhpParser\Node\Stmt\Class_;
 8 | use PhpParser\Node\Stmt\Trait_;
 9 | use PhpParser\NodeVisitorAbstract;
10 | use PhpParser\Node\Stmt\Interface_;
11 | use PhpParser\Node\Stmt\Namespace_;
12 | use App\Infrastructure\Analyze\Adapters\Jerowork\Collectors\ClassTypeCollector;
13 | 
14 | class DetectClassTypeVisitor extends NodeVisitorAbstract
15 | {
16 |     public ?string $namespace = null;
17 |     public ?string $className = null;
18 |     public ?bool $isAbstract = false;
19 |     public ?bool $isInterface = false;
20 | 
21 |     public function __construct(
22 |         private ClassTypeCollector $collector,
23 |     ) {}
24 | 
25 |     public function beforeTraverse(array $nodes): void
26 |     {
27 |         //
28 |     }
29 | 
30 |     public function enterNode(Node $node): void
31 |     {
32 |         if ($node instanceof Namespace_) {
33 |             $this->collector->namespace = (string) $node->name;
34 |         }
35 | 
36 |         if ($this->nodeAreClassOrEquivalent($node)) {
37 | 
38 |             $this->collector->className = (string) $node->name;
39 | 
40 |             if ($node instanceof Class_) {
41 |                 $this->collector->isAbstract = $node->isAbstract();
42 |             }
43 | 
44 |             $this->collector->isInterface = $node instanceof Interface_;
45 |         }
46 |     }
47 | 
48 |     public function leaveNode(Node $node): void
49 |     {
50 |         //
51 |     }
52 | 
53 |     private function nodeAreClassOrEquivalent(Node $node): bool
54 |     {
55 |         $parts = [Class_::class, Trait_::class, Interface_::class, Enum_::class];
56 | 
57 |         return in_array(get_class($node), $parts, true);
58 |     }
59 | }
60 | 


--------------------------------------------------------------------------------
/app/Infrastructure/Analyze/Adapters/Services/AnalyzerServiceAdapter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Infrastructure\Analyze\Adapters\Services;
 4 | 
 5 | use App\Domain\ValueObjects\Fqcn;
 6 | use App\Domain\ValueObjects\IsAbstract;
 7 | use App\Infrastructure\File\Ports\File;
 8 | use App\Domain\ValueObjects\IsInterface;
 9 | use App\Domain\ValueObjects\Dependencies;
10 | use App\Domain\Entities\ClassDependencies;
11 | use App\Infrastructure\Analyze\Ports\AnalyzerService;
12 | use App\Infrastructure\Analyze\Ports\ClassDependenciesParser;
13 | 
14 | class AnalyzerServiceAdapter implements AnalyzerService
15 | {
16 |     public function __construct(
17 |         private ClassDependenciesParser $classDependenciesParser,
18 |     ) {}
19 | 
20 |     public function getDependencies(File $file): ClassDependencies
21 |     {
22 |         $classAnalysis = $this->classDependenciesParser->parse($file->fullPath());
23 | 
24 |         return new ClassDependencies(
25 |             fqcn: Fqcn::fromString($classAnalysis->fqcn()),
26 |             dependencies: Dependencies::fromArray($classAnalysis->dependencies()),
27 |             isInterface: IsInterface::fromBool($classAnalysis->isInterface()),
28 |             isAbstract: IsAbstract::fromBool($classAnalysis->isAbstract()),
29 |         );
30 |     }
31 | }
32 | 


--------------------------------------------------------------------------------
/app/Infrastructure/Analyze/Ports/AnalyzerService.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Infrastructure\Analyze\Ports;
 4 | 
 5 | use App\Infrastructure\File\Ports\File;
 6 | use App\Domain\Entities\ClassDependencies;
 7 | 
 8 | interface AnalyzerService
 9 | {
10 |     public function getDependencies(File $file): ClassDependencies;
11 | }
12 | 


--------------------------------------------------------------------------------
/app/Infrastructure/Analyze/Ports/ClassAnalysis.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Infrastructure\Analyze\Ports;
 4 | 
 5 | interface ClassAnalysis
 6 | {
 7 |     public function fqcn(): string;
 8 |     public function dependencies(): array;
 9 |     public function isInterface(): bool;
10 |     public function isAbstract(): bool;
11 | }
12 | 


--------------------------------------------------------------------------------
/app/Infrastructure/Analyze/Ports/ClassDependenciesParser.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Infrastructure\Analyze\Ports;
 4 | 
 5 | use App\Infrastructure\Analyze\Ports\ClassAnalysis;
 6 | 
 7 | interface ClassDependenciesParser
 8 | {
 9 |     public function parse(string $file): ClassAnalysis;
10 | }
11 | 


--------------------------------------------------------------------------------
/app/Infrastructure/File/Adapters/Aggregators/FileAggregatorAdapter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Infrastructure\File\Adapters\Aggregators;
 4 | 
 5 | use Generator;
 6 | use App\Domain\Aggregators\DependencyAggregator;
 7 | use App\Domain\Ports\Aggregators\FileAggregator;
 8 | use App\Infrastructure\Analyze\Ports\AnalyzerService;
 9 | use App\Infrastructure\File\Adapters\DataTransferObjects\FileAdapter;
10 | 
11 | class FileAggregatorAdapter implements FileAggregator
12 | {
13 |     private Generator $files;
14 | 
15 |     public function __construct(
16 |         private AnalyzerService $analyzerService,
17 |         private DependencyAggregator $dependencyAggregator,
18 |     ) {}
19 | 
20 |     public function aggregate(Generator $files): void
21 |     {
22 |         $this->files = $files;
23 |     }
24 | 
25 |     public function getAllDependencies(): DependencyAggregator
26 |     {
27 |         foreach ($this->files as $file) {
28 | 
29 |             $classCoupling = $this->analyzerService->getDependencies(
30 |                 new FileAdapter($file),
31 |             );
32 | 
33 |             $this->dependencyAggregator->aggregate($classCoupling);
34 |         }
35 | 
36 |         return $this->dependencyAggregator;
37 |     }
38 | }
39 | 


--------------------------------------------------------------------------------
/app/Infrastructure/File/Adapters/DataTransferObjects/FileAdapter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Infrastructure\File\Adapters\DataTransferObjects;
 4 | 
 5 | use App\Infrastructure\File\Ports\File;
 6 | use DeGraciaMathieu\FileExplorer\File as FileExplorer;
 7 | 
 8 | class FileAdapter implements File
 9 | {
10 |     public function __construct(
11 |         private FileExplorer $file,
12 |     ) {}
13 | 
14 |     public function fullPath(): string
15 |     {
16 |         return $this->file->fullPath;
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/app/Infrastructure/File/Adapters/Repositories/FileRepositoryAdapter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Infrastructure\File\Adapters\Repositories;
 4 | 
 5 | use DeGraciaMathieu\FileExplorer\FileFinder;
 6 | use App\Domain\Ports\Aggregators\FileAggregator;
 7 | use App\Domain\Ports\Repositories\FileRepository;
 8 | 
 9 | class FileRepositoryAdapter implements FileRepository
10 | {
11 |     public function __construct(
12 |         private FileAggregator $fileAggregator,
13 |     ) {}
14 | 
15 |     public function find(string $path): FileAggregator
16 |     {
17 |         $fileFinder = new FileFinder(
18 |             basePath: getcwd(),
19 |         );
20 | 
21 |         $files = $fileFinder->getFiles($path);
22 | 
23 |         $this->fileAggregator->aggregate($files);
24 | 
25 |         return $this->fileAggregator;
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/app/Infrastructure/File/Ports/File.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | namespace App\Infrastructure\File\Ports;
4 | 
5 | interface File
6 | {
7 |     public function fullPath(): string;
8 | }
9 | 


--------------------------------------------------------------------------------
/app/Infrastructure/Graph/Adapters/Cytoscape/CytoscapeNetwork.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Infrastructure\Graph\Adapters\Cytoscape;
 4 | 
 5 | use App\Presenter\Analyze\Shared\Network\Network;
 6 | use App\Infrastructure\Graph\Adapters\Cytoscape\Edges;
 7 | use App\Infrastructure\Graph\Adapters\Cytoscape\Nodes;
 8 | 
 9 | class CytoscapeNetwork implements Network
10 | {
11 |     public function __construct(
12 |         private Nodes $nodes,
13 |         private Edges $edges,
14 |     ) {}
15 | 
16 |     public function addNode(string $name, float $instability = 0): void
17 |     {
18 |         $this->nodes->add($name, $instability);
19 |     }
20 | 
21 |     public function countNodes(): int
22 |     {
23 |         return $this->nodes->count();
24 |     }
25 | 
26 |     public function missingNode(string $name): bool
27 |     {
28 |         return $this->nodes->miss($name);
29 |     }
30 | 
31 |     public function addEdge(string $source, string $target): void
32 |     {
33 |         $this->edges->add($source, $target);
34 |     }
35 | 
36 |     public function nodes(): array
37 |     {
38 |         return $this->nodes->toArray();
39 |     }
40 | 
41 |     public function edges(): array
42 |     {
43 |         return $this->edges->toArray();
44 |     }
45 | }
46 | 


--------------------------------------------------------------------------------
/app/Infrastructure/Graph/Adapters/Cytoscape/CytoscapeNetworkBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Infrastructure\Graph\Adapters\Cytoscape;
 4 | 
 5 | use App\Presenter\Analyze\Shared\Network\Network;
 6 | use App\Presenter\Analyze\Shared\Network\NetworkBuilder;
 7 | use App\Infrastructure\Graph\Adapters\Cytoscape\CytoscapeNetwork;
 8 | use App\Presenter\Analyze\Shared\Network\NetworkAttribute;
 9 | 
10 | class CytoscapeNetworkBuilder implements NetworkBuilder
11 | {
12 |     public function __construct(
13 |         private readonly CytoscapeNetwork $network,
14 |     ) {}
15 |         
16 |     public function build(array $metrics): Network
17 |     {
18 |         $this->mapNodes($metrics);
19 |         $this->mapEdges($metrics);
20 | 
21 |         return $this->network;
22 |     }
23 | 
24 |     private function mapNodes(array $metrics): void
25 |     {
26 |         foreach ($metrics as $item) {
27 |             $this->network->addNode($item->name(), $item->instability());
28 |         }
29 |     }
30 | 
31 |     private function mapEdges(array $metrics): void
32 |     {
33 |         foreach ($metrics as $item) {
34 | 
35 |             foreach ($item->dependencies() as $dependency) {
36 | 
37 |                 if ($this->isSelfDependency($dependency, $item)) {
38 |                     continue;
39 |                 }
40 | 
41 |                 if ($this->network->missingNode($dependency)) {
42 |                     $this->network->addNode($dependency);
43 |                 }
44 | 
45 |                 $this->network->addEdge(source: $item->name(), target: $dependency);
46 |             }
47 |         }
48 |     }
49 | 
50 |     /**
51 |      * We remove self dependency from graph for readability reasons
52 |      */
53 |     private function isSelfDependency(string $dependency, NetworkAttribute $item): bool
54 |     {
55 |         return $dependency === $item->name();
56 |     }
57 | }
58 | 


--------------------------------------------------------------------------------
/app/Infrastructure/Graph/Adapters/Cytoscape/Edges.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Infrastructure\Graph\Adapters\Cytoscape;
 4 | 
 5 | class Edges
 6 | {
 7 |     public function __construct(
 8 |         private array $edges = [],
 9 |     ) {}
10 | 
11 |     public function add(string $source, string $target): void
12 |     {
13 |         $this->edges[] = [
14 |             'data' => [
15 |                 'source' => $source,
16 |                 'target' => $target,
17 |             ],
18 |         ];
19 |     }
20 | 
21 |     public function toArray(): array
22 |     {
23 |         return $this->edges;
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/app/Infrastructure/Graph/Adapters/Cytoscape/Nodes.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Infrastructure\Graph\Adapters\Cytoscape;
 4 | 
 5 | class Nodes
 6 | {
 7 |     public function __construct(
 8 |         private array $nodes = [],
 9 |         private array $nodeNames = [],
10 |     ) {}
11 | 
12 |     public function add(string $name, float $instability): void
13 |     {
14 |         $this->nodeNames[] = $name;
15 | 
16 |         $this->nodes[] = [
17 |             'data' => [
18 |                 'id' => $name,
19 |                 'instability' => $instability,
20 |             ],
21 |         ];
22 |     }
23 | 
24 |     public function miss(string $name): bool
25 |     {
26 |         return ! in_array($name, $this->nodeNames, true);
27 |     }
28 | 
29 |     public function count(): int
30 |     {
31 |         return count($this->nodes);
32 |     }
33 | 
34 |     public function toArray(): array
35 |     {
36 |         return $this->nodes;
37 |     }
38 | }
39 | 


--------------------------------------------------------------------------------
/app/Infrastructure/Views/Adapters/SystemFileLauncherAdapter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Infrastructure\Views\Adapters;
 4 | 
 5 | use App\Presenter\Analyze\Shared\Views\SystemFileLauncher;
 6 | 
 7 | class SystemFileLauncherAdapter implements SystemFileLauncher
 8 | {
 9 |     private string $file = 'graph.html';
10 | 
11 |     public function open(): void
12 |     {
13 |         $command = $this->getExecCommand();
14 | 
15 |         exec("$command $this->file");
16 |     }
17 | 
18 |     public function save(string $html): void
19 |     {
20 |         file_put_contents('graph.html', $html);
21 |     }
22 | 
23 |     private function getExecCommand(): string
24 |     {
25 |         return match (PHP_OS_FAMILY) {
26 |             'Windows' => 'start',
27 |             'Darwin' => 'open',
28 |             default => 'xdg-open',
29 |         };
30 |     }
31 | }
32 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Class/Graph/GraphEnums.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | namespace App\Presenter\Analyze\Class\Graph;
4 | 
5 | enum GraphEnums: int
6 | {
7 |     case READABILITY_THRESHOLD = 20;
8 | }
9 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Class/Graph/GraphMapper.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Class\Graph;
 4 | 
 5 | use App\Application\Analyze\AnalyzeMetric;
 6 | use App\Presenter\Analyze\Shared\Network\Network;
 7 | use App\Presenter\Analyze\Class\Shared\MetricMapper;
 8 | use App\Presenter\Analyze\Shared\Network\NetworkBuilder;
 9 | use App\Presenter\Analyze\Shared\Network\NetworkAttributesMapper;
10 | 
11 | class GraphMapper
12 | {
13 |     public function __construct(
14 |         private readonly MetricMapper $metricMapper,
15 |         private readonly NetworkAttributesMapper $networkAttributesMapper,
16 |         private readonly NetworkBuilder $networkBuilder,
17 |     ) {}
18 | 
19 |     /**
20 |      * @param array<AnalyzeMetric> $metrics
21 |      */
22 |     public function from(array $metrics): Network
23 |     {
24 |         $metrics = $this->metricMapper->from($metrics);
25 | 
26 |         $networkAttributes = $this->networkAttributesMapper->map($metrics);
27 | 
28 |         $network = $this->networkBuilder->build($networkAttributes);
29 | 
30 |         return $network;
31 |     }
32 | }
33 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Class/Graph/GraphPresenter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Class\Graph;
 4 | 
 5 | use Throwable;
 6 | use function Laravel\Prompts\info;
 7 | use function Laravel\Prompts\alert;
 8 | use App\Application\Analyze\AnalyzeResponse;
 9 | use App\Application\Analyze\AnalyzePresenter;
10 | use App\Presenter\Analyze\Class\Graph\GraphMapper;
11 | use App\Presenter\Analyze\Class\Graph\GraphSettings;
12 | use App\Presenter\Analyze\Class\Graph\GraphViewModel;
13 | use App\Presenter\Analyze\Shared\Filters\Contracts\Transformer;
14 | 
15 | class GraphPresenter implements AnalyzePresenter
16 | {
17 |     public function __construct(
18 |         private readonly GraphSettings $settings,
19 |         private readonly Transformer $transformer,
20 |         private readonly GraphMapper $mapper,
21 |         private readonly GraphView $view,
22 |     ) {}
23 | 
24 |     public function hello(): void
25 |     {
26 |         info('❀ PHP Class Dependencies Analyzer ❀');
27 | 
28 |         info('Analyze in progress...');
29 |     }
30 | 
31 |     public function error(Throwable $e): void
32 |     {
33 |         alert('sorry, something went wrong');
34 | 
35 |         if ($this->settings->debug) {
36 |             alert($e);
37 |         }
38 | 
39 |         alert($e->getMessage());
40 |     }
41 | 
42 |     public function present(AnalyzeResponse $response): void
43 |     {
44 |         $metrics = $response->metrics;
45 | 
46 |         $metrics = $this->transformer->apply($metrics);
47 | 
48 |         $network = $this->mapper->from($metrics);
49 | 
50 |         $this->view->show(new GraphViewModel($network));
51 |     }
52 | }
53 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Class/Graph/GraphSettings.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Class\Graph;
 4 | 
 5 | class GraphSettings
 6 | {
 7 |     public function __construct(
 8 |         public readonly bool $debug = false,
 9 |         public readonly ?string $target = null,
10 |     ) {}
11 | }
12 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Class/Graph/GraphView.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Class\Graph;
 4 | 
 5 | use function Laravel\Prompts\info;
 6 | use function Laravel\Prompts\outro;
 7 | use Illuminate\View\Factory as View;
 8 | use App\Presenter\Analyze\Class\Graph\GraphViewModel;
 9 | use App\Presenter\Analyze\Shared\Views\SystemFileLauncher;
10 | 
11 | class GraphView
12 | {
13 |     public function __construct(
14 |         private readonly View $view,
15 |         private readonly SystemFileLauncher $systemFileLauncher,
16 |     ) {}
17 | 
18 |     public function show(GraphViewModel $viewModel): void
19 |     {
20 |         $html = $this->render($viewModel);
21 | 
22 |         $this->save($html);
23 | 
24 |         $this->open();
25 | 
26 |         $this->showInfo($viewModel);
27 |     }
28 | 
29 |     private function render(GraphViewModel $viewModel): string
30 |     {
31 |         $view = $this->view->make('class-graph', [
32 |             'nodes' => $viewModel->nodes(),
33 |             'edges' => $viewModel->edges(),
34 |         ]);
35 | 
36 |         return $view->render();
37 |     }
38 | 
39 |     private function open(): void
40 |     {
41 |         $this->systemFileLauncher->open();
42 |     }
43 | 
44 |     private function save(string $html): void
45 |     {
46 |         $this->systemFileLauncher->save($html);
47 |     }
48 | 
49 |     private function showInfo(GraphViewModel $viewModel): void
50 |     {
51 |         info('Graph successfully generated in graph.html');
52 | 
53 |         if ($viewModel->hasManyNodes()) {
54 |             outro('Graph is quickly bloated with many dependencies, do not hesitate to use the --only= and --exclude= options for better readability');
55 |             outro('See the documentation for more information : https://php-quality-tools.com/class-dependencies-analyzer');
56 |         }
57 |     }
58 | }
59 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Class/Graph/GraphViewModel.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Class\Graph;
 4 | 
 5 | use App\Presenter\Analyze\Class\Graph\GraphEnums;
 6 | use App\Presenter\Analyze\Shared\Network\Network;
 7 | 
 8 | class GraphViewModel
 9 | {
10 |     public function __construct(
11 |         public readonly Network $network,
12 |     ) {}
13 | 
14 |     public function hasManyNodes(): bool
15 |     {
16 |         return $this->network->countNodes() > GraphEnums::READABILITY_THRESHOLD->value;
17 |     }
18 | 
19 |     public function nodes(): array
20 |     {
21 |         return $this->network->nodes();
22 |     }
23 | 
24 |     public function edges(): array
25 |     {
26 |         return $this->network->edges();
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Class/Shared/Metric.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Class\Shared;
 4 | 
 5 | use App\Presenter\Analyze\Shared\Network\Networkable;
 6 | 
 7 | class Metric implements Networkable
 8 | {
 9 |     public function __construct(
10 |         private string $name,
11 |         private float $instability,
12 |         private array $dependencies,
13 |     ) {}
14 | 
15 |     public function name(): string
16 |     {
17 |         return $this->name;
18 |     }
19 | 
20 |     public function instability(): float
21 |     {
22 |         return $this->instability;
23 |     }
24 | 
25 |     public function dependencies(): array
26 |     {
27 |         return $this->dependencies;
28 |     }
29 | }


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Class/Shared/MetricMapper.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Class\Shared;
 4 | 
 5 | use App\Application\Analyze\AnalyzeMetric;
 6 |     
 7 | class MetricMapper
 8 | {
 9 |     public function from(array $metrics): array
10 |     {
11 |         return array_map(function (AnalyzeMetric $metric) {
12 |             return $this->makeClass($metric);
13 |         }, $metrics);
14 |     }
15 | 
16 |     private function makeClass(AnalyzeMetric $metric): Metric
17 |     {
18 |         return new Metric(
19 |             name: $metric->name(),
20 |             instability: $metric->instability(),
21 |             dependencies: $metric->dependencies(),
22 |         );
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Class/Summary/SummaryMapper.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Class\Summary;
 4 | 
 5 | use App\Application\Analyze\AnalyzeMetric;
 6 | use App\Presenter\Analyze\Shared\Calculators\StabilityCalculator;
 7 | use App\Presenter\Analyze\Shared\Calculators\AbstractnessCalculator;
 8 | use App\Presenter\Analyze\Shared\Calculators\MaintainabilityCalculator;
 9 | 
10 | class SummaryMapper
11 | {
12 |     public static function from(array $metrics, bool $humanReadable = false): array
13 |     {
14 |         return $humanReadable
15 |             ? self::formatHumanReadableMetrics($metrics)
16 |             : self::formatMetrics($metrics);
17 |     }
18 | 
19 |     private static function formatMetrics(array $metrics): array
20 |     {
21 |         return array_map(function (AnalyzeMetric $metric) {
22 |             return [
23 |                 'name' => $metric->name(),
24 |                 'Ec' => $metric->efferentCoupling(),
25 |                 'Ac' => $metric->afferentCoupling(),
26 |                 'I' => $metric->instability(),
27 |                 'Na' => $metric->numberOfAbstractDependencies(),
28 |                 'A' => $metric->abstractnessRatio(),
29 |             ];
30 |         }, $metrics);
31 |     }
32 | 
33 |     private static function formatHumanReadableMetrics(array $metrics): array
34 |     {
35 |         return array_map(function ($metric) {
36 |             return [
37 |                 'name' => $metric->name(),
38 |                 'stability' => StabilityCalculator::calculate($metric),
39 |                 'abstractness' => AbstractnessCalculator::calculate($metric),
40 |                 'maintainability' => MaintainabilityCalculator::calculate($metric),
41 |             ];
42 |         }, $metrics);
43 |     }
44 | }
45 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Class/Summary/SummaryPresenter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Class\Summary;
 4 | 
 5 | use Throwable;
 6 | use function Laravel\Prompts\info;
 7 | use function Laravel\Prompts\alert;
 8 | use App\Application\Analyze\AnalyzeResponse;
 9 | use App\Application\Analyze\AnalyzePresenter;
10 | use App\Presenter\Analyze\Class\Summary\SummaryView;
11 | use App\Presenter\Analyze\Class\Summary\SummaryMapper;
12 | use App\Presenter\Analyze\Class\Summary\SummarySettings;
13 | use App\Presenter\Analyze\Class\Summary\SummaryViewModel;
14 | use App\Presenter\Analyze\Shared\Filters\Contracts\Transformer;
15 | 
16 | class SummaryPresenter implements AnalyzePresenter
17 | {
18 |     public function __construct(
19 |         private readonly SummaryView $view,
20 |         private readonly SummaryMapper $mapper,
21 |         private readonly Transformer $transformer,
22 |         private readonly SummarySettings $settings,
23 |     ) {}
24 | 
25 |     public function hello(): void
26 |     {
27 |         info('❀ PHP Class Dependencies Analyzer ❀');
28 | 
29 |         info('Analyze in progress...');
30 |     }
31 | 
32 |     public function error(Throwable $e): void
33 |     {
34 |         if ($this->settings->debug) {
35 |             alert($e);
36 |         }
37 | 
38 |         alert($e->getMessage());
39 |     }
40 | 
41 |     public function present(AnalyzeResponse $response): void
42 |     {
43 |         $metrics = $response->metrics;
44 | 
45 |         $metrics = $this->transformer->apply($metrics);
46 | 
47 |         $metrics = $this->mapper->from($metrics, $this->settings->humanReadable);
48 | 
49 |         $viewModel = new SummaryViewModel($metrics, $response->count, $this->settings);
50 | 
51 |         $this->view->show($viewModel);
52 |     }
53 | }
54 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Class/Summary/SummarySettings.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Class\Summary;
 4 | 
 5 | class SummarySettings
 6 | {
 7 |     public function __construct(
 8 |         public readonly bool $debug = false,
 9 |         public readonly ?string $target = null,
10 |         public readonly bool $info = false,
11 |         public readonly bool $humanReadable = false,
12 |     ) {}
13 | }
14 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Class/Summary/SummaryView.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Class\Summary;
 4 | 
 5 | use function Laravel\Prompts\outro;
 6 | use function Laravel\Prompts\table;
 7 | use function Laravel\Prompts\warning;
 8 | use App\Presenter\Analyze\Class\Summary\SummaryViewModel;
 9 | 
10 | class SummaryView
11 | {
12 |     public function show(SummaryViewModel $viewModel): void
13 |     {
14 |         $this->displayMetrics($viewModel);
15 |         $this->displayInfo($viewModel);
16 |     }
17 | 
18 |     private function displayMetrics(SummaryViewModel $viewModel): void
19 |     {
20 |         $viewModel->hasMetrics()
21 |             ? $this->showMetrics($viewModel)
22 |             : warning('No classes found');
23 |     }
24 | 
25 |     private function showMetrics(SummaryViewModel $viewModel): void
26 |     {
27 |         table(
28 |             headers: $viewModel->headers(),
29 |             rows: $viewModel->metrics(),
30 |         );
31 |     }
32 | 
33 |     private function displayInfo(SummaryViewModel $viewModel): void
34 |     {
35 |         $viewModel->needInfo()
36 |             ? $this->showInfo($viewModel)
37 |             : $this->showOutro($viewModel);
38 |     }
39 | 
40 |     private function showInfo(SummaryViewModel $viewModel): void
41 |     {
42 |         $viewModel->isHumanReadable()
43 |             ? $this->showHumanReadableInfo()
44 |             : $this->showMetricsInfo();
45 |     }
46 | 
47 |     private function showHumanReadableInfo(): void
48 |     {
49 |         outro('A stable and concrete class is heavily used by the application and has few abstractions.');
50 |         outro('It is probably not open to extension and it will be necessary to modify it to add behaviors.');
51 |         outro('This class has a risky maintainability because a modification will impact many classes.');
52 | 
53 |         outro('An unstable and concrete class uses many concrete dependencies, without going through abstractions, making it harder to test.');
54 |         outro('This class has a suffering maintainability because it will suffer from side effects of its dependencies.');
55 |         
56 |         outro('For more information, see the documentation: https://php-quality-tools.com/class-dependencies-analyzer');
57 |     }
58 | 
59 |     private function showMetricsInfo(): void
60 |     {
61 |         table(
62 |             headers: ['Metric', 'Description'],
63 |             rows: [
64 |                 ['Ac (Afferent Coupling)', 'number of classes that depend on the class.'],
65 |                 ['Ec (Efferent Coupling)', 'number of classes that the class depends on.'],
66 |                 ['I (Instability)', 'instability of the class.'],
67 |                 ['Na (Number of abstractions)', 'number of abstractions (interface, abstract class) contained in the class.'],
68 |                 ['A (Abstractness)', 'ratio of abstractions to the total number of methods in the class.'],
69 |             ],
70 |         );
71 | 
72 |         outro('Class with a low instability (I close to 0) is strongly used and probably critical for the application, its business logic must be tested.');
73 |         outro('Class with a high instability (I close to 1) can suffer from side effects of its dependencies and must favor abstractions.');
74 |         outro('Class with a high abstractness (A close to 1) is totally abstract and should not have any concrete code.');
75 |         outro('Try --human-readable to get a more human readable output.');
76 |         outro('See the documentation for more information : https://php-quality-tools.com/class-dependencies-analyzer');
77 |     }
78 | 
79 |     private function showOutro(SummaryViewModel $viewModel): void
80 |     {
81 |         outro('Add --info to get more information on metrics.');
82 |         outro(sprintf('Found %d classes in the given path', $viewModel->count()));
83 |     }
84 | }
85 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Class/Summary/SummaryViewModel.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Class\Summary;
 4 | 
 5 | use App\Presenter\Analyze\Class\Summary\SummarySettings;
 6 | 
 7 | class SummaryViewModel
 8 | {
 9 |     public function __construct(
10 |         private readonly array $metrics,
11 |         private readonly int $count,
12 |         private readonly SummarySettings $settings,
13 |     ) {}
14 | 
15 |     public function headers(): array
16 |     {
17 |         $metrics = array_values($this->metrics);
18 | 
19 |         return array_keys($metrics[0]);
20 |     }
21 | 
22 |     public function isHumanReadable(): bool
23 |     {
24 |         return $this->settings->humanReadable;
25 |     }
26 | 
27 |     public function needInfo(): bool
28 |     {
29 |         return $this->settings->info;
30 |     }
31 | 
32 |     public function metrics(): array
33 |     {
34 |         return $this->metrics;
35 |     }
36 | 
37 |     public function count(): int
38 |     {
39 |         return $this->count;
40 |     }
41 | 
42 |     public function hasMetrics(): bool
43 |     {
44 |         return count($this->metrics) > 0;
45 |     }
46 | }
47 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Component/Graph/GraphMapper.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Component\Graph;
 4 | 
 5 | use App\Presenter\Analyze\Shared\Network\Network;
 6 | use App\Presenter\Analyze\Shared\Network\NetworkBuilder;
 7 | use App\Presenter\Analyze\Component\Shared\ComponentMapper;
 8 | use App\Presenter\Analyze\Shared\Network\NetworkAttributesMapper;
 9 | 
10 | class GraphMapper 
11 | {
12 |     public function __construct(
13 |         private readonly ComponentMapper $componentMapper,
14 |         private readonly NetworkAttributesMapper $networkAttributesMapper,
15 |         private readonly NetworkBuilder $networkBuilder,
16 |     ) {}
17 | 
18 |     public function from(array $metrics): Network
19 |     {
20 |         $components = $this->componentMapper->from($metrics);
21 | 
22 |         $networkAttributes = $this->networkAttributesMapper->map($components);
23 | 
24 |         return $this->networkBuilder->build($networkAttributes);
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Component/Graph/GraphPresenter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Component\Graph;
 4 | 
 5 | use Throwable;
 6 | use function Laravel\Prompts\info;
 7 | use function Laravel\Prompts\alert;
 8 | use App\Application\Analyze\AnalyzeResponse;
 9 | use App\Application\Analyze\AnalyzePresenter;
10 | use App\Presenter\Analyze\Component\Graph\GraphView;
11 | use App\Presenter\Analyze\Component\Graph\GraphSettings;
12 | use App\Presenter\Analyze\Component\Graph\GraphViewModel;
13 | use App\Presenter\Analyze\Component\Graph\GraphMapper;
14 | use App\Presenter\Analyze\Shared\Filters\Contracts\Transformer;
15 | 
16 | class GraphPresenter implements AnalyzePresenter
17 | {
18 |     public function __construct(
19 |         private readonly GraphView $view,
20 |         private readonly GraphMapper $mapper,
21 |         private readonly Transformer $transformer,
22 |         private readonly GraphSettings $settings,
23 |     ) {}
24 | 
25 |     public function hello(): void
26 |     {
27 |         info('❀ PHP Class Dependencies Analyzer ❀');
28 | 
29 |         info('Analyze in progress...');
30 |     }
31 | 
32 |     public function error(Throwable $e): void
33 |     {
34 |         alert('sorry, something went wrong');
35 | 
36 |         if ($this->settings->debug) {
37 |             alert($e);
38 |         }
39 | 
40 |         alert($e->getMessage());
41 |     }
42 | 
43 |     public function present(AnalyzeResponse $response): void
44 |     {
45 |         $metrics = $response->metrics;
46 | 
47 |         $metrics = $this->transformer->apply($metrics);
48 | 
49 |         $network = $this->mapper->from($metrics);
50 | 
51 |         $this->view->show(new GraphViewModel($network));
52 |     }
53 | }
54 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Component/Graph/GraphSettings.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Component\Graph;
 4 | 
 5 | class GraphSettings
 6 | {
 7 |     public function __construct(
 8 |         public readonly array $components = [],
 9 |         public readonly bool $debug = false,
10 |         public readonly bool $info = false,
11 |     ) {}
12 | }
13 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Component/Graph/GraphView.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Component\Graph;
 4 | 
 5 | use function Laravel\Prompts\info;
 6 | use Illuminate\View\Factory as View;
 7 | use App\Presenter\Analyze\Component\Graph\GraphViewModel;
 8 | use App\Presenter\Analyze\Shared\Views\SystemFileLauncher;
 9 | 
10 | class GraphView
11 | {
12 |     public function __construct(
13 |         private readonly View $view,
14 |         private readonly SystemFileLauncher $systemFileLauncher,
15 |     ) {}
16 | 
17 |     public function show(GraphViewModel $viewModel): void
18 |     {
19 |         $html = $this->render($viewModel);
20 | 
21 |         $this->save($html);
22 | 
23 |         $this->open();
24 | 
25 |         $this->showInfo($viewModel);
26 |     }
27 | 
28 |     private function render(GraphViewModel $viewModel): string
29 |     {
30 |         $view = $this->view->make('components-graph', [
31 |             'nodes' => $viewModel->nodes(),
32 |             'edges' => $viewModel->edges(),
33 |         ]);
34 | 
35 |         return $view->render();
36 |     }
37 | 
38 |     private function open(): void
39 |     {
40 |         $this->systemFileLauncher->open();
41 |     }
42 | 
43 |     private function save(string $html): void
44 |     {
45 |         $this->systemFileLauncher->save($html);
46 |     }
47 | 
48 |     private function showInfo(GraphViewModel $viewModel): void
49 |     {
50 |         info('Graph successfully generated in graph.html');
51 |     }
52 | }
53 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Component/Graph/GraphViewModel.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Component\Graph;
 4 | 
 5 | use App\Presenter\Analyze\Shared\Network\Network;
 6 | 
 7 | class GraphViewModel
 8 | {
 9 |     public function __construct(
10 |         public readonly Network $network,
11 |     ) {}
12 | 
13 |     public function nodes(): array
14 |     {
15 |         return $this->network->nodes();
16 |     }
17 | 
18 |     public function edges(): array
19 |     {
20 |         return $this->network->edges();
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Component/Shared/Collector.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Component\Shared;
 4 | 
 5 | use App\Application\Analyze\AnalyzeMetric;
 6 | 
 7 | class Collector
 8 | {
 9 |     public string $name;
10 |     public float $totalInstability = 0;
11 |     public int $countAbstractions = 0;
12 |     public int $countClasses = 0;
13 |     public array $dependencies = [];
14 | 
15 |     public function setName(string $name): void
16 |     {
17 |         $this->name = $name;
18 |     }
19 | 
20 |     public function collect(AnalyzeMetric $metric): void
21 |     {
22 |         $this->totalInstability += $metric->instability();
23 | 
24 |         if ($metric->abstract()) {
25 |             $this->countAbstractions++;
26 |         }
27 | 
28 |         $this->countClasses++;
29 |     }
30 | 
31 |     public function addDependency(string $dependency): void
32 |     {
33 |         $this->dependencies[] = $dependency;
34 |     }
35 | 
36 |     public function hasDependency(string $dependency): bool
37 |     {
38 |         return in_array($dependency, $this->dependencies, true);
39 |     }
40 | }
41 |     


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Component/Shared/Component.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Component\Shared;
 4 | 
 5 | use App\Presenter\Analyze\Shared\Network\Networkable;
 6 | 
 7 | class Component implements Networkable
 8 | {
 9 |     public function __construct(
10 |         public readonly string $name,   
11 |         public readonly int $countClasses,  
12 |         public readonly int $countAbstractions,  
13 |         public readonly float $totalInstability,  
14 |         public readonly array $dependencies,   
15 |     ) {}
16 | 
17 |     public function name(): string
18 |     {
19 |         return $this->name;
20 |     }
21 | 
22 |     public function countClasses(): int
23 |     {
24 |         return $this->countClasses;
25 |     }
26 | 
27 |     public function countAbstractions(): int
28 |     {
29 |         return $this->countAbstractions;
30 |     }
31 | 
32 |     public function abstractness(): float
33 |     {
34 |         return number_format($this->countAbstractions / $this->countClasses, 2);
35 |     }
36 | 
37 |     public function instability(): float
38 |     {
39 |         return number_format($this->totalInstability / $this->countClasses, 2);
40 |     }
41 | 
42 |     public function dependencies(): array
43 |     {
44 |         return $this->dependencies;
45 |     }
46 | }
47 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Component/Shared/ComponentFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Component\Shared;
 4 | 
 5 | class ComponentFactory
 6 | {
 7 |     public function make(Collector $collector): Component
 8 |     {
 9 |         return new Component(
10 |             name: $collector->name,
11 |             countClasses: $collector->countClasses,
12 |             countAbstractions: $collector->countAbstractions,
13 |             totalInstability: $collector->totalInstability,
14 |             dependencies: $collector->dependencies,
15 |         );
16 |     }
17 | }
18 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Component/Shared/ComponentMapper.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Component\Shared;
 4 | 
 5 | use Illuminate\Support\Str;
 6 | 
 7 | class ComponentMapper
 8 | {
 9 |     public function __construct(
10 |         private readonly ComponentFactory $componentFactory,
11 |     ) {}
12 | 
13 |     /**
14 |      * @var array<string, array<AnalyzeMetric>> $metrics
15 |      */
16 |     public function from(array $metrics): array
17 |     {
18 |         $components = array_keys($metrics);
19 | 
20 |         $items = [];
21 | 
22 |         foreach ($metrics as $component => $componentMetrics) {
23 | 
24 |             $collector = new Collector();
25 | 
26 |             $collector->setName($component);
27 | 
28 |             foreach ($componentMetrics as $metric) {
29 | 
30 |                 $collector->collect($metric);
31 | 
32 |                 foreach ($metric->dependencies() as $dependency) {
33 | 
34 |                     foreach ($components as $otherComponent) {
35 | 
36 |                         if (Str::startsWith($dependency, $otherComponent)) {
37 | 
38 |                             if ($otherComponent === $component) {
39 |                                 continue;
40 |                             }
41 | 
42 |                             if (! $collector->hasDependency($otherComponent)) {
43 |                                 $collector->addDependency($otherComponent);
44 |                             }
45 |                         }
46 |                     }
47 |                 }
48 |             }
49 | 
50 |             $items[] = $this->componentFactory->make($collector);
51 |         }
52 | 
53 |         return $items;
54 |     }
55 | } 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Component/Summary/SummaryMapper.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Component\Summary;
 4 | 
 5 | use App\Presenter\Analyze\Component\Shared\ComponentMapper;
 6 | 
 7 | class SummaryMapper 
 8 | {
 9 |     public function __construct(
10 |         private readonly ComponentMapper $componentMapper,
11 |     ) {}
12 | 
13 |     public function from(array $metrics): array
14 |     {
15 |         $components = $this->componentMapper->from($metrics);
16 | 
17 |         return $this->format($components);
18 |     }
19 | 
20 |     private function format(array $components): array
21 |     {
22 |         return array_map(function ($component) {
23 |             return [
24 |                 'name' => $component->name(),
25 |                 'Nc' => $component->countClasses(),
26 |                 'Na' => $component->countAbstractions(),
27 |                 'A' => $component->abstractness(),
28 |                 'I' => $component->instability(),
29 |             ];
30 |         }, $components);
31 |     }
32 | }
33 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Component/Summary/SummaryPresenter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Component\Summary;
 4 | 
 5 | use Throwable;
 6 | use function Laravel\Prompts\info;
 7 | use function Laravel\Prompts\alert;
 8 | use App\Application\Analyze\AnalyzeResponse;
 9 | use App\Application\Analyze\AnalyzePresenter;
10 | use App\Presenter\Analyze\Component\Summary\SummaryView;
11 | use App\Presenter\Analyze\Component\Summary\SummaryMapper;
12 | use App\Presenter\Analyze\Component\Summary\SummarySettings;
13 | use App\Presenter\Analyze\Shared\Filters\Contracts\Transformer;
14 | 
15 | class SummaryPresenter implements AnalyzePresenter
16 | {
17 |     public function __construct(
18 |         private readonly SummaryView $view,
19 |         private readonly SummaryMapper $mapper,
20 |         private readonly Transformer $transformer,
21 |         private readonly SummarySettings $settings,
22 |     ) {}
23 | 
24 |     public function hello(): void
25 |     {
26 |         info('❀ PHP Class Dependencies Analyzer ❀');
27 | 
28 |         info('Analyze in progress...');
29 |     }
30 | 
31 |     public function error(Throwable $e): void
32 |     {
33 |         alert('sorry, something went wrong');
34 | 
35 |         if ($this->settings->debug) {
36 |             alert($e);
37 |         }
38 | 
39 |         alert($e->getMessage());
40 |     }
41 | 
42 |     public function present(AnalyzeResponse $response): void
43 |     {
44 |         $metrics = $response->metrics;
45 | 
46 |         $metrics = $this->transformer->apply($metrics);
47 | 
48 |         $metrics = $this->mapper->from($metrics);
49 | 
50 |         $this->view->show(new SummaryViewModel($metrics));
51 |     }
52 | }
53 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Component/Summary/SummarySettings.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Component\Summary;
 4 | 
 5 | class SummarySettings
 6 | {
 7 |     public function __construct(
 8 |         public readonly array $components,
 9 |         public readonly bool $info,
10 |         public readonly bool $debug,
11 |     ) {}
12 | }
13 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Component/Summary/SummaryView.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Component\Summary;
 4 | 
 5 | use App\Presenter\Analyze\Component\Summary\SummaryViewModel;
 6 | use function Laravel\Prompts\outro;
 7 | use function Laravel\Prompts\table;
 8 | use function Laravel\Prompts\warning;
 9 | 
10 | class SummaryView
11 | {
12 |     public function show(SummaryViewModel $viewModel): void
13 |     {
14 |         $this->displayMetrics($viewModel);
15 |         $this->displayInfo($viewModel);
16 |     }
17 | 
18 |     private function displayMetrics(SummaryViewModel $viewModel): void
19 |     {
20 |         $viewModel->hasComponents()
21 |             ? $this->showComponents($viewModel)
22 |             : warning('No classes found');
23 |     }
24 | 
25 |     private function showComponents(SummaryViewModel $viewModel): void
26 |     {
27 |         table(
28 |             headers: $viewModel->headers(),
29 |             rows: $viewModel->components(),
30 |         );
31 |     }
32 | 
33 |     private function displayInfo(SummaryViewModel $viewModel): void
34 |     {
35 |         $viewModel->needInfo()
36 |             ? $this->showInfo($viewModel)
37 |             : $this->showOutro($viewModel);
38 |     }
39 | 
40 |     private function showInfo(SummaryViewModel $viewModel): void
41 |     {
42 |         $viewModel->isHumanReadable()
43 |             ? $this->showHumanReadableInfo()
44 |             : $this->showMetricsInfo();
45 |     }
46 | 
47 |     private function showHumanReadableInfo(): void
48 |     {
49 |         outro('For more information, see the documentation: https://php-quality-tools.com/class-dependencies-analyzer');
50 |     }
51 | 
52 |     private function showMetricsInfo(): void
53 |     {
54 |         outro('Try --human-readable to get a more human readable output.');
55 |         outro('See the documentation for more information : https://php-quality-tools.com/class-dependencies-analyzer');
56 |     }
57 | 
58 |     private function showOutro(SummaryViewModel $viewModel): void
59 |     {
60 |         outro('Add --info to get more information on metrics.');
61 |         outro(sprintf('Found %d classes in the given path', $viewModel->count()));
62 |     }
63 | }
64 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Component/Summary/SummaryViewModel.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Component\Summary;
 4 | 
 5 | class SummaryViewModel
 6 | {
 7 |     public function __construct(
 8 |         public readonly array $components,
 9 |     ) {}
10 | 
11 |     public function components(): array
12 |     {
13 |         return $this->components;
14 |     }
15 | 
16 |     public function headers(): array
17 |     {
18 |         return array_keys(array_values($this->components)[0]);
19 |     }
20 | 
21 |     public function count(): int
22 |     {
23 |         return count($this->components);
24 |     }
25 | 
26 |     public function hasComponents(): bool
27 |     {
28 |         return $this->count() > 0;
29 |     }
30 | 
31 |     public function needInfo(): bool
32 |     {
33 |         return false;
34 |     }
35 | 
36 |     public function isHumanReadable(): bool
37 |     {
38 |         return false;
39 |     }
40 | }
41 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Shared/Calculators/AbstractnessCalculator.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Shared\Calculators;
 4 | 
 5 | use App\Application\Analyze\AnalyzeMetric;
 6 | use App\Presenter\Analyze\Shared\Calculators\Calculator;
 7 | 
 8 | class AbstractnessCalculator implements Calculator
 9 | {
10 |     public static function calculate(AnalyzeMetric $metric): string
11 |     {
12 |         $ratio = $metric->abstractnessRatio();
13 | 
14 |         if ($ratio > 0.7) {
15 |             return 'abstract';
16 |         }
17 | 
18 |         if ($ratio < 0.3) {
19 |             return 'concrete';
20 |         }
21 | 
22 |         return 'balanced';
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Shared/Calculators/Calculator.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Shared\Calculators;
 4 | 
 5 | use App\Application\Analyze\AnalyzeMetric;
 6 | 
 7 | interface Calculator
 8 | {
 9 |     public static function calculate(AnalyzeMetric $metric): string;
10 | }
11 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Shared/Calculators/MaintainabilityCalculator.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Shared\Calculators;
 4 | 
 5 | use App\Application\Analyze\AnalyzeMetric;
 6 | use App\Presenter\Analyze\Shared\Calculators\Calculator;
 7 | 
 8 | class MaintainabilityCalculator implements Calculator
 9 | {
10 |     public static function calculate(AnalyzeMetric $metric): string
11 |     {
12 |         /**
13 |          * lowly abstract and highly unstable: will suffer from its dependencies
14 |          */
15 |         if (self::isLowlyAbstractAndHighlyUnstable($metric)) {
16 |             return 'suffering';
17 |         }
18 | 
19 |         /**
20 |          * lowly abstract and stable: a modification will impact many classes
21 |          */
22 |         if (self::isLowlyAbstractAndHighlyStable($metric)) {
23 |             return 'risky';
24 |         }
25 | 
26 |         return 'good';
27 |     }
28 | 
29 |     private static function isLowlyAbstractAndHighlyUnstable(AnalyzeMetric $metric): bool
30 |     {
31 |         return $metric->abstractnessRatio() < 0.3 && $metric->instability() > 0.7;
32 |     }
33 | 
34 |     private static function isLowlyAbstractAndHighlyStable(AnalyzeMetric $metric): bool
35 |     {
36 |         return $metric->abstractnessRatio() < 0.3 && $metric->instability() < 0.3;
37 |     }
38 | }
39 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Shared/Calculators/StabilityCalculator.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Shared\Calculators;
 4 | 
 5 | use App\Application\Analyze\AnalyzeMetric;
 6 | use App\Presenter\Analyze\Shared\Calculators\Calculator;
 7 | 
 8 | class StabilityCalculator implements Calculator
 9 | {
10 |     public static function calculate(AnalyzeMetric $metric): string
11 |     {
12 |         $instability = $metric->instability();
13 | 
14 |         if ($instability > 0.7) {
15 |             return 'unstable';
16 |         }
17 | 
18 |         if ($instability < 0.3) {
19 |             return 'stable';
20 |         }
21 | 
22 |         return 'flexible';
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Shared/Filters/Collectors/Components.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Shared\Filters\Collectors;
 4 | 
 5 | class Components 
 6 | {
 7 |     public function __construct(
 8 |         private array $components,
 9 |     ) {}
10 | 
11 |     public function set(array $components): void
12 |     {
13 |         $this->components = $components;
14 |     }
15 | 
16 |     public function get(): array
17 |     {
18 |         return $this->components;
19 |     }
20 | 
21 |     public function add(string $component, array $metric): void
22 |     {
23 |         $this->components[$component][] = $metric;
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Shared/Filters/Collectors/Depth.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Shared\Filters\Collectors;
 4 | 
 5 | use App\Application\Analyze\AnalyzeMetric;
 6 | 
 7 | class Depth
 8 | {
 9 |     private array $depth = [];
10 | 
11 |     public function add(AnalyzeMetric $class): void
12 |     {
13 |         $this->depth[$class->name()] = $class;
14 |     }
15 | 
16 |     public function has(string $name): bool
17 |     {
18 |         return isset($this->depth[$name]);
19 |     }
20 | 
21 |     public function toArray(): array
22 |     {
23 |         return $this->depth;
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Shared/Filters/Collectors/Metrics.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Shared\Filters\Collectors;
 4 | 
 5 | use App\Application\Analyze\AnalyzeMetric;
 6 | 
 7 | class Metrics
 8 | {
 9 |     private array $metrics = [];
10 | 
11 |     public function set(array $metrics): void
12 |     {
13 |         $this->metrics = $metrics;
14 |     }
15 | 
16 |     public function unknown(string $name): bool
17 |     {
18 |         return ! isset($this->metrics[$name]);
19 |     }
20 | 
21 |     public function get(string $name): AnalyzeMetric
22 |     {
23 |         return $this->metrics[$name];
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Shared/Filters/Contracts/Transformer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Shared\Filters\Contracts;
 4 | 
 5 | use App\Application\Analyze\AnalyzeMetric;
 6 | 
 7 | /**
 8 |  * Transformers manipulate metrics by reshaping the data structure before mapping.
 9 |  */
10 | interface Transformer
11 | {
12 |     /**
13 |      * @param array<AnalyzeMetric> $metrics
14 |      * @return array<AnalyzeMetric>
15 |      */
16 |     public function apply(array $metrics): array;
17 | }
18 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Shared/Filters/Transformers/ComponentTransformer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Shared\Filters\Transformers;
 4 | 
 5 | use Illuminate\Support\Str;
 6 | use App\Presenter\Analyze\Shared\Filters\Contracts\Transformer;
 7 | 
 8 | class ComponentTransformer implements Transformer
 9 | {
10 |     public function __construct(
11 |         private readonly array $targetedComponents,
12 |     ) {}
13 | 
14 |     public function apply(array $metrics): array
15 |     {
16 |         $components = [];
17 | 
18 |         foreach ($metrics as $metric) {
19 | 
20 |             foreach ($this->targetedComponents as $component) {
21 | 
22 |                 $name = $metric->name();
23 | 
24 |                 if ($this->isTargetedComponent($name, $component)) {
25 | 
26 |                     $components[$component][] = $metric;
27 | 
28 |                     break;
29 |                 }
30 |             }
31 |         }
32 | 
33 |         return $components;
34 |     }
35 | 
36 |     private function isTargetedComponent(string $name, string $component): bool
37 |     {
38 |         return Str::startsWith($name, $component);
39 |     }
40 | }
41 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Shared/Filters/Transformers/NullTransformer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Shared\Filters\Transformers;
 4 | 
 5 | use App\Presenter\Analyze\Shared\Filters\Contracts\Transformer;
 6 | 
 7 | class NullTransformer implements Transformer
 8 | {
 9 |     public function apply(array $metrics): array
10 |     {
11 |         return $metrics;
12 |     }
13 | }
14 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Shared/Filters/Transformers/TargetTransformer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Shared\Filters\Transformers;
 4 | 
 5 | use Exception;
 6 | use App\Presenter\Analyze\Shared\Filters\Collectors\Depth;
 7 | use App\Presenter\Analyze\Shared\Filters\Collectors\Metrics;
 8 | use App\Presenter\Analyze\Shared\Filters\Contracts\Transformer;
 9 | 
10 | class TargetTransformer implements Transformer
11 | {
12 |     private int $deep = 0;
13 | 
14 |     public function __construct(
15 |         private readonly Depth $depth,
16 |         private readonly Metrics $metrics,
17 |         private readonly string $target,
18 |         private readonly ?int $depthLimit = null,
19 |     ) {}
20 | 
21 |     /**
22 |      * Keep target class and all its dependencies.
23 |      */
24 |     public function apply(array $metrics): array
25 |     {
26 |         $this->metrics->set($metrics);
27 | 
28 |         $this->checkTargetPresence();
29 | 
30 |         $targetClass = $this->metrics->get($this->target);
31 | 
32 |         $this->depth->add($targetClass);
33 | 
34 |         foreach ($targetClass->dependencies() as $dependency) {
35 |             $this->deepDive($dependency);
36 |         }
37 | 
38 |         return $this->depth->toArray();
39 |     }
40 | 
41 |     private function checkTargetPresence(): void
42 |     {
43 |         if ($this->metrics->unknown($this->target)) {
44 |             throw new Exception('Target ' . $this->target . ' not found on metrics, try verify the target name.');
45 |         }
46 |     }
47 | 
48 |     private function deepDive(string $dependency): void
49 |     {
50 |         if ($this->shouldStop($dependency)) {
51 |             return;
52 |         }
53 | 
54 |         $targetClass = $this->metrics->get($dependency);
55 | 
56 |         $this->depth->add($targetClass);
57 | 
58 |         $this->incrementDeep();
59 | 
60 |         foreach ($targetClass->dependencies() as $innerDependency) {
61 |             $this->deepDive($innerDependency);
62 |         }
63 | 
64 |         $this->decrementDeep();
65 |     }
66 | 
67 |     private function shouldStop(string $dependency): bool
68 |     {
69 |         return $this->dependencyIsAlreadyAnalyzed($dependency)
70 |             || $this->dependencyIsUnknown($dependency)
71 |             || $this->dependencyIsTooDeep();
72 |     }
73 | 
74 |     private function dependencyIsAlreadyAnalyzed(string $dependency): bool
75 |     {
76 |         return $this->depth->has($dependency);
77 |     }
78 | 
79 |     private function dependencyIsUnknown(string $dependency): bool
80 |     {
81 |         return $this->metrics->unknown($dependency);
82 |     }
83 | 
84 |     private function dependencyIsTooDeep(): bool
85 |     {
86 |         return $this->depthLimit !== null && $this->deep >= ($this->depthLimit - 1) ;
87 |     }
88 | 
89 |     private function incrementDeep(): void
90 |     {
91 |         $this->deep++;
92 |     }
93 | 
94 |     private function decrementDeep(): void
95 |     {
96 |         $this->deep--;
97 |     }
98 | }
99 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Shared/Network/Network.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Shared\Network;
 4 | 
 5 | interface Network
 6 | {
 7 |     public function nodes(): array;
 8 |     public function edges(): array;
 9 |     public function countNodes(): int;
10 | }
11 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Shared/Network/NetworkAttribute.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Shared\Network;
 4 | 
 5 | class NetworkAttribute
 6 | {
 7 |     public function __construct(
 8 |         private readonly string $name,
 9 |         private readonly float $instability,
10 |         private readonly array $dependencies,
11 |     ) {}
12 | 
13 |     public function name(): string
14 |     {
15 |         return $this->name;
16 |     }
17 | 
18 |     public function instability(): float
19 |     {
20 |         return $this->instability;
21 |     }
22 | 
23 |     public function dependencies(): array
24 |     {
25 |         return $this->dependencies;
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Shared/Network/NetworkAttributesMapper.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Shared\Network;
 4 | 
 5 | use App\Presenter\Analyze\Shared\Network\Networkable;
 6 | use App\Presenter\Analyze\Shared\Network\NetworkAttribute;
 7 | 
 8 | class NetworkAttributesMapper
 9 | {
10 |     public function map(array $items): array
11 |     {   
12 |         $attributes = [];
13 | 
14 |         foreach ($items as $item) {
15 |             $attributes[] = $this->makeNetworkAttribute($item);
16 |         }
17 | 
18 |         return $attributes;
19 |     }
20 | 
21 |     public function makeNetworkAttribute(Networkable $item): NetworkAttribute
22 |     {
23 |         return new NetworkAttribute(
24 |             $item->name(),
25 |             $item->instability(),
26 |             $item->dependencies(),
27 |         );
28 |     }
29 | }
30 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Shared/Network/NetworkBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Shared\Network;
 4 | 
 5 | use App\Presenter\Analyze\Shared\Network\Network;
 6 | use App\Presenter\Analyze\Shared\Network\NetworkAttribute;
 7 | 
 8 | interface NetworkBuilder
 9 | {
10 |     /**
11 |      * @param array<NetworkAttribute> $attributes
12 |      */
13 |     public function build(array $attributes): Network;
14 | }
15 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Shared/Network/Networkable.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Shared\Network;
 4 | 
 5 | interface Networkable
 6 | {
 7 |     public function name(): string;
 8 |     public function instability(): float;
 9 |     public function dependencies(): array;
10 | }
11 | 


--------------------------------------------------------------------------------
/app/Presenter/Analyze/Shared/Views/SystemFileLauncher.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Analyze\Shared\Views;
 4 | 
 5 | interface SystemFileLauncher
 6 | {
 7 |     public function open(): void;
 8 |     public function save(string $html): void;
 9 | }
10 | 


--------------------------------------------------------------------------------
/app/Presenter/ArrayFormatter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter;
 4 | 
 5 | class ArrayFormatter
 6 | {
 7 |     public static function sort(string $key, array $items): array
 8 |     {
 9 |         usort($items, function ($a, $b) use ($key) {
10 |             return $b[$key] <=> $a[$key];
11 |         });
12 | 
13 |         return $items;
14 |     }
15 | 
16 |     public static function cut(?int $limit, array $items): array
17 |     {
18 |         if ($limit === null) {
19 |             return $items;
20 |         }
21 | 
22 |         return array_slice($items, 0, $limit);
23 |     }
24 | 
25 |     public static function filterByMinValue(string $key, ?float $minValue, array $items): array
26 |     {
27 |         if ($minValue === null) {
28 |             return $items;
29 |         }
30 | 
31 |         $items = array_filter($items, function ($item) use ($key, $minValue) {
32 |             return $item[$key] >= $minValue;
33 |         });
34 | 
35 |         return array_values($items);
36 |     }
37 | }
38 | 


--------------------------------------------------------------------------------
/app/Presenter/Cyclic/Summary/CycleHelper.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Cyclic\Summary;
 4 | 
 5 | use App\Presenter\NameFormatter;
 6 | 
 7 | class CycleHelper
 8 | {
 9 |     public static function through(array $classNames): string
10 |     {
11 |         $readableNames = self::convertToReadableNames($classNames);
12 | 
13 |         $path = self::joinWithArrows($readableNames);
14 | 
15 |         return self::completeCircularPath($path, $classNames);
16 |     }
17 | 
18 |     private static function convertToReadableNames(array $classNames): array
19 |     {
20 |         return array_map(function ($className) {
21 |             return NameFormatter::humanReadable($className);
22 |         }, $classNames);
23 |     }
24 | 
25 |     private static function joinWithArrows(array $names): string
26 |     {
27 |         return implode(' -> ', $names);
28 |     }
29 | 
30 |     private static function completeCircularPath(string $path, array $names): string
31 |     {
32 |         return $path . ' -> ' . NameFormatter::humanReadable($names[0]);
33 |     }
34 | }
35 | 


--------------------------------------------------------------------------------
/app/Presenter/Cyclic/Summary/CyclicPresenterMapper.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Cyclic\Summary;
 4 | 
 5 | use App\Presenter\Cyclic\Summary\CycleHelper;
 6 | 
 7 | class CyclicPresenterMapper
 8 | {
 9 |     public function from(array $cycles): array
10 |     {
11 |         return array_map(function (array $cycle) {
12 |             return [CycleHelper::through($cycle)];
13 |         }, $cycles);
14 |     }
15 | }
16 | 


--------------------------------------------------------------------------------
/app/Presenter/Cyclic/Summary/SummaryPresenter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Cyclic\Summary;
 4 | 
 5 | use Throwable;
 6 | use function Laravel\Prompts\info;
 7 | use function Laravel\Prompts\alert;
 8 | use App\Application\Cyclic\CyclicResponse;
 9 | use App\Application\Cyclic\CyclicPresenter;
10 | use App\Presenter\Cyclic\Summary\SummaryViewModel;
11 | use App\Presenter\Cyclic\Summary\CyclicPresenterMapper;
12 | 
13 | class SummaryPresenter implements CyclicPresenter
14 | {
15 |     public function __construct(
16 |         private readonly SummaryView $view,
17 |         private readonly SummarySettings $settings,
18 |         private readonly CyclicPresenterMapper $mapper,
19 |     ) {}
20 | 
21 |     public function hello(): void
22 |     {
23 |         info('❀ PHP Class Dependencies Analyzer ❀');
24 | 
25 |         info('Analyze in progress...');
26 |     }
27 | 
28 |     public function error(Throwable $e): void
29 |     {
30 |         alert('sorry, something went wrong');
31 | 
32 |         if ($this->settings->debug) {
33 |             alert($e);
34 |         }
35 | 
36 |         alert($e->getMessage());
37 |     }
38 | 
39 |     public function present(CyclicResponse $response): void
40 |     {
41 |         $metrics = $this->mapper->from($response->cycles);
42 | 
43 |         $viewModel = new SummaryViewModel($metrics, $response->count);
44 | 
45 |         $this->view->show($viewModel);
46 |     }
47 | }
48 | 


--------------------------------------------------------------------------------
/app/Presenter/Cyclic/Summary/SummarySettings.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Cyclic\Summary;
 4 | 
 5 | class SummarySettings
 6 | {
 7 |     public function __construct(
 8 |         public readonly bool $debug = false,
 9 |     ) {}
10 | }
11 | 


--------------------------------------------------------------------------------
/app/Presenter/Cyclic/Summary/SummaryView.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Cyclic\Summary;
 4 | 
 5 | use function Laravel\Prompts\outro;
 6 | use function Laravel\Prompts\table;
 7 | use function Laravel\Prompts\warning;
 8 | use App\Presenter\Cyclic\Summary\SummaryViewModel;
 9 | 
10 | class SummaryView
11 | {
12 |     public function show(SummaryViewModel $viewModel): void
13 |     {
14 |         count($viewModel->metrics) === 0
15 |             ? warning('Good work! No cycles found')
16 |             : $this->showTable($viewModel);
17 |     }
18 | 
19 |     private function showTable(SummaryViewModel $viewModel): void
20 |     {
21 |         table(
22 |             ['Cyclic Path'],
23 |             $viewModel->metrics,
24 |         );
25 | 
26 |         outro('A cycle is a class that depends on itself through its dependencies.');
27 |         outro('It can be a sign of a bad design and reveal an ensemble of components difficult to maintain and evolve.');
28 | 
29 |         outro('See the documentation for more information : https://php-quality-tools.com/class-dependencies-analyzer');
30 | 
31 |         outro('Cycles found: ' . $viewModel->totalClasses);
32 |     }
33 | }
34 | 


--------------------------------------------------------------------------------
/app/Presenter/Cyclic/Summary/SummaryViewModel.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Cyclic\Summary;
 4 | 
 5 | class SummaryViewModel
 6 | {
 7 |     public function __construct(
 8 |         public readonly array $metrics,
 9 |         public readonly int $totalClasses,
10 |     ) {}
11 | }
12 | 


--------------------------------------------------------------------------------
/app/Presenter/NameFormatter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter;
 4 | 
 5 | use Illuminate\Support\Collection;
 6 | use Illuminate\Support\Str;
 7 | 
 8 | class NameFormatter
 9 | {
10 |     public static function className(string $className): string
11 |     {
12 |         return Str::of($className)->explode('\\')->last();
13 |     }
14 | 
15 |     public static function humanReadable(string $className): string
16 |     {
17 |         $exploded = Str::of($className)->explode('\\');
18 | 
19 |         if (self::isShortName($exploded)) {
20 |             return $className;
21 |         }
22 | 
23 |         $exploded = self::keepLastTwoNamespaces($exploded);
24 | 
25 |         return $exploded->implode('\\');
26 |     }
27 | 
28 |     private static function isShortName(Collection $exploded): bool
29 |     {
30 |         return $exploded->count() <= 2;
31 |     }
32 | 
33 |     private static function keepLastTwoNamespaces(Collection $exploded): Collection
34 |     {
35 |         return $exploded->reverse()->take(2)->reverse();
36 |     }
37 | }
38 | 


--------------------------------------------------------------------------------
/app/Presenter/Weakness/Summary/SummaryPresenter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Weakness\Summary;
 4 | 
 5 | use Throwable;
 6 | use App\Presenter\ArrayFormatter;
 7 | use function Laravel\Prompts\info;
 8 | use function Laravel\Prompts\alert;
 9 | use App\Application\Weakness\WeaknessResponse;
10 | use App\Application\Weakness\WeaknessPresenter;
11 | use App\Presenter\Weakness\Summary\SummaryView;
12 | use App\Presenter\Weakness\Summary\SummarySettings;
13 | 
14 | class SummaryPresenter implements WeaknessPresenter
15 | {
16 |     public function __construct(
17 |         private readonly SummarySettings $settings,
18 |         private readonly SummaryView $view
19 |     ) {}
20 | 
21 |     public function hello(): void
22 |     {
23 |         info('❀ PHP Class Dependencies Analyzer ❀');
24 | 
25 |         info('Analyze in progress...');
26 |     }
27 | 
28 |     public function error(Throwable $exception): void
29 |     {
30 |         alert('sorry, something went wrong');
31 | 
32 |         if ($this->settings->debug()) {
33 |             alert($exception);
34 |         }
35 | 
36 |         alert($exception->getMessage());
37 |     }
38 | 
39 |     public function present(WeaknessResponse $response): void
40 |     {
41 |         $metrics = $this->applyFiltersOnMetrics($response);
42 | 
43 |         $metrics = WeaknessPresenterMapper::from($metrics);
44 | 
45 |         $viewModel = new SummaryViewModel($metrics, $response->count, $this->settings->minDelta());
46 | 
47 |         $this->view->show($viewModel);
48 |     }
49 | 
50 |     private function applyFiltersOnMetrics(WeaknessResponse $response): array
51 |     {
52 |         $metrics = $response->metrics;
53 | 
54 |         $metrics = ArrayFormatter::sort('delta', $metrics);
55 | 
56 |         $metrics = ArrayFormatter::cut($this->settings->limit(), $metrics);
57 | 
58 |         $metrics = ArrayFormatter::filterByMinValue('delta', $this->settings->minDelta(), $metrics);
59 | 
60 |         return $metrics;
61 |     }
62 | }
63 | 


--------------------------------------------------------------------------------
/app/Presenter/Weakness/Summary/SummarySettings.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Weakness\Summary;
 4 | 
 5 | class SummarySettings
 6 | {
 7 |     public function __construct(
 8 |         private readonly ?int $limit = null,
 9 |         private readonly ?float $minDelta = null,
10 |         private readonly bool $debug = false,
11 |     ) {}
12 | 
13 |     public function limit(): ?int
14 |     {
15 |         return $this->limit;
16 |     }
17 | 
18 |     public function minDelta(): float
19 |     {
20 |         return $this->minDelta ?? 0.0;
21 |     }
22 | 
23 |     public function debug(): bool
24 |     {
25 |         return $this->debug;
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/app/Presenter/Weakness/Summary/SummaryView.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Weakness\Summary;
 4 | 
 5 | use function Laravel\Prompts\outro;
 6 | use function Laravel\Prompts\table;
 7 | use function Laravel\Prompts\warning;
 8 | use App\Presenter\Weakness\Summary\SummaryViewModel;
 9 | 
10 | class SummaryView
11 | {
12 |     public function show(SummaryViewModel $viewModel): void
13 |     {
14 |         count($viewModel->metrics) === 0
15 |             ? warning('Good work! No weaknesses found')
16 |             : $this->showTable($viewModel);
17 |     }
18 | 
19 |     protected function showTable(SummaryViewModel $viewModel): void
20 |     {
21 |         table(
22 |             headers: ['Class', 'Instability', 'Dependency', 'Instability', 'Delta'],
23 |             rows: $viewModel->metrics,
24 |         );
25 | 
26 |         $this->showHowManyWeaknessesFound($viewModel);
27 |     }
28 | 
29 |     protected function showHowManyWeaknessesFound(SummaryViewModel $viewModel): void
30 |     {
31 |         if ($viewModel->delta) {
32 |             outro(sprintf('Showing weaknesses with delta greater than %s', $viewModel->delta));
33 |         }
34 | 
35 |         outro('A weakness is a class that depends on a class that is more unstable than itself. More the delta is high, more the dependency is unstable.');
36 |         outro('It can be a sign of a bad design and an indicator of a class that can suffer from side effects of its dependencies.');
37 | 
38 |         outro('See the documentation for more information : https://php-quality-tools.com/class-dependencies-analyzer');
39 | 
40 |         outro(sprintf('Found %d weaknesses in %d classes', count($viewModel->metrics), $viewModel->totalClasses));
41 |     }
42 | }
43 | 


--------------------------------------------------------------------------------
/app/Presenter/Weakness/Summary/SummaryViewModel.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Weakness\Summary;
 4 | 
 5 | class SummaryViewModel
 6 | {
 7 |     public function __construct(
 8 |         public readonly array $metrics,
 9 |         public readonly int $totalClasses,
10 |         public readonly float $delta,
11 |     ) {}
12 | }
13 | 


--------------------------------------------------------------------------------
/app/Presenter/Weakness/Summary/WeaknessPresenterMapper.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Presenter\Weakness\Summary;
 4 | 
 5 | use App\Presenter\NameFormatter;
 6 | 
 7 | class WeaknessPresenterMapper
 8 | {
 9 |     public static function from(array $metrics): array
10 |     {
11 |         return array_map(function ($metric) {
12 |             return [
13 |                 'class' => NameFormatter::humanReadable($metric['class']),
14 |                 'instability' => $metric['class_instability'],
15 |                 'dependency' => NameFormatter::humanReadable($metric['dependency']),
16 |                 'dependency_instability' => $metric['dependency_instability'],
17 |                 'delta' => $metric['delta'],
18 |             ];
19 |         }, $metrics);
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/app/Providers/AppServiceProvider.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Providers;
 4 | 
 5 | use PhpParser\ParserFactory;
 6 | use Illuminate\Support\ServiceProvider;
 7 | use App\Domain\Ports\Aggregators\FileAggregator;
 8 | use App\Domain\Ports\Repositories\FileRepository;
 9 | use App\Presenter\Analyze\Shared\Views\SystemFileLauncher;
10 | use App\Presenter\Analyze\Shared\Ports\GraphMapper;
11 | use App\Infrastructure\Analyze\Ports\AnalyzerService;
12 | use App\Presenter\Analyze\Shared\Network\NetworkBuilder;
13 | use App\Infrastructure\Analyze\Ports\ClassDependenciesParser;
14 | use App\Infrastructure\Views\Adapters\SystemFileLauncherAdapter;
15 | use App\Infrastructure\Graph\Adapters\Cytoscape\CytoscapeGraphMapper;
16 | use App\Infrastructure\Analyze\Adapters\Jerowork\NodeTraverserFactory;
17 | use App\Infrastructure\File\Adapters\Aggregators\FileAggregatorAdapter;
18 | use App\Infrastructure\Analyze\Adapters\Services\AnalyzerServiceAdapter;
19 | use App\Infrastructure\File\Adapters\Repositories\FileRepositoryAdapter;
20 | use App\Infrastructure\Graph\Adapters\Cytoscape\CytoscapeNetworkBuilder;
21 | use App\Infrastructure\Analyze\Adapters\Jerowork\ClassDependenciesParserAdapter;
22 | 
23 | class AppServiceProvider extends ServiceProvider
24 | {
25 |     /**
26 |      * Bootstrap any application services.
27 |      */
28 |     public function boot(): void
29 |     {
30 |         //
31 |     }
32 | 
33 |     /**
34 |      * Register any application services.
35 |      */
36 |     public function register(): void
37 |     {
38 |         $this->app->bind(FileRepository::class, FileRepositoryAdapter::class);
39 | 
40 |         $this->app->bind(FileAggregator::class, FileAggregatorAdapter::class);
41 | 
42 |         $this->app->bind(AnalyzerService::class, AnalyzerServiceAdapter::class);
43 | 
44 |         $this->app->bind(NetworkBuilder::class, CytoscapeNetworkBuilder::class);
45 | 
46 |         $this->app->bind(SystemFileLauncher::class, SystemFileLauncherAdapter::class);
47 | 
48 |         $this->app->bind(ClassDependenciesParser::class, function () {
49 |             return new ClassDependenciesParserAdapter(
50 |                 (new ParserFactory())->create(ParserFactory::PREFER_PHP7),
51 |                 new NodeTraverserFactory(),
52 |             );
53 |         });
54 |     }
55 | }
56 | 


--------------------------------------------------------------------------------
/app/Providers/Custom/CustomNodeTraverserFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Providers\Custom;
 6 | 
 7 | use Jerowork\ClassDependenciesParser\ClassDependencies;
 8 | use Jerowork\ClassDependenciesParser\PhpParser\NodeVisitor\ParseImportedFqnNodeVisitor;
 9 | use Jerowork\ClassDependenciesParser\PhpParser\NodeVisitor\ParseClassFqnNodeVisitor;
10 | use PhpParser\NodeTraverser;
11 | use PhpParser\NodeTraverserInterface;
12 | use PhpParser\NodeVisitor\ParentConnectingVisitor;
13 | 
14 | final class CustomNodeTraverserFactory
15 | {
16 |     public function createTraverser(ClassDependencies $classDependencies): NodeTraverserInterface
17 |     {
18 |         $traverser = new NodeTraverser();
19 | 
20 |         $traverser->addVisitor(new ParentConnectingVisitor());
21 |         $traverser->addVisitor(new ParseClassFqnNodeVisitor($classDependencies));
22 |         $traverser->addVisitor(new ParseImportedFqnNodeVisitor($classDependencies));
23 | 
24 |         return $traverser;
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/arts/graph.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DeGraciaMathieu/php-class-dependencies-analyzer/aad21eaa299adcecea8d9013e56d9ccb2e9f9594/arts/graph.png


--------------------------------------------------------------------------------
/arts/home.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DeGraciaMathieu/php-class-dependencies-analyzer/aad21eaa299adcecea8d9013e56d9ccb2e9f9594/arts/home.png


--------------------------------------------------------------------------------
/bootstrap/app.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | use LaravelZero\Framework\Application;
4 | 
5 | return Application::configure(basePath: dirname(__DIR__))->create();
6 | 


--------------------------------------------------------------------------------
/bootstrap/providers.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | return [
4 |     App\Providers\AppServiceProvider::class,
5 | ];
6 | 


--------------------------------------------------------------------------------
/box.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "chmod": "0755",
 3 |     "directories": [
 4 |         "app",
 5 |         "bootstrap",
 6 |         "config",
 7 |         "vendor",
 8 |         "resources"
 9 |     ],
10 |     "files": [
11 |         "composer.json"
12 |     ],
13 |     "exclude-composer-files": false,
14 |     "compression": "GZ",
15 |     "compactors": [
16 |         "KevinGH\\Box\\Compactor\\Php",
17 |         "KevinGH\\Box\\Compactor\\Json"
18 |     ]
19 | }
20 | 


--------------------------------------------------------------------------------
/builds/class-dependencies-analyzer:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DeGraciaMathieu/php-class-dependencies-analyzer/aad21eaa299adcecea8d9013e56d9ccb2e9f9594/builds/class-dependencies-analyzer


--------------------------------------------------------------------------------
/class-dependencies-analyzer:
--------------------------------------------------------------------------------
 1 | #!/usr/bin/env php
 2 | <?php
 3 | 
 4 | define('LARAVEL_START', microtime(true));
 5 | 
 6 | /*
 7 | |--------------------------------------------------------------------------
 8 | | Register The Auto Loader
 9 | |--------------------------------------------------------------------------
10 | |
11 | | Composer provides a convenient, automatically generated class loader
12 | | for our application. We just need to utilize it! We'll require it
13 | | into the script here so that we do not have to worry about the
14 | | loading of any our classes "manually". Feels great to relax.
15 | |
16 | */
17 | 
18 | $autoloader = require file_exists(__DIR__.'/vendor/autoload.php') ?  __DIR__.'/vendor/autoload.php' : __DIR__.'/../../autoload.php';
19 | 
20 | $app = require_once __DIR__.'/bootstrap/app.php';
21 | 
22 | /*
23 | |--------------------------------------------------------------------------
24 | | Run The Artisan Application
25 | |--------------------------------------------------------------------------
26 | |
27 | | When we run the console application, the current CLI command will be
28 | | executed in this console and the response sent back to a terminal
29 | | or another output device for the developers. Here goes nothing!
30 | |
31 | */
32 | 
33 | $kernel = $app->make(Illuminate\Contracts\Console\Kernel::class);
34 | 
35 | $status = $kernel->handle(
36 |     $input = new Symfony\Component\Console\Input\ArgvInput,
37 |     new Symfony\Component\Console\Output\ConsoleOutput
38 | );
39 | 
40 | /*
41 | |--------------------------------------------------------------------------
42 | | Shutdown The Application
43 | |--------------------------------------------------------------------------
44 | |
45 | | Once Artisan has finished running, we will fire off the shutdown events
46 | | so that any final work may be done by the application before we shut
47 | | down the process. This is the last thing to happen to the request.
48 | |
49 | */
50 | 
51 | $kernel->terminate($input, $status);
52 | 
53 | exit($status);
54 | 


--------------------------------------------------------------------------------
/composer.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "name": "degraciamathieu/php-class-dependencies-analyzer",
 3 |     "description": "This tool allows you to monitor the dependencies and instability of your classes.",
 4 |     "keywords": ["php", "quality", "analysis", "static-analysis", "coupling", "instability"],
 5 |     "homepage": "https://github.com/DeGraciaMathieu/php-class-dependencies-analyzer",
 6 |     "type": "project",
 7 |     "license": "MIT",
 8 |     "support": {
 9 |         "issues": "https://github.com/DeGraciaMathieu/php-class-dependencies-analyzer/issues",
10 |         "source": "https://github.com/DeGraciaMathieu/php-class-dependencies-analyzer"
11 |     },
12 |     "authors": [
13 |         {
14 |             "name": "Mathieu De Gracia",
15 |             "email": "work@degracia-mathieu.fr"
16 |         }
17 |     ],
18 |     "require": {
19 |         "php": "^8.2.0",
20 |         "degraciamathieu/php-file-explorer": "^0.4.1",
21 |         "illuminate/view": "^11.5",
22 |         "jerowork/class-dependencies-parser": "^0.5.1",
23 |         "laravel-zero/framework": "^11.0.0",
24 |         "laravel/prompts": "^0.1.25",
25 |         "nikic/php-parser": "4.19.*"
26 |     },
27 |     "require-dev": {
28 |         "laravel/pint": "^1.15.2",
29 |         "mockery/mockery": "^1.6.11",
30 |         "pestphp/pest": "^2.34.7"
31 |     },
32 |     "autoload": {
33 |         "psr-4": {
34 |             "App\\": "app/",
35 |             "Database\\Factories\\": "database/factories/",
36 |             "Database\\Seeders\\": "database/seeders/"
37 |         }
38 |     },
39 |     "autoload-dev": {
40 |         "psr-4": {
41 |             "Tests\\": "tests/"
42 |         }
43 |     },
44 |     "config": {
45 |         "preferred-install": "dist",
46 |         "sort-packages": true,
47 |         "optimize-autoloader": true,
48 |         "allow-plugins": {
49 |             "pestphp/pest-plugin": true
50 |         }
51 |     },
52 |     "scripts": {
53 |         "test": "vendor/bin/pest -p",
54 |         "healthcheck": [
55 |             "php class-dependencies-analyzer weakness app",
56 |             "php class-dependencies-analyzer weakness app --min-delta=0.1",
57 |             "php class-dependencies-analyzer weakness app --limit=10",
58 |             "php class-dependencies-analyzer weakness app --only='App\\Application'",
59 |             "php class-dependencies-analyzer weakness app --exclude='App\\Infrastructure'",
60 |             "php class-dependencies-analyzer cyclic app",
61 |             "php class-dependencies-analyzer cyclic app --only='App\\Application'",
62 |             "php class-dependencies-analyzer cyclic app --exclude='App\\Infrastructure'",
63 |             "php class-dependencies-analyzer analyze:class app",
64 |             "php class-dependencies-analyzer analyze:class app --only='App\\Application'",
65 |             "php class-dependencies-analyzer analyze:class app --exclude='App\\Infrastructure'",
66 |             "php class-dependencies-analyzer analyze:class app --target='App\\Application\\Analyze\\AnalyzeAction'",
67 |             "php class-dependencies-analyzer analyze:class app --target='App\\Application\\Analyze\\AnalyzeAction' --depth-limit=2",
68 |             "php class-dependencies-analyzer analyze:class app --graph",
69 |             "php class-dependencies-analyzer analyze:component app 'App\\Application'",
70 |             "php class-dependencies-analyzer analyze:component app 'App\\Application' --graph",
71 |             "vendor/bin/pest -p"
72 |         ],
73 |         "coverage": "php -d xdebug.mode=coverage vendor/bin/pest --coverage -p"
74 |     },
75 |     "minimum-stability": "stable",
76 |     "prefer-stable": true,
77 |     "bin": ["class-dependencies-analyzer"]
78 | }
79 | 


--------------------------------------------------------------------------------
/config/app.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | return [
 4 | 
 5 |     /*
 6 |     |--------------------------------------------------------------------------
 7 |     | Application Name
 8 |     |--------------------------------------------------------------------------
 9 |     |
10 |     | This value is the name of your application. This value is used when the
11 |     | framework needs to place the application's name in a notification or
12 |     | any other location as required by the application or its packages.
13 |     |
14 |     */
15 | 
16 |     'name' => 'Class-dependencies-analyzer',
17 | 
18 |     /*
19 |     |--------------------------------------------------------------------------
20 |     | Application Version
21 |     |--------------------------------------------------------------------------
22 |     |
23 |     | This value determines the "version" your application is currently running
24 |     | in. You may want to follow the "Semantic Versioning" - Given a version
25 |     | number MAJOR.MINOR.PATCH when an update happens: https://semver.org.
26 |     |
27 |     */
28 | 
29 |     'version' => app('git.version'),
30 | 
31 |     /*
32 |     |--------------------------------------------------------------------------
33 |     | Application Environment
34 |     |--------------------------------------------------------------------------
35 |     |
36 |     | This value determines the "environment" your application is currently
37 |     | running in. This may determine how you prefer to configure various
38 |     | services the application utilizes. This can be overridden using
39 |     | the global command line "--env" option when calling commands.
40 |     |
41 |     */
42 | 
43 |     'env' => 'development',
44 | 
45 |     /*
46 |     |--------------------------------------------------------------------------
47 |     | Autoloaded Service Providers
48 |     |--------------------------------------------------------------------------
49 |     |
50 |     | The service providers listed here will be automatically loaded on the
51 |     | request to your application. Feel free to add your own services to
52 |     | this array to grant expanded functionality to your applications.
53 |     |
54 |     */
55 | 
56 |     'providers' => [
57 |         App\Providers\AppServiceProvider::class,
58 |     ],
59 | 
60 | ];
61 | 


--------------------------------------------------------------------------------
/config/commands.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | return [
 4 | 
 5 |     /*
 6 |     |--------------------------------------------------------------------------
 7 |     | Default Command
 8 |     |--------------------------------------------------------------------------
 9 |     |
10 |     | Laravel Zero will always run the command specified below when no command name is
11 |     | provided. Consider update the default command for single command applications.
12 |     | You cannot pass arguments to the default command because they are ignored.
13 |     |
14 |     */
15 | 
16 |     'default' => NunoMaduro\LaravelConsoleSummary\SummaryCommand::class,
17 | 
18 |     /*
19 |     |--------------------------------------------------------------------------
20 |     | Commands Paths
21 |     |--------------------------------------------------------------------------
22 |     |
23 |     | This value determines the "paths" that should be loaded by the console's
24 |     | kernel. Foreach "path" present on the array provided below the kernel
25 |     | will extract all "Illuminate\Console\Command" based class commands.
26 |     |
27 |     */
28 | 
29 |     'paths' => [app_path('Commands')],
30 | 
31 |     /*
32 |     |--------------------------------------------------------------------------
33 |     | Added Commands
34 |     |--------------------------------------------------------------------------
35 |     |
36 |     | You may want to include a single command class without having to load an
37 |     | entire folder. Here you can specify which commands should be added to
38 |     | your list of commands. The console's kernel will try to load them.
39 |     |
40 |     */
41 | 
42 |     'add' => [
43 |         //
44 |     ],
45 | 
46 |     /*
47 |     |--------------------------------------------------------------------------
48 |     | Hidden Commands
49 |     |--------------------------------------------------------------------------
50 |     |
51 |     | Your application commands will always be visible on the application list
52 |     | of commands. But you can still make them "hidden" specifying an array
53 |     | of commands below. All "hidden" commands can still be run/executed.
54 |     |
55 |     */
56 | 
57 |     'hidden' => [
58 |         NunoMaduro\LaravelConsoleSummary\SummaryCommand::class,
59 |         Symfony\Component\Console\Command\DumpCompletionCommand::class,
60 |         Symfony\Component\Console\Command\HelpCommand::class,
61 |         Illuminate\Console\Scheduling\ScheduleRunCommand::class,
62 |         Illuminate\Console\Scheduling\ScheduleListCommand::class,
63 |         Illuminate\Console\Scheduling\ScheduleFinishCommand::class,
64 |         Illuminate\Foundation\Console\VendorPublishCommand::class,
65 |         LaravelZero\Framework\Commands\StubPublishCommand::class,
66 |     ],
67 | 
68 |     /*
69 |     |--------------------------------------------------------------------------
70 |     | Removed Commands
71 |     |--------------------------------------------------------------------------
72 |     |
73 |     | Do you have a service provider that loads a list of commands that
74 |     | you don't need? No problem. Laravel Zero allows you to specify
75 |     | below a list of commands that you don't to see in your app.
76 |     |
77 |     */
78 | 
79 |     'remove' => [
80 |         //
81 |     ],
82 | 
83 | ];
84 | 


--------------------------------------------------------------------------------
/config/view.php:
--------------------------------------------------------------------------------
 1 |  <?php
 2 | 
 3 | return [
 4 |     'paths' => [
 5 |         resource_path('views'),
 6 |     ],
 7 |     'compiled' => \Phar::running()
 8 |         ? getcwd()
 9 |         : env('VIEW_COMPILED_PATH', realpath(storage_path('framework/views'))),
10 | ];
11 | 


--------------------------------------------------------------------------------
/phpunit.xml.dist:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 3 |          xsi:noNamespaceSchemaLocation="./vendor/phpunit/phpunit/phpunit.xsd"
 4 |          bootstrap="vendor/autoload.php"
 5 |          colors="true"
 6 | >
 7 |     <testsuites>
 8 |         <testsuite name="Feature">
 9 |             <directory>./tests/Feature</directory>
10 |         </testsuite>
11 |         <testsuite name="Unit">
12 |             <directory>./tests/Unit</directory>
13 |         </testsuite>
14 |     </testsuites>
15 |     <source>
16 |         <include>
17 |             <directory>./app</directory>
18 |         </include>
19 |     </source>
20 | </phpunit>
21 | 


--------------------------------------------------------------------------------
/resources/views/class-graph.blade.php:
--------------------------------------------------------------------------------
  1 | <!DOCTYPE html>
  2 | <html lang="en">
  3 | 
  4 | <head>
  5 |     <meta charset="UTF-8">
  6 |     <title>Dependency Graph</title>
  7 |     <script src="https://cdnjs.cloudflare.com/ajax/libs/cytoscape/3.21.1/cytoscape.min.js"></script>
  8 |     <style>
  9 |         #cy {
 10 |             width: 100%;
 11 |             height: 80vh;
 12 |             border: 1px solid #ccc;
 13 |             margin: auto;
 14 |         }
 15 | 
 16 |         #legend {
 17 |             display: flex;
 18 |             justify-content: center;
 19 |             margin-top: 10px;
 20 |             font-family: Arial, sans-serif;
 21 |             font-size: 14px;
 22 |         }
 23 | 
 24 |         .legend-item {
 25 |             display: flex;
 26 |             align-items: center;
 27 |             margin: 0 15px;
 28 |         }
 29 | 
 30 |         .color-box {
 31 |             width: 15px;
 32 |             height: 15px;
 33 |             margin-right: 5px;
 34 |             border-radius: 10px;
 35 |         }
 36 | 
 37 |         .color-high {
 38 |             background-color: #d9534f;
 39 |         }
 40 | 
 41 |         .color-medium {
 42 |             background-color: #f0ad4e;
 43 |         }
 44 | 
 45 |         .color-low {
 46 |             background-color: #5cb85c;
 47 |         }
 48 | 
 49 |         .color-edge {
 50 |             background-color: red;
 51 |             width: 30px;
 52 |             height: 3px;
 53 |         }
 54 |     </style>
 55 | </head>
 56 | 
 57 | <body>
 58 |     <div id="cy"></div>
 59 |     <div id="legend">
 60 |         <div class="legend-item">
 61 |             <div class="color-box color-high"></div> High Instability (> 0.8)
 62 |         </div>
 63 |         <div class="legend-item">
 64 |             <div class="color-box color-medium"></div> Medium Instability (> 0.4)
 65 |         </div>
 66 |         <div class="legend-item">
 67 |             <div class="color-box color-low"></div> Low Instability (≤ 0.4)
 68 |         </div>
 69 |         <div class="legend-item">
 70 |             <div class="color-edge"></div> Unstable Dependency (red arrow)
 71 |         </div>
 72 |     </div>
 73 |     <script>
 74 |         var data = {
 75 |             nodes: @json($nodes),
 76 |             edges: @json($edges)
 77 |         };
 78 | 
 79 |         var cy = cytoscape({
 80 |             container: document.getElementById('cy'),
 81 |             elements: {
 82 |                 nodes: data.nodes,
 83 |                 edges: data.edges
 84 |             },
 85 |             style: [{
 86 |                     selector: 'node',
 87 |                     style: {
 88 |                         'background-color': function(ele) {
 89 |                             let instability = ele.data('instability');
 90 |                             return instability > 0.8 ? '#d9534f' :
 91 |                                 instability > 0.4 ? '#f0ad4e' : '#5cb85c';
 92 |                         },
 93 |                         'label': function(ele) {
 94 |                             const fullId = ele.data('id');
 95 |                             return fullId.split('\\').pop();
 96 |                         },
 97 |                         'color': '#333',
 98 |                         'font-size': '10px',
 99 |                         'text-outline-width': 2,
100 |                         'text-outline-color': '#ffffff',
101 |                         'text-valign': 'center',
102 |                         'text-wrap': 'wrap',
103 |                         'text-max-width': '80px'
104 |                     }
105 |                 },
106 |                 {
107 |                     selector: 'edge',
108 |                     style: {
109 |                         'width': 4,
110 |                         'line-color': '#cccccc',
111 |                         'target-arrow-color': '#cccccc',
112 |                         'target-arrow-shape': 'triangle',
113 |                         'curve-style': 'bezier',
114 |                         'opacity': 0.8
115 |                     }
116 |                 },
117 |                 {
118 |                     selector: '.faded',
119 |                     style: {
120 |                         'opacity': 0.3,
121 |                         'text-opacity': 0.1
122 |                     }
123 |                 }
124 |             ],
125 |             layout: {
126 |                 name: 'cose',
127 |                 animate: true,
128 |                 animationDuration: 500
129 |             }
130 |         });
131 | 
132 |         cy.edges().forEach(function(edge) {
133 | 
134 |             var sourceInstability = edge.source().data('instability');
135 |             var targetInstability = edge.target().data('instability');
136 | 
137 |             if (sourceInstability < targetInstability) {
138 |                 edge.style({
139 |                     'line-color': 'red',
140 |                     'target-arrow-color': 'red'
141 |                 });
142 |             }
143 |         });
144 | 
145 |         cy.on('select', 'node', function(evt) {
146 | 
147 |             var node = evt.target;
148 | 
149 |             cy.elements().addClass('faded');
150 |             node.removeClass('faded');
151 |             node.connectedEdges().removeClass('faded');
152 |             node.connectedEdges().connectedNodes().removeClass('faded');
153 |         });
154 | 
155 |         cy.on('unselect', 'node', function() {
156 |             cy.elements().removeClass('faded');
157 |         });
158 |     </script>
159 | </body>
160 | 
161 | </html>


--------------------------------------------------------------------------------
/resources/views/components-graph.blade.php:
--------------------------------------------------------------------------------
  1 | <!DOCTYPE html>
  2 | <html lang="en">
  3 | 
  4 | <head>
  5 |     <meta charset="UTF-8">
  6 |     <title>Module Dependency Graph</title>
  7 |     <script src="https://cdnjs.cloudflare.com/ajax/libs/cytoscape/3.21.1/cytoscape.min.js"></script>
  8 |     <script src="https://unpkg.com/dagre@0.8.5/dist/dagre.min.js"></script>
  9 |     <script src="https://unpkg.com/cytoscape-dagre@2.2.2/cytoscape-dagre.js"></script>
 10 |     <style>
 11 |         #cy {
 12 |             width: 100%;
 13 |             height: 80vh;
 14 |             border: 1px solid #ccc;
 15 |             margin: auto;
 16 |         }
 17 | 
 18 |         #legend {
 19 |             display: flex;
 20 |             justify-content: center;
 21 |             margin-top: 10px;
 22 |             font-family: Arial, sans-serif;
 23 |             font-size: 14px;
 24 |         }
 25 | 
 26 |         .legend-item {
 27 |             display: flex;
 28 |             align-items: center;
 29 |             margin: 0 15px;
 30 |         }
 31 | 
 32 |         .color-box {
 33 |             width: 15px;
 34 |             height: 15px;
 35 |             margin-right: 5px;
 36 |             border-radius: 10px;
 37 |         }
 38 | 
 39 |         .color-high {
 40 |             background-color: #d9534f;
 41 |         }
 42 | 
 43 |         .color-medium {
 44 |             background-color: #f0ad4e;
 45 |         }
 46 | 
 47 |         .color-low {
 48 |             background-color: #5cb85c;
 49 |         }
 50 | 
 51 |         .color-edge {
 52 |             background-color: red;
 53 |             width: 30px;
 54 |             height: 3px;
 55 |         }
 56 |     </style>
 57 | </head>
 58 | 
 59 | <body>
 60 |     <div id="cy"></div>
 61 |     <div id="legend">
 62 |         <div class="legend-item">
 63 |             <div class="color-box color-high"></div> High Instability (> 0.8)
 64 |         </div>
 65 |         <div class="legend-item">
 66 |             <div class="color-box color-medium"></div> Medium Instability (> 0.4)
 67 |         </div>
 68 |         <div class="legend-item">
 69 |             <div class="color-box color-low"></div> Low Instability (≤ 0.4)
 70 |         </div>
 71 |         <div class="legend-item">
 72 |             <div class="color-edge"></div> Unstable Dependency (red arrow)
 73 |         </div>
 74 |     </div>
 75 |     <script>
 76 | 
 77 |         cytoscape.use(cytoscapeDagre);
 78 | 
 79 |         var data = {
 80 |             nodes: @json($nodes),
 81 |             edges: @json($edges)
 82 |         };
 83 | 
 84 |         var cy = cytoscape({
 85 |             container: document.getElementById('cy'),
 86 |             elements: {
 87 |                 nodes: data.nodes,
 88 |                 edges: data.edges
 89 |             },
 90 |             style: [{
 91 |                     selector: 'node',
 92 |                     style: {
 93 |                         'shape': 'round-rectangle',
 94 |                         'width': '100px',
 95 |                         'height': '50px',
 96 |                         'background-color': function(ele) {
 97 |                             let instability = ele.data('instability');
 98 |                             return instability > 0.8 ? '#d9534f' :
 99 |                                 instability > 0.4 ? '#f0ad4e' : '#5cb85c';
100 |                         },
101 |                         'label': function(ele) {
102 |                             const fullId = ele.data('id');
103 |                             return fullId.split('\\').pop();
104 |                         },
105 |                         'color': '#333',
106 |                         'font-size': '12px',
107 |                         'font-weight': 'bold',
108 |                         'text-outline-width': 2,
109 |                         'text-outline-color': '#ffffff',
110 |                         'text-valign': 'center',
111 |                         'text-wrap': 'wrap',
112 |                         'text-max-width': '100px'
113 |                     }
114 |                 },
115 |                 {
116 |                     selector: 'edge',
117 |                     style: {
118 |                         'width': 4,
119 |                         'line-color': '#cccccc',
120 |                         'target-arrow-color': '#cccccc',
121 |                         'target-arrow-shape': 'triangle',
122 |                         'curve-style': 'bezier',
123 |                         'opacity': 0.8
124 |                     }
125 |                 },
126 |                 {
127 |                     selector: '.faded',
128 |                     style: {
129 |                         'opacity': 0.3,
130 |                         'text-opacity': 0.1
131 |                     }
132 |                 }
133 |             ],
134 |             layout: {
135 |                 name: 'dagre',
136 |                 animate: true,
137 |                 animationDuration: 500,
138 |                 nodeSep: 50,
139 |                 rankDir: 'TB'
140 |             }
141 |         });
142 | 
143 |         cy.edges().forEach(function(edge) {
144 |             var sourceInstability = edge.source().data('instability');
145 |             var targetInstability = edge.target().data('instability');
146 | 
147 |             if (sourceInstability < targetInstability) {
148 |                 edge.style({
149 |                     'line-color': 'red',
150 |                     'target-arrow-color': 'red'
151 |                 });
152 |             }
153 |         });
154 | 
155 |         cy.on('select', 'node', function(evt) {
156 |             var node = evt.target;
157 |             cy.elements().addClass('faded');
158 |             node.removeClass('faded');
159 |             node.connectedEdges().removeClass('faded');
160 |             node.connectedEdges().connectedNodes().removeClass('faded');
161 |         });
162 | 
163 |         cy.on('unselect', 'node', function() {
164 |             cy.elements().removeClass('faded');
165 |         });
166 |     </script>
167 | </body>
168 | 
169 | </html>


--------------------------------------------------------------------------------
/storage/app/.gitignore:
--------------------------------------------------------------------------------
1 | *
2 | !.gitignore


--------------------------------------------------------------------------------
/storage/framework/views/.gitignore:
--------------------------------------------------------------------------------
1 | *
2 | !.gitignore


--------------------------------------------------------------------------------
/tests/Builders/AnalyzeMetricBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Tests\Builders;
 4 | 
 5 | use App\Application\Analyze\AnalyzeMetric;
 6 | 
 7 | class AnalyzeMetricBuilder
 8 | {
 9 |     private string $name = 'default';
10 |     private array $dependencies = [];
11 |     private bool $abstract = false;
12 |     private float $efferent = 0;
13 |     private float $afferent = 0;
14 |     private float $instability = 0;
15 |     private int $numberOfAbstractDependencies = 0;
16 |     private float $ratio = 0;
17 | 
18 |     public function withName(string $value): self
19 |     {
20 |         $this->name = $value;
21 | 
22 |         return $this;
23 |     }
24 | 
25 |     public function isAbstract(): self
26 |     {
27 |         $this->abstract = true;
28 | 
29 |         return $this;
30 |     }
31 | 
32 |     public function withDependencies(array $value): self
33 |     {
34 |         $this->dependencies = $value;
35 | 
36 |         return $this;
37 |     }
38 | 
39 |     public function withInstability(float $value): self
40 |     {
41 |         $this->instability = $value;
42 | 
43 |         return $this; 
44 |     }
45 | 
46 |     public function withAbstractnessRatio(float $value): self
47 |     {
48 |         $this->ratio = $value;
49 | 
50 |         return $this;
51 |     }
52 | 
53 |     public function build(): AnalyzeMetric
54 |     {
55 |         return new AnalyzeMetric([
56 |             'name' => $this->name,
57 |             'dependencies' => $this->dependencies,
58 |             'abstract' => $this->abstract,
59 |             'coupling' => [
60 |                 'efferent' => $this->efferent,
61 |                 'afferent' => $this->afferent,
62 |                 'instability' => $this->instability,
63 |             ],
64 |             'abstractness' => [
65 |                 'numberOfAbstractDependencies' => $this->numberOfAbstractDependencies,
66 |                 'ratio' => $this->ratio,
67 |             ],
68 |         ]);
69 |     }
70 | }
71 | 


--------------------------------------------------------------------------------
/tests/Builders/ClassDependenciesBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Tests\Builders;
 4 | 
 5 | use App\Domain\ValueObjects\Fqcn;
 6 | use App\Domain\ValueObjects\IsAbstract;
 7 | use App\Domain\ValueObjects\IsInterface;
 8 | use App\Domain\ValueObjects\Dependencies;
 9 | use App\Domain\Entities\ClassDependencies;
10 | 
11 | class ClassDependenciesBuilder
12 | {
13 |     private string $fqcn = 'App\Domain\Entities\User';
14 |     private array $dependencies = [];
15 |     private bool $isInterface = false;
16 |     private bool $isAbstract = false;
17 | 
18 |     public function withFqcn(string $fqcn): self
19 |     {
20 |         $this->fqcn = $fqcn;
21 | 
22 |         return $this;
23 |     }
24 | 
25 |     public function withDependencies(array $dependencies): self
26 |     {
27 |         $this->dependencies = $dependencies;
28 | 
29 |         return $this;
30 |     }
31 | 
32 |     public function isInterface(): self
33 |     {
34 |         $this->isInterface = true;
35 | 
36 |         return $this;
37 |     }
38 | 
39 |     public function isAbstract(): self
40 |     {
41 |         $this->isAbstract = true;
42 | 
43 |         return $this;
44 |     }
45 | 
46 |     public function build(): ClassDependencies
47 |     {
48 |         return new ClassDependencies(
49 |             new Fqcn($this->fqcn),
50 |             new Dependencies($this->dependencies),
51 |             new IsInterface($this->isInterface),
52 |             new IsAbstract($this->isAbstract),
53 |         );
54 |     }
55 | }
56 | 
57 | 


--------------------------------------------------------------------------------
/tests/Builders/DependencyAggregatorBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Tests\Builders;
 4 | 
 5 | use App\Domain\Entities\ClassDependencies;
 6 | use App\Domain\Aggregators\DependencyAggregator;
 7 | 
 8 | class DependencyAggregatorBuilder
 9 | {
10 |     public function __construct(
11 |         private DependencyAggregator $dependencyAggregator,
12 |         private ClassDependenciesBuilder $classDependenciesBuilder,
13 |     ) {}
14 | 
15 |     public function addOneClassDependencies(): DependencyAggregatorBuilder
16 |     {
17 |         $classDependencies = $this->classDependenciesBuilder->build();
18 | 
19 |         return $this->addClassDependencies($classDependencies);
20 | 
21 |         return $this;
22 |     }
23 | 
24 |     public function addClassDependencies(ClassDependencies $classDependencies): self
25 |     {
26 |         $this->dependencyAggregator->aggregate($classDependencies);
27 | 
28 |         return $this;
29 |     }
30 | 
31 |     public function withManyClassDependencies(array $classDependencies): self
32 |     {
33 |         foreach ($classDependencies as $classDependency) {
34 |             $this->addClassDependencies($classDependency);
35 |         }
36 | 
37 |         return $this;
38 |     }
39 | 
40 |     public function build(): DependencyAggregator
41 |     {
42 |         return $this->dependencyAggregator;
43 |     }
44 | }
45 | 


--------------------------------------------------------------------------------
/tests/Builders/WeaknessResponseBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Tests\Builders;
 4 | 
 5 | class WeaknessResponseBuilder
 6 | {
 7 |     public static function build(): WeaknessResponse
 8 |     {
 9 |         return new WeaknessResponse(1, []);
10 |     }
11 | }
12 | 


--------------------------------------------------------------------------------
/tests/CreatesApplication.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Tests;
 4 | 
 5 | use Illuminate\Contracts\Console\Kernel;
 6 | use Illuminate\Foundation\Application;
 7 | 
 8 | trait CreatesApplication
 9 | {
10 |     /**
11 |      * Creates the application.
12 |      */
13 |     public function createApplication(): Application
14 |     {
15 |         $app = require __DIR__.'/../bootstrap/app.php';
16 | 
17 |         $app->make(Kernel::class)->bootstrap();
18 | 
19 |         return $app;
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/tests/Feature/AnalyzeClassTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | it('can run the analyze:class command', function () {
 4 |     $this->artisan('analyze:class app')->assertSuccessful();
 5 | });
 6 | 
 7 | it('can run the analyze:class command with a custom target', function () {
 8 |     $this->artisan('analyze:class app --target=App\Application\Analyze\AnalyzeAction')->assertSuccessful();
 9 | });
10 | 
11 | it('can run the analyze:class command with only a specific namespace', function () {
12 |     $this->artisan('analyze:class app --only=App\Application')->assertSuccessful();
13 | });
14 | 
15 | it('can run the analyze:class command with exclude a specific namespace', function () {
16 |     $this->artisan('analyze:class app --exclude=App\Application')->assertSuccessful();
17 | });
18 | 
19 | it('can run the analyze:class command with graph', function () {
20 |     $this->artisan('analyze:class app --graph')->assertSuccessful();
21 | })->skip('need to find a way to bypass graph generation');
22 | 


--------------------------------------------------------------------------------
/tests/Feature/CyclicTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | it('can run the cyclic command', function () {
 4 |     $this->artisan('cyclic app')->assertSuccessful();
 5 | });
 6 | 
 7 | it('can run the cyclic command with only option', function () {
 8 |     $this->artisan("cyclic app --only='App\Application'")->assertSuccessful();
 9 | });
10 | 
11 | it('can run the cyclic command with exclude option', function () {
12 |     $this->artisan("cyclic app --exclude='App\Application'")->assertSuccessful();
13 | });
14 | 


--------------------------------------------------------------------------------
/tests/Feature/WeaknessTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | it('can run the weakness command', function () {
 4 |     $this->artisan('weakness app')->assertSuccessful();
 5 | });
 6 | 
 7 | it('can run the weakness command with only option', function () {
 8 |     $this->artisan("weakness app --only='App\Application'")->assertSuccessful();
 9 | });
10 | 
11 | it('can run the weakness command with exclude option', function () {
12 |     $this->artisan("weakness app --exclude='App\Application'")->assertSuccessful();
13 | });
14 | 
15 | it('can run the weakness command with limit option', function () {
16 |     $this->artisan("weakness app --limit=10")->assertSuccessful();
17 | });
18 | 
19 | it('can run the weakness command with min-delta option', function () {
20 |     $this->artisan("weakness app --min-delta=10")->assertSuccessful();
21 | });
22 | 


--------------------------------------------------------------------------------
/tests/Pest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | use Tests\Builders;
 4 | 
 5 | /*
 6 | |--------------------------------------------------------------------------
 7 | | Test Case
 8 | |--------------------------------------------------------------------------
 9 | |
10 | | The closure you provide to your test functions is always bound to a specific PHPUnit test
11 | | case class. By default, that class is "PHPUnit\Framework\TestCase". Of course, you may
12 | | need to change it using the "uses()" function to bind a different classes or traits.
13 | |
14 | */
15 | 
16 | uses(Tests\TestCase::class)->in('Feature');
17 | uses(Tests\TestCase::class)->in('Unit');
18 | 
19 | /*
20 | |--------------------------------------------------------------------------
21 | | Expectations
22 | |--------------------------------------------------------------------------
23 | |
24 | | When you're writing tests, you often need to check that values meet certain conditions. The
25 | | "expect()" function gives you access to a set of "expectations" methods that you can use
26 | | to assert different things. Of course, you may extend the Expectation API at any time.
27 | |
28 | */
29 | 
30 | expect()->extend('toBeOne', function () {
31 |     return $this->toBe(1);
32 | });
33 | 
34 | /*
35 | |--------------------------------------------------------------------------
36 | | Functions
37 | |--------------------------------------------------------------------------
38 | |
39 | | While Pest is very powerful out-of-the-box, you may have some testing code specific to your
40 | | project that you don't want to repeat in every file. Here you can also expose helpers as
41 | | global functions to help you to reduce the number of lines of code in your test files.
42 | |
43 | */
44 | 
45 | function something(): void
46 | {
47 |     // ..
48 | }
49 | 


--------------------------------------------------------------------------------
/tests/TestCase.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Tests;
 4 | 
 5 | use Tests\Builders\AnalyzeMetricBuilder;
 6 | use Tests\Builders\ClassDependenciesBuilder;
 7 | use Tests\Builders\DependencyAggregatorBuilder;
 8 | use LaravelZero\Framework\Testing\TestCase as BaseTestCase;
 9 | 
10 | abstract class TestCase extends BaseTestCase
11 | {
12 |     use CreatesApplication;
13 | 
14 |     public function oneClassDependencies(): ClassDependenciesBuilder
15 |     {
16 |         return new ClassDependenciesBuilder();
17 |     }
18 | 
19 |     public function oneDependencyAggregator(): DependencyAggregatorBuilder
20 |     {
21 |         return app(DependencyAggregatorBuilder::class);
22 |     }
23 | 
24 |     public function oneAnalyzeMetric(): AnalyzeMetricBuilder
25 |     {
26 |         return app(AnalyzeMetricBuilder::class);
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/tests/Unit/Domain/Aggregators/DependencyAggregatorTest.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | test('it calculates the instability correctly', function () {
  4 | 
  5 |     $dependencyAggregator = $this->oneDependencyAggregator()
  6 |         ->withManyClassDependencies([   
  7 |             $this->oneClassDependencies()->withFqcn('A')->withDependencies(['B', 'C'])->build(),
  8 |             $this->oneClassDependencies()->withFqcn('C')->withDependencies(['D'])->build(),
  9 |         ])
 10 |         ->build();
 11 | 
 12 |     $dependencyAggregator->calculateInstability();
 13 | 
 14 |     $metrics = $dependencyAggregator->toArray();
 15 | 
 16 |     expect($metrics['A'])->toMatchArray([
 17 |         'name' => 'A',
 18 |         'coupling' => [
 19 |             'afferent' => 0,
 20 |             'efferent' => 2,
 21 |             'instability' => 1.0,
 22 |         ],
 23 |     ]);
 24 | 
 25 |     expect($metrics['C'])->toMatchArray([
 26 |         'name' => 'C',
 27 |         'coupling' => [
 28 |             'afferent' => 1,
 29 |             'efferent' => 1,
 30 |             'instability' => 0.5,
 31 |         ],
 32 |     ]);
 33 | });
 34 | 
 35 | test('it keeps only classes by given filters', function () {
 36 | 
 37 |     $dependencyAggregator = $this->oneDependencyAggregator()
 38 |         ->withManyClassDependencies([
 39 |             $this->oneClassDependencies()->withFqcn('App\Domain\Aggregators\DependencyAggregator')->build(),
 40 |         ])
 41 |         ->build();
 42 | 
 43 |     $dependencyAggregator->filter(only: ['Domain']);
 44 | 
 45 |     $dependencies = $dependencyAggregator->toArray();
 46 | 
 47 |     expect($dependencies)->toHaveLength(1);
 48 |     expect($dependencies)->toHaveKey('App\Domain\Aggregators\DependencyAggregator');
 49 | });
 50 | 
 51 | test('it filters classes by given exclude filters', function () {
 52 | 
 53 |     $dependencyAggregator = $this->oneDependencyAggregator()
 54 |         ->withManyClassDependencies([
 55 |             $this->oneClassDependencies()->withFqcn('App\Application\Analyze\AnalyzeAction')->build(),
 56 |         ])
 57 |         ->build();
 58 | 
 59 |     $dependencyAggregator->filter(exclude: ['Application']);
 60 | 
 61 |     $dependencies = $dependencyAggregator->toArray();
 62 | 
 63 |     expect($dependencies)->toHaveLength(0);
 64 | });
 65 | 
 66 | test('it calculates the abstractness correctly when class has no dependencies', function () {
 67 | 
 68 |     $dependencyAggregator = $this->oneDependencyAggregator()
 69 |         ->withManyClassDependencies([
 70 |             $this->oneClassDependencies()->withFqcn('A')->build(),
 71 |         ])
 72 |         ->build();
 73 | 
 74 |     $dependencyAggregator->calculateAbstractness();
 75 | 
 76 |     $metrics = $dependencyAggregator->toArray();
 77 | 
 78 |     expect($metrics['A'])->toMatchArray([
 79 |         'name' => 'A',
 80 |         'abstractness' => [
 81 |             'ratio' => 0.0,
 82 |             'numberOfAbstractDependencies' => 0,
 83 |         ],
 84 |     ]);
 85 | });
 86 | 
 87 | test('it calculates the abstractness correctly when class has abstract dependencies', function () {
 88 | 
 89 |     $dependencyAggregator = $this->oneDependencyAggregator()
 90 |         ->withManyClassDependencies([
 91 |             $this->oneClassDependencies()->withFqcn('A')->withDependencies(['B', 'C'])->build(),
 92 |             $this->oneClassDependencies()->withFqcn('B')->isAbstract()->build(),
 93 |             $this->oneClassDependencies()->withFqcn('C')->build(),
 94 |         ])
 95 |         ->build();
 96 | 
 97 |     $dependencyAggregator->calculateAbstractness();
 98 | 
 99 |     $metrics = $dependencyAggregator->toArray();
100 | 
101 |     expect($metrics['A'])->toMatchArray([
102 |         'name' => 'A',
103 |         'abstractness' => [
104 |             'ratio' => 0.5,
105 |             'numberOfAbstractDependencies' => 1,
106 |         ],
107 |     ]);
108 | });


--------------------------------------------------------------------------------
/tests/Unit/Domain/Entities/ClassDependenciesTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | test('it encapsulates the dependencies', function () {
 4 | 
 5 |     $classDependencies = $this->oneClassDependencies()
 6 |         ->withDependencies([
 7 |             'A',
 8 |             'B',
 9 |             'C',
10 |         ])
11 |         ->build();
12 | 
13 |     $dependencies = $classDependencies->getDependencies();
14 | 
15 |     expect($dependencies)->toBe([
16 |         'A',
17 |         'B',
18 |         'C',
19 |     ]);
20 | });
21 | 
22 | test('it returns the correct FQCN', function () {
23 | 
24 |     $classDependencies = $this->oneClassDependencies()
25 |         ->withFqcn('A')
26 |         ->build();
27 | 
28 |     $fqcn = $classDependencies->getName();
29 | 
30 |     expect($fqcn)->toBe('A');
31 | });
32 | 
33 | test('it correctly checks if a class is not a dependency', function () {
34 | 
35 |     $classDependencies = $this->oneClassDependencies()
36 |         ->withFqcn('A')
37 |         ->withDependencies([
38 |             'B',
39 |         ])
40 |         ->build();
41 | 
42 |     $c = $this->oneClassDependencies()
43 |         ->withFqcn('C')
44 |         ->build();
45 | 
46 |     expect($classDependencies->isDependentOn($c))->toBeFalse();
47 | });
48 | 
49 | test('it correctly checks if a class is a dependency', function () {
50 | 
51 |     $classDependencies = $this->oneClassDependencies()
52 |         ->withFqcn('A')
53 |         ->withDependencies([
54 |             'B',
55 |         ])
56 |         ->build();
57 | 
58 |     $b = $this->oneClassDependencies()
59 |         ->withFqcn('B')
60 |         ->build();
61 | 
62 |     expect($classDependencies->isDependentOn($b))->toBeTrue();
63 | });
64 | 
65 | test('it calculates the abstractness correctly', function () {
66 | 
67 |     $classDependencies = $this->oneClassDependencies()
68 |         ->withFqcn('A')
69 |         ->withDependencies([
70 |             'B',
71 |             'C',
72 |             'D',
73 |         ])
74 |         ->build();
75 | 
76 |     $classDependencies->incrementNumberOfAbstractDependencies();
77 |     $classDependencies->incrementNumberOfAbstractDependencies();
78 | 
79 |     $classDependencies->calculateAbstractness();
80 | 
81 |     $abstractness = $classDependencies->toArray()['abstractness'];
82 | 
83 |     expect($abstractness)->toBe([
84 |         'ratio' => 0.67,
85 |         'numberOfAbstractDependencies' => 2,
86 |     ]);
87 | });
88 | 


--------------------------------------------------------------------------------
/tests/Unit/Domain/Services/CyclicDependencyTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | use App\Domain\Services\CyclicDependency;
 4 | 
 5 | test('it detects cyclic dependencies', function () {
 6 | 
 7 |     $dependencyAggregator = $this->oneDependencyAggregator()
 8 |         ->withManyClassDependencies([
 9 |             $this->oneClassDependencies()->withFqcn('A')->withDependencies(['B'])->build(),
10 |             $this->oneClassDependencies()->withFqcn('B')->withDependencies(['C'])->build(),
11 |             $this->oneClassDependencies()->withFqcn('C')->withDependencies(['A'])->build(),
12 |         ])
13 |         ->build();
14 | 
15 |     $cycles = app(CyclicDependency::class)->detect($dependencyAggregator->classes());
16 | 
17 |     $this->assertFalse($cycles->isEmpty());
18 | 
19 |     expect($cycles->all())->toBe([
20 |         ['A', 'B', 'C'],
21 |     ]);
22 | });
23 | 
24 | test('it detects classes with multiple cycles', function () {
25 | 
26 |     $dependencyAggregator = $this->oneDependencyAggregator()
27 |         ->withManyClassDependencies([
28 |             $this->oneClassDependencies()->withFqcn('A')->withDependencies(['B', 'C'])->build(),
29 |             $this->oneClassDependencies()->withFqcn('B')->withDependencies(['A'])->build(),
30 |             $this->oneClassDependencies()->withFqcn('C')->withDependencies(['A'])->build(),
31 |         ])
32 |         ->build();
33 | 
34 |     $cycles = app(CyclicDependency::class)->detect($dependencyAggregator->classes());
35 | 
36 |     $this->assertFalse($cycles->isEmpty());
37 | 
38 |     expect($cycles->all())->toBe([
39 |         ['A', 'B'],
40 |         ['A', 'C'],
41 |     ]);
42 | });


--------------------------------------------------------------------------------
/tests/Unit/Domain/ValueObjects/CouplingTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | use App\Domain\ValueObjects\Coupling;
 4 | 
 5 | test('it increments the coupling', function () {
 6 | 
 7 |     $coupling = new Coupling(afferent: 0, efferent: 0);
 8 | 
 9 |     $coupling->incrementAfferent();
10 |     $coupling->incrementAfferent();
11 |     $coupling->incrementAfferent();
12 | 
13 |     expect($coupling->toArray())->toBe([
14 |         'afferent' => 3,
15 |         'efferent' => 0,
16 |         'instability' => 0.0,
17 |     ]);
18 | });
19 | 
20 | 
21 | it('it calculates instability', function (int $afferent, int $efferent, float $instability) {
22 | 
23 |     $coupling = new Coupling(afferent: $afferent, efferent: $efferent);
24 | 
25 |     $coupling->calculateInstability();
26 | 
27 |     expect($coupling->toArray())->toBe([
28 |         'afferent' => $afferent,
29 |         'efferent' => $efferent,
30 |         'instability' => $instability,
31 |     ]);
32 | 
33 | })->with([
34 |     [0, 0, 0.0],
35 |     [1, 0, 0.0],
36 |     [1, 1, 0.5],
37 |     [2, 1, 0.33],
38 |     [3, 1, 0.25],
39 |     [4, 1, 0.2],
40 |     [5, 1, 0.17],
41 |     [1, 2, 0.67],
42 |     [1, 3, 0.75],
43 |     [1, 4, 0.8],
44 |     [1, 5, 0.83],
45 | ]);
46 | 


--------------------------------------------------------------------------------
/tests/Unit/Domain/ValueObjects/FqcnTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | use App\Domain\ValueObjects\Fqcn;
 4 | 
 5 | test('it able to identify himself', function () {
 6 | 
 7 |     $fqcn = new Fqcn('App\Domain\ValueObjects\Coupling');
 8 | 
 9 |     $looked = $fqcn->looksLike([
10 |         'App\Domain\ValueObjects\Coupling',
11 |         'App\Domain\ValueObjects\Instability',
12 |     ]);
13 | 
14 |     expect($looked)->toBeTrue();
15 | });
16 | 
17 | test('it able of not identifying himself', function () {
18 | 
19 |     $fqcn = new Fqcn('App\Domain\ValueObjects\Coupling');
20 | 
21 |     $looked = $fqcn->looksLike([
22 |         'App\Domain\ValueObjects\Other',
23 |     ]);
24 | 
25 |     expect($looked)->toBeFalse();
26 | });
27 | 


--------------------------------------------------------------------------------
/tests/Unit/Infrastructure/Services/AnalyzerServiceAdapterTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | use App\Domain\Entities\ClassDependencies;
 4 | use Tests\Unit\Infrastructure\Services\FileStub;
 5 | use App\Infrastructure\Analyze\Adapters\Services\AnalyzerServiceAdapter;
 6 | 
 7 | it('can get dependencies', function () {
 8 | 
 9 |     $analyzerServiceAdapter = app(AnalyzerServiceAdapter::class);
10 | 
11 |     $dependencies = $analyzerServiceAdapter->getDependencies(new FileStub('A.php'));
12 | 
13 |     expect($dependencies)->toBeInstanceOf(ClassDependencies::class);
14 | 
15 |     expect($dependencies->toArray()['dependencies'])->toBe(
16 |         [
17 |             'App\Infrastructure\Services\Stubs\B',
18 |             'App\Infrastructure\Services\Stubs\C',
19 |             'App\Infrastructure\Services\Stubs\D',
20 |             'App\Infrastructure\Services\Stubs\E',
21 |             'F',
22 |             'G',
23 |         ]
24 |     );
25 | });
26 | 
27 | it('exclude native PHP dependencies', function () {
28 | 
29 |     $analyzerServiceAdapter = app(AnalyzerServiceAdapter::class);
30 | 
31 |     $dependencies = $analyzerServiceAdapter->getDependencies(new FileStub('Native.php'));
32 | 
33 |     expect($dependencies->hasNoDependencies())->toBeTrue();
34 | });
35 | 


--------------------------------------------------------------------------------
/tests/Unit/Infrastructure/Services/FileStub.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Tests\Unit\Infrastructure\Services;
 4 | 
 5 | use App\Infrastructure\File\Ports\File;
 6 | 
 7 | class FileStub implements File
 8 | {
 9 |     public function __construct(
10 |         private string $path,
11 |     ) {}
12 | 
13 |     public function fullPath(): string
14 |     {
15 |         return __DIR__ . '/Stubs/' . $this->path;
16 |     }
17 | }
18 | 


--------------------------------------------------------------------------------
/tests/Unit/Infrastructure/Services/Stubs/A.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Infrastructure\Services\Stubs;
 4 | 
 5 | use App\Infrastructure\Services\Stubs\B;
 6 | use App\Infrastructure\Services\Stubs\{
 7 |     E,
 8 | };
 9 | use F,G;
10 | 
11 | class A
12 | {
13 |     public function foo(C $c)
14 |     {
15 |         //
16 |     }
17 | 
18 |     public function bar(): D
19 |     {
20 |         //
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/tests/Unit/Infrastructure/Services/Stubs/Native.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace App\Infrastructure\Services\Stubs;
 4 | 
 5 | class Native
 6 | {
 7 |     public function foo(): null
 8 |     {
 9 |         array_map(function () {
10 |             return null;
11 |         }, []);
12 | 
13 |         return null;
14 |     }
15 | }
16 | 


--------------------------------------------------------------------------------
/tests/Unit/Presenter/Calculators/MaintainabilityCalculatorTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | use App\Presenter\Analyze\Shared\Calculators\MaintainabilityCalculator;
 4 | 
 5 | it('calculates the maintainability of a class', function (float $abstractness, float $instability, string $expected) {
 6 | 
 7 |     $calculator = new MaintainabilityCalculator();
 8 | 
 9 |     $analyzeMetric = $this->oneAnalyzeMetric()
10 |         ->withInstability($instability)
11 |         ->withAbstractnessRatio($abstractness)
12 |         ->build();
13 | 
14 |     $maintainability = $calculator->calculate($analyzeMetric);
15 | 
16 |     expect($maintainability)->toBe($expected);
17 | 
18 | })->with([
19 |     [0, 0, 'risky'], // lowly abstract and highly unstable
20 |     [1, 1, 'good'], // highly abstract and highly unstable
21 |     [0, 1, 'suffering'], // lowly abstract and highly unstable
22 |     [1, 0, 'good'], // highly abstract and stable
23 | ]);
24 | 


--------------------------------------------------------------------------------
/tests/Unit/Presenter/ComponentMapperTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | use App\Presenter\Analyze\Component\Shared\Component;
 4 | use App\Presenter\Analyze\Component\Shared\ComponentMapper;
 5 | use App\Presenter\Analyze\Component\Shared\ComponentFactory;
 6 | 
 7 | beforeEach(function () {
 8 |     $this->componentMapper = new ComponentMapper(new ComponentFactory());
 9 | });
10 | 
11 | it('should map metrics to components', function () {
12 |     
13 |     $metrics = [
14 |         'A' => [
15 |             $this->oneAnalyzeMetric()->withName('A\Class1')->build(),
16 |             $this->oneAnalyzeMetric()->withName('A\Class2')->build(),
17 |             $this->oneAnalyzeMetric()->withName('A\Class3')->build(),
18 |         ]
19 |     ];
20 | 
21 |     $components = $this->componentMapper->from($metrics);
22 | 
23 |     expect($components)->toHaveCount(1);
24 |     expect($components[0])->toBeInstanceOf(Component::class);
25 |     expect($components[0]->name())->toBe('A');
26 | });
27 | 
28 | it('should map metrics to components with dependencies', function () {
29 | 
30 |     $metrics = [
31 |         'A' => [
32 |             $this->oneAnalyzeMetric()->withName('A\Class1')->withDependencies(['B\Class2'])->build(),
33 |         ], 
34 |         'B' => [
35 |             //
36 |         ]
37 |     ];
38 | 
39 |     $components = $this->componentMapper->from($metrics);
40 | 
41 |     expect($components)->toHaveCount(2);
42 |     expect($components[0]->dependencies())->toBe(['B']);
43 | });
44 | 
45 | it('should not keep dependencies from unwanted namespaces', function () {
46 | 
47 |     $metrics = [
48 |         'A' => [
49 |             /**
50 |              * This dependency is in an unwanted namespace C
51 |              */
52 |             $this->oneAnalyzeMetric()->withName('A\Class1')->withDependencies(['C\Class2'])->build(),
53 |         ],
54 |         'B' => [
55 |             //
56 |         ]
57 |     ];
58 | 
59 |     $components = $this->componentMapper->from($metrics);
60 | 
61 |     expect($components)->toHaveCount(2);
62 |     expect($components[0]->dependencies())->toBe([]);
63 | });
64 | 
65 | it('should calculate the average abstractness', function () {
66 | 
67 |     $metrics = [
68 |         'A' => [
69 |             $this->oneAnalyzeMetric()->build(),
70 |             $this->oneAnalyzeMetric()->isAbstract()->build(),
71 |             $this->oneAnalyzeMetric()->isAbstract()->build(),
72 |             $this->oneAnalyzeMetric()->isAbstract()->build(),
73 |         ],
74 |     ];
75 | 
76 |     $components = $this->componentMapper->from($metrics);
77 | 
78 |     expect($components[0]->countClasses())->toBe(4);
79 |     expect($components[0]->countAbstractions())->toBe(3);
80 |     expect($components[0]->abstractness())->toBe(0.75);
81 | });
82 | 
83 | it('should calculate the average instability', function () {
84 | 
85 |     $metrics = [
86 |         'A' => [
87 |             $this->oneAnalyzeMetric()->withInstability(0.3)->build(),
88 |             $this->oneAnalyzeMetric()->withInstability(0.7)->build(),
89 |             $this->oneAnalyzeMetric()->withInstability(1)->build(),
90 |         ],
91 |     ];
92 | 
93 |     $components = $this->componentMapper->from($metrics);
94 | 
95 |     expect($components[0]->instability())->toBe(0.67);
96 | });
97 | 


--------------------------------------------------------------------------------
/tests/Unit/Presenter/Filters/TargetFilterTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | use App\Presenter\Analyze\Shared\Filters\Collectors\Depth;
 4 | use App\Presenter\Analyze\Shared\Filters\Collectors\Metrics;
 5 | use App\Presenter\Analyze\Shared\Filters\Transformers\TargetTransformer;
 6 | 
 7 | it('should transform the target', function () {
 8 | 
 9 |     $filter = new TargetTransformer(
10 |         new Depth(),
11 |         new Metrics(),
12 |         'A',
13 |     );
14 | 
15 |     $result = $filter->apply([
16 |         'A' => $this->oneAnalyzeMetric()->withName('A')->withDependencies(['B'])->build(),
17 |         'B' => $this->oneAnalyzeMetric()->withName('B')->build(),
18 |         'C' => $this->oneAnalyzeMetric()->withName('C')->build(),
19 |     ]);
20 | 
21 |     expect($result)->toHaveLength(2);
22 |     expect($result)->toHaveKeys(['A', 'B']);
23 | });
24 | 
25 | it('should throw an exception if the target is not found', function () {
26 |     
27 |     $filter = new TargetTransformer(
28 |         new Depth(),
29 |         new Metrics(),
30 |         'D',
31 |     );  
32 | 
33 |     $filter->apply([]);
34 | 
35 | })->throws(Exception::class, 'Target D not found on metrics, try verify the target name.');
36 | 
37 | it('should stop if the depth limit is reached', function () {
38 | 
39 |     $filter = new TargetTransformer(
40 |         new Depth(),
41 |         new Metrics(),
42 |         'A',
43 |         3,
44 |     );
45 | 
46 |     $result = $filter->apply([
47 |         'A' => $this->oneAnalyzeMetric()->withName('A')->withDependencies(['B'])->build(),
48 |         'B' => $this->oneAnalyzeMetric()->withName('B')->withDependencies(['C'])->build(),
49 |         'C' => $this->oneAnalyzeMetric()->withName('C')->withDependencies(['D'])->build(),
50 |         'D' => $this->oneAnalyzeMetric()->withName('D')->build(),
51 |     ]);
52 | 
53 |     expect($result)->toHaveLength(3);
54 |     expect($result)->toHaveKeys(['A', 'B', 'C']);
55 | });
56 | 


--------------------------------------------------------------------------------
/tests/Unit/Presenter/Formatters/ArrayFormatterTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | use App\Presenter\ArrayFormatter;
 4 | 
 5 | test('it sorts items by a given key', function () {
 6 | 
 7 |     $items = [
 8 |         ['foo' => 1],
 9 |         ['foo' => 2],
10 |     ];
11 | 
12 |     $expected = [
13 |         ['foo' => 2],
14 |         ['foo' => 1],
15 |     ];
16 | 
17 |     expect(ArrayFormatter::sort('foo', $items))->toBe($expected);
18 | });
19 | 
20 | test('it cuts items', function () {
21 | 
22 |     $items = [1, 2, 3, 4, 5];
23 | 
24 |     expect(ArrayFormatter::cut(3, $items))->toBe([1, 2, 3]);
25 | });
26 | 
27 | test('it keep items when limit is null', function () {
28 | 
29 |     $items = [1, 2, 3, 4, 5];
30 | 
31 |     expect(ArrayFormatter::cut(null, $items))->toBe($items);
32 | });
33 | 
34 | test('it filters items by min value', function () {
35 | 
36 |     $items = [
37 |         ['foo' => 1],
38 |         ['foo' => 2],
39 |         ['foo' => 3],
40 |     ];
41 | 
42 |     $expected = [
43 |         ['foo' => 2],
44 |         ['foo' => 3],
45 |     ];
46 | 
47 |     expect(ArrayFormatter::filterByMinValue('foo', 2, $items))->toBe($expected);
48 | });
49 | 
50 | test('it keeps items when min value is null', function () {
51 | 
52 |     $items = [
53 |         ['foo' => 1],
54 |         ['foo' => 2],
55 |         ['foo' => 3],
56 |     ];
57 | 
58 |     expect(ArrayFormatter::filterByMinValue('foo', null, $items))->toBe($items);
59 | });
60 | 


--------------------------------------------------------------------------------
/tests/Unit/Presenter/Formatters/NameFormatterTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | use App\Presenter\NameFormatter;
 4 | 
 5 | test('it formats class names', function () {
 6 |     expect(NameFormatter::className('App\Domain\Services\CyclicDependency'))->toBe('CyclicDependency');
 7 | });
 8 | 
 9 | test('it formats human readable names', function () {
10 |     expect(NameFormatter::humanReadable('App\Domain\Services\CyclicDependency'))->toBe('Services\\CyclicDependency');
11 | });
12 | 
13 | test('it keeps short names', function () {
14 |     expect(NameFormatter::humanReadable('App\Foo'))->toBe('App\Foo');
15 | });
16 | 


--------------------------------------------------------------------------------
/tests/Unit/Presenter/Helpers/CycleHelperTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | use App\Presenter\Cyclic\Summary\CycleHelper;
 4 | 
 5 | test('it formats a cycle', function () {
 6 | 
 7 |     $cycle = ['A', 'B', 'C'];
 8 | 
 9 |     $formatted = CycleHelper::through($cycle);
10 | 
11 |     expect($formatted)->toBe('A -> B -> C -> A');
12 | });
13 | 
14 | test('it formats a cycle with readable names', function () {
15 | 
16 |     $cycle = [
17 |         'App\Domain\Services\BarService',
18 |         'App\Domain\Services\FooService',
19 |     ];
20 | 
21 |     $formatted = CycleHelper::through($cycle);
22 | 
23 |     expect($formatted)->toBe('Services\BarService -> Services\FooService -> Services\BarService');
24 | });
25 | 


--------------------------------------------------------------------------------
/tests/Unit/Presenter/WeaknessSummaryPresenterTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | use App\Application\Weakness\WeaknessResponse;
 4 | use Tests\Unit\Presenter\WeaknessSummaryViewSpy;
 5 | use App\Presenter\Weakness\Summary\SummarySettings;
 6 | use App\Presenter\Weakness\Summary\SummaryPresenter;
 7 | 
 8 | it('can be instantiated', function () {
 9 | 
10 |     $presenter = new SummaryPresenter(
11 |         new SummarySettings(),
12 |         $summarySpy = new WeaknessSummaryViewSpy(),
13 |     );
14 | 
15 |     $presenter->present(new WeaknessResponse(
16 |         1,
17 |         [
18 |             [
19 |                 'class' => 'ClassA',
20 |                 'class_instability' => 0.5,
21 |                 'dependency' => 'ClassB',
22 |                 'dependency_instability' => 0.8,
23 |                 'delta' => 0.3,
24 |             ],
25 |         ],
26 |     ));
27 | 
28 |     expect($summarySpy->showTableHasBeenCalled)->toBeTrue();
29 |     expect($summarySpy->totalClasses)->toBe(1);
30 |     expect($summarySpy->delta)->toBe(0.0);
31 | });
32 | 


--------------------------------------------------------------------------------
/tests/Unit/Presenter/WeaknessSummaryViewSpy.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Tests\Unit\Presenter;
 4 | 
 5 | use App\Presenter\Weakness\Summary\SummaryView;
 6 | use App\Presenter\Weakness\Summary\SummaryViewModel;
 7 | 
 8 | class WeaknessSummaryViewSpy extends SummaryView
 9 | {
10 |     public bool $showTableHasBeenCalled = false;
11 |     public int $totalClasses = 0;
12 |     public float $delta = 0;
13 | 
14 |     protected function showTable(SummaryViewModel $viewModel): void
15 |     {
16 |         $this->showTableHasBeenCalled = true;
17 |         $this->totalClasses = $viewModel->totalClasses;
18 |         $this->delta = $viewModel->delta;
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------