Section::generate() - Code Metrics - Cecilapp/Cecil - Measure and Improve Code Quality continuously with Scrutinizer

Section::generate() F
last analyzed 2025-08-14 11:38 UTC

↳ Parent: Section

Complexity

Conditions	19
Paths	780

Size

Total Lines	79
Code Lines	46

Duplication

Lines	0
Ratio	0 %

Importance

Changes

Metric	Value
cc	19
eloc	46
nc	780
nop	0
dl	0
loc	79
rs	0.6555
c	0
b	0
f	0

How to fix Long Method Complexity

<?php

/**
 * This file is part of Cecil.
 *
 * (c) Arnaud Ligny <[email protected]>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

declare(strict_types=1);

namespace Cecil\Generator;

use Cecil\Collection\Page\Collection as PagesCollection;
use Cecil\Collection\Page\Page;
use Cecil\Collection\Page\Type;
use Cecil\Exception\RuntimeException;

/**
 * Section generator class.
 *
 * This class is responsible for generating sections from the pages in the builder.
 * It identifies sections based on the 'section' variable in each page, and
 * creates a new page for each section. The generated pages are added to the
 * collection of generated pages. It also handles sorting of subpages and
 * adding navigation links (next and previous) to the section pages.
 */
class Section extends AbstractGenerator implements GeneratorInterface
{
    /**
     * {@inheritdoc}
     */
    public function generate(): void
    {
        $sections = [];

        // identifying sections from all pages
        /** @var Page $page */
        foreach ($this->builder->getPages() ?? [] as $page) {
            // top level (root) sections
            if ($page->getSection()) {
                // do not add "not published" and "not excluded" pages to its section
                if (
                    $page->getVariable('published') !== true
                    || ($page->getVariable('excluded') || $page->getVariable('exclude'))
                ) {
                    continue;
                }
                $sections[$page->getSection()][$page->getVariable('language', $this->config->getLanguageDefault())][] = $page;
            }
        }

        // adds each section to pages collection
        if (\count($sections) > 0) {
            $menuWeight = 100;

            foreach ($sections as $section => $languages) {
                foreach ($languages as $language => $pagesAsArray) {
                    $pageId = $path = Page::slugify($section);
                    if ($language != $this->config->getLanguageDefault()) {
                        $pageId = "$language/$pageId";
                    }
                    $page = (new Page($pageId))->setVariable('title', ucfirst($section))
                        ->setPath($path);
                    if ($this->builder->getPages()->has($pageId)) {
                        $page = clone $this->builder->getPages()->get($pageId);
                    }
                    $subPages = new PagesCollection("section-$pageId", $pagesAsArray);
                    // cascade variables
                    if ($page->hasVariable('cascade')) {
                        $cascade = $page->getVariable('cascade');
                        if (\is_array($cascade)) {
                            $subPages->map(function (Page $page) use ($cascade) {
                                foreach ($cascade as $key => $value) {
                                    if (!$page->hasVariable($key)) {
                                        $page->setVariable($key, $value);
                                    }
                                }
                            });
                        }
                    }
                    // sorts pages
                    $pages = Section::sortSubPages($this->config, $page, $subPages);
                    // adds navigation links (excludes taxonomy pages)
                    $sortBy = $page->getVariable('sortby')['variable'] ?? $page->getVariable('sortby') ?? $this->config->get('pages.sortby')['variable'] ?? $this->config->get('pages.sortby') ?? 'date';
                    if (!\in_array($page->getId(), array_keys((array) $this->config->get('taxonomies')))) {
                        $this->addNavigationLinks($pages, $sortBy, $page->getVariable('circular') ?? false);
                    }
                    // creates page for each section
                    $page->setType(Type::SECTION->value)
                        ->setSection($path)
                        ->setPages($pages)
                        ->setVariable('language', $language)
                        ->setVariable('date', $pages->first()->getVariable('date'))
                        ->setVariable('langref', $path);
                    // human readable title
                    if ($page->getVariable('title') == 'index') {
                        $page->setVariable('title', $section);
                    }
                    // default menu
                    if (!$page->getVariable('menu')) {
                        $page->setVariable('menu', ['main' => ['weight' => $menuWeight]]);
                    }

                    try {
                        $this->generatedPages->add($page);
                    } catch (\DomainException) {
                        $this->generatedPages->replace($page->getId(), $page);
                    }
                }
                $menuWeight += 10;
            }
        }
    }

    /**
     * Sorts subpages.
     */
    public static function sortSubPages(\Cecil\Config $config, Page $page, PagesCollection $subPages): PagesCollection
    {
        $subPages = $subPages->sortBy($config->get('pages.sortby'));
        if ($page->hasVariable('sortby')) {
            try {
                $subPages = $subPages->sortBy($page->getVariable('sortby'));
            } catch (RuntimeException $e) {
                throw new RuntimeException(\sprintf('In page "%s", %s', $page->getId(), $e->getMessage()));
            }
        }

        return $subPages;
    }

    /**
     * Adds navigation (next and prev) to section subpages.
     */
    protected function addNavigationLinks(PagesCollection $pages, string|null $sortBy = null, bool $circular = false): void
    {
        $pagesAsArray = $pages->toArray();
        if ($sortBy === null || $sortBy == 'date' || $sortBy == 'updated') {
            $pagesAsArray = array_reverse($pagesAsArray);
        }
        $count = \count($pagesAsArray);
        if ($count > 1) {
            foreach ($pagesAsArray as $position => $page) {
                switch ($position) {
                    case 0: // first
                        if ($circular) {
                            $page->setVariables([
                                'prev' => $pagesAsArray[$count - 1],
                            ]);
                        }
                        $page->setVariables([
                            'next' => $pagesAsArray[$position + 1],
                        ]);
                        break;
                    case $count - 1: // last
                        $page->setVariables([
                            'prev' => $pagesAsArray[$position - 1],
                        ]);
                        if ($circular) {
                            $page->setVariables([
                                'next' => $pagesAsArray[0],
                            ]);
                        }
                        break;
                    default:
                        $page->setVariables([
                            'prev' => $pagesAsArray[$position - 1],
                            'next' => $pagesAsArray[$position + 1],
                        ]);
                        break;
                }
                $this->generatedPages->add($page);
            }
        }
    }
}


1			<?php
2
3			/**
4			* This file is part of Cecil.
5			*
6			* (c) Arnaud Ligny <[email protected]>
7			*
8			* For the full copyright and license information, please view the LICENSE
9			* file that was distributed with this source code.
10			*/
11
12			declare(strict_types=1);
13
14			namespace Cecil\Generator;
15
16			use Cecil\Collection\Page\Collection as PagesCollection;
17			use Cecil\Collection\Page\Page;
18			use Cecil\Collection\Page\Type;
19			use Cecil\Exception\RuntimeException;
20
21			/**
22			* Section generator class.
23			*
24			* This class is responsible for generating sections from the pages in the builder.
25			* It identifies sections based on the 'section' variable in each page, and
26			* creates a new page for each section. The generated pages are added to the
27			* collection of generated pages. It also handles sorting of subpages and
28			* adding navigation links (next and previous) to the section pages.
29			*/
30			class Section extends AbstractGenerator implements GeneratorInterface
31			{
32			/**
33			* {@inheritdoc}
34			*/
35			public function generate(): void
36			{
37			$sections = [];
38
39			// identifying sections from all pages
40			/** @var Page $page */
41			foreach ($this->builder->getPages() ?? [] as $page) {
42			// top level (root) sections
43			if ($page->getSection()) {
44			// do not add "not published" and "not excluded" pages to its section
45			if (
46			$page->getVariable('published') !== true
47			\|\| ($page->getVariable('excluded') \|\| $page->getVariable('exclude'))
48			) {
49			continue;
50			}
51			$sections[$page->getSection()][$page->getVariable('language', $this->config->getLanguageDefault())][] = $page;
52			}
53			}
54
55			// adds each section to pages collection
56			if (\count($sections) > 0) {
57			$menuWeight = 100;
58
59			foreach ($sections as $section => $languages) {
60			foreach ($languages as $language => $pagesAsArray) {
61			$pageId = $path = Page::slugify($section);
62			if ($language != $this->config->getLanguageDefault()) {
63			$pageId = "$language/$pageId";
64			}
65			$page = (new Page($pageId))->setVariable('title', ucfirst($section))
66			->setPath($path);
67			if ($this->builder->getPages()->has($pageId)) {
68			$page = clone $this->builder->getPages()->get($pageId);
69			}
70			$subPages = new PagesCollection("section-$pageId", $pagesAsArray);
71			// cascade variables
72			if ($page->hasVariable('cascade')) {
73			$cascade = $page->getVariable('cascade');
74			if (\is_array($cascade)) {
75			$subPages->map(function (Page $page) use ($cascade) {
76			foreach ($cascade as $key => $value) {
77			if (!$page->hasVariable($key)) {
78			$page->setVariable($key, $value);
79			}
80			}
81			});
82			}
83			}
84			// sorts pages
85			$pages = Section::sortSubPages($this->config, $page, $subPages);
86			// adds navigation links (excludes taxonomy pages)
87			$sortBy = $page->getVariable('sortby')['variable'] ?? $page->getVariable('sortby') ?? $this->config->get('pages.sortby')['variable'] ?? $this->config->get('pages.sortby') ?? 'date';
88			if (!\in_array($page->getId(), array_keys((array) $this->config->get('taxonomies')))) {
89			$this->addNavigationLinks($pages, $sortBy, $page->getVariable('circular') ?? false);
90			}
91			// creates page for each section
92			$page->setType(Type::SECTION->value)
93			->setSection($path)
94			->setPages($pages)
95			->setVariable('language', $language)
96			->setVariable('date', $pages->first()->getVariable('date'))
97			->setVariable('langref', $path);
98			// human readable title
99			if ($page->getVariable('title') == 'index') {
100			$page->setVariable('title', $section);
101			}
102			// default menu
103			if (!$page->getVariable('menu')) {
104			$page->setVariable('menu', ['main' => ['weight' => $menuWeight]]);
105			}
106
107			try {
108			$this->generatedPages->add($page);
109			} catch (\DomainException) {
110			$this->generatedPages->replace($page->getId(), $page);
111			}
112			}
113			$menuWeight += 10;
114			}
115			}
116			}
117
118			/**
119			* Sorts subpages.
120			*/
121			public static function sortSubPages(\Cecil\Config $config, Page $page, PagesCollection $subPages): PagesCollection
122			{
123			$subPages = $subPages->sortBy($config->get('pages.sortby'));
124			if ($page->hasVariable('sortby')) {
125			try {
126			$subPages = $subPages->sortBy($page->getVariable('sortby'));
127			} catch (RuntimeException $e) {
128			throw new RuntimeException(\sprintf('In page "%s", %s', $page->getId(), $e->getMessage()));
129			}
130			}
131
132			return $subPages;
133			}
134
135			/**
136			* Adds navigation (next and prev) to section subpages.
137			*/
138			protected function addNavigationLinks(PagesCollection $pages, string\|null $sortBy = null, bool $circular = false): void
139			{
140			$pagesAsArray = $pages->toArray();
141			if ($sortBy === null \|\| $sortBy == 'date' \|\| $sortBy == 'updated') {
142			$pagesAsArray = array_reverse($pagesAsArray);
143			}
144			$count = \count($pagesAsArray);
145			if ($count > 1) {
146			foreach ($pagesAsArray as $position => $page) {
147			switch ($position) {
148			case 0: // first
149			if ($circular) {
150			$page->setVariables([
151			'prev' => $pagesAsArray[$count - 1],
152			]);
153			}
154			$page->setVariables([
155			'next' => $pagesAsArray[$position + 1],
156			]);
157			break;
158			case $count - 1: // last
159			$page->setVariables([
160			'prev' => $pagesAsArray[$position - 1],
161			]);
162			if ($circular) {
163			$page->setVariables([
164			'next' => $pagesAsArray[0],
165			]);
166			}
167			break;
168			default:
169			$page->setVariables([
170			'prev' => $pagesAsArray[$position - 1],
171			'next' => $pagesAsArray[$position + 1],
172			]);
173			break;
174			}
175			$this->generatedPages->add($page);
176			}
177			}
178			}
179			}
180

Cecilapp / Cecil

Section::generate() F last analyzed 2025-08-14 11:38 UTC

Complexity

Size

Duplication

Importance

How to fix Long Method Complexity

Long Method

Duplication Side-by-Side

Filter issues like

Section::generate() F
last analyzed 2025-08-14 11:38 UTC