TailwindCSS::removeClassesOverflow() - Code Metrics - Inspection of "add new archive" - godbout/tailwindcss-dash-docset - Measure and Improve Code Quality continuously with Scrutinizer

Passed

Push — master ( ef8213...362d9b )

by Guillaume

created 2022-02-01 08:55 UTC

TailwindCSS::removeClassesOverflow() A

↳ Parent: TailwindCSS

Complexity

Conditions	1
Paths	1

Size

Total Lines	10
Code Lines	6

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	7
CRAP Score	1

Importance

Changes	1
Bugs	0	Features	0

Metric	Value
cc	1
eloc	6
c	1
b	0
f	0
nc	1
nop	1
dl	0
loc	10
ccs	7
cts	7
cp	1
crap	1
rs	10

<?php

namespace App\Docsets;

use Godbout\DashDocsetBuilder\Docsets\BaseDocset;
use Illuminate\Support\Collection;
use Illuminate\Support\Facades\Storage;
use Illuminate\Support\Str;
use Wa72\HtmlPageDom\HtmlPageCrawler;

class TailwindCSS extends BaseDocset
{
    public const CODE = 'tailwindcss';
    public const NAME = 'Tailwind CSS';
    public const URL = 'tailwindcss.com';
    public const INDEX = 'docs/installation.html';
    public const PLAYGROUND = 'https://play.tailwindcss.com/';
    public const ICON_16 = 'favicon-16x16.png';
    public const ICON_32 = 'favicon-32x32.png';
    public const EXTERNAL_DOMAINS = [
    ];


    public function grab(): bool
    {
        $toIgnore = implode('|', [
            'blog.tailwindcss.com',
            'v1.tailwindcss.com',
            'v2.tailwindcss.com'
        ]);

        system(
            "echo; wget tailwindcss.com/docs \
                --mirror \
                --trust-server-names \
                --reject-regex='{$toIgnore}' \
                --page-requisites \
                --adjust-extension \
                --convert-links \
                --span-hosts \
                --domains={$this->externalDomains()} \
                --directory-prefix=storage/{$this->downloadedDirectory()} \
                -e robots=off \
                --quiet \
                --show-progress",
            $result
        );

        return $result === 0;
    }

    public function entries(string $file): Collection
    {
        $crawler = HtmlPageCrawler::create(Storage::get($file));

        $entries = collect();

        $entries = $entries->union($this->resourceEntries($crawler, $file));
        $entries = $entries->union($this->guideEntries($crawler, $file));
        $entries = $entries->union($this->sectionEntries($crawler, $file));

        return $entries;
    }

    protected function resourceEntries(HtmlPageCrawler $crawler, string $file)
    {
        $entries = collect();

        if (Str::contains($file, "{$this->url()}/resources.html")) {
            $crawler->filter('h2')->each(function (HtmlPageCrawler $node) use ($entries, $file) {
                $entries->push([
                    'name' => $this->cleanAnchorText($node->text()),
                    'type' => 'Resource',
                    'path' => Str::after($file . '#' . Str::slug($node->text()), $this->innerDirectory()),
                ]);
            });

            $crawler->filter('h3')->each(function (HtmlPageCrawler $node) use ($entries, $file) {
                $entries->push([
                    'name' => $this->cleanAnchorText($node->text()),
                    'type' => 'Section',
                    'path' => Str::after($file . '#' . Str::slug($node->text()), $this->innerDirectory()),
                ]);
            });

            return $entries;
        }
    }

    protected function guideEntries(HtmlPageCrawler $crawler, string $file)
    {
        $entries = collect();

        if (Str::contains($file, "{$this->url()}/docs.html")) {
            $itemsToIgnore = collect(['Release Notes', 'Typography', 'Forms', 'Aspect Ratio', 'Line Clamp']);

            $crawler
                ->filter('nav#nav li.mt-8 a')
                ->each(function (HtmlPageCrawler $node) use ($entries, $itemsToIgnore) {
                    if (! $itemsToIgnore->contains($node->text())) {
                        $entries->push([
                            'name' => trim($node->text()),
                            'type' => 'Guide',
                            'path' => $this->url() . '/' . $node->attr('href'),
                        ]);
                    }
                });
        }

        return $entries;
    }

    protected function sectionEntries(HtmlPageCrawler $crawler, string $file)
    {
        $entries = collect();

        $crawler->filter('h2')->each(function (HtmlPageCrawler $node) use ($entries, $file) {
            $entries->push([
                'name' => $this->cleanAnchorText($node->text()),
                'type' => 'Section',
                'path' => Str::after($file . '#' . Str::slug($node->text()), $this->innerDirectory()),
            ]);
        });

        return $entries;
    }

    public function format(string $file): string
    {
        $crawler = HtmlPageCrawler::create(Storage::get($file));

        $this->removeTopbar($crawler);
        $this->removeLeftSidebar($crawler);
        $this->removeRightSidebar($crawler);
        $this->removeClassesOverflow($crawler);

        $this->updateContainerWidth($crawler);
        $this->removeFooter($crawler);

        $this->ignoreDarkModeForSomeColors($crawler);

        $this->removeUnwantedJavaScript($crawler);

        $this->insertOnlineRedirection($crawler, $file);
        $this->insertDashTableOfContents($crawler, $file);

        return $crawler->saveHTML();
    }

    protected function removeTopbar(HtmlPageCrawler $crawler)
    {
        $crawler->filter('div.sticky.top-0')->remove();
    }

    protected function removeLeftSidebar(HtmlPageCrawler $crawler)
    {
        $crawler->filter('div.hidden.fixed.z-20.inset-0.py-10.px-8.overflow-y-auto')->remove();
    }

    protected function removeRightSidebar(HtmlPageCrawler $crawler)
    {
        $crawler->filter('div.fixed.z-20.bottom-0.py-10.px-8.overflow-y-auto.hidden')->remove();
    }

    protected function removeClassesOverflow(HtmlPageCrawler $crawler)
    {
        $crawler->filter('#class-reference + div')
            ->removeClass('overflow-hidden')
            ->removeClass('lg:overflow-auto')
            ->addClass('overflow-auto')
        ;

        $crawler->filter('#class-reference ~ div:nth-of-type(2)')
            ->remove()
        ;
    }

    protected function updateContainerWidth(HtmlPageCrawler $crawler)
    {
        $crawler->filter('div.max-w-8xl.mx-auto.px-4 > div:first-child')
            ->removeClass('lg:pl-[19.5rem]')
        ;
        $crawler->filter('div.max-w-3xl.mx-auto.pt-10')
            ->removeClass('max-w-3xl')
            ->removeClass('mx-auto')
            ->removeClass('xl:max-w-none')
            ->removeClass('xl:mr-[15.5rem]')
            ->removeClass('xl:pr-16')
        ;
    }

    protected function removeFooter(HtmlPageCrawler $crawler)
    {
        $crawler->filter('div.pt-10.pb-28.border-t.border-gray-200.justify-between.text-gray-500')
            ->remove()
        ;
    }

    protected function ignoreDarkModeForSomeColors(HtmlPageCrawler $crawler)
    {
        $this->ignoreDarkModeForDefaultColorPaletteSection($crawler);
        $this->ignoreDarkModeForVariousColorTables($crawler);
    }

    protected function ignoreDarkModeForDefaultColorPaletteSection(HtmlPageCrawler $crawler)
    {
        $crawler->filter('div.h-10.w-full.rounded.ring-1.ring-inset')->addClass('dash-ignore-dark-mode');
    }

    protected function ignoreDarkModeForVariousColorTables(HtmlPageCrawler $crawler)
    {
        $crawler->filter('h2 + div td:last-child')->addClass('dash-ignore-dark-mode');
    }

    protected function removeUnwantedJavaScript(HtmlPageCrawler $crawler)
    {
        $crawler->filter('script')->remove();
    }

    protected function insertOnlineRedirection(HtmlPageCrawler $crawler, string $file)
    {
        $onlineUrl = Str::substr(Str::after($file, $this->innerDirectory()), 1, -5);

        $crawler->filter('html')->prepend("<!-- Online page at https://$onlineUrl -->");
    }

    protected function insertDashTableOfContents(HtmlPageCrawler $crawler, string $file)
    {
        if (! Str::contains($file, "{$this->url()}/docs.html")) {
            $crawler->filter('body')
                ->before('<a name="//apple_ref/cpp/Section/Top" class="dashAnchor"></a>');

            $crawler->filter('h2, h3')->each(function (HtmlPageCrawler $node) {
                $node->prepend(
                    '<a id="' . Str::slug($node->text()) . '" name="//apple_ref/cpp/Section/' . rawurlencode($this->cleanAnchorText($node->text())) . '" class="dashAnchor"></a>'
                );
            });
        }
    }

    protected function cleanAnchorText($anchorText)
    {
        return trim(preg_replace('/\s+/', ' ', $anchorText));
    }
}


1		<?php
2
3		namespace App\Docsets;
4
5		use Godbout\DashDocsetBuilder\Docsets\BaseDocset;
6		use Illuminate\Support\Collection;
7		use Illuminate\Support\Facades\Storage;
8		use Illuminate\Support\Str;
9		use Wa72\HtmlPageDom\HtmlPageCrawler;
10
11		class TailwindCSS extends BaseDocset
12		{
13		public const CODE = 'tailwindcss';
14		public const NAME = 'Tailwind CSS';
15		public const URL = 'tailwindcss.com';
16		public const INDEX = 'docs/installation.html';
17		public const PLAYGROUND = 'https://play.tailwindcss.com/';
18		public const ICON_16 = 'favicon-16x16.png';
19		public const ICON_32 = 'favicon-32x32.png';
20		public const EXTERNAL_DOMAINS = [
21		];
22
23
24		public function grab(): bool
25		{
26		$toIgnore = implode('\|', [
27		'blog.tailwindcss.com',
28		'v1.tailwindcss.com',
29		'v2.tailwindcss.com'
30		]);
31
32		system(
33		"echo; wget tailwindcss.com/docs \
34		--mirror \
35		--trust-server-names \
36		--reject-regex='{$toIgnore}' \
37		--page-requisites \
38		--adjust-extension \
39		--convert-links \
40		--span-hosts \
41		--domains={$this->externalDomains()} \
42		--directory-prefix=storage/{$this->downloadedDirectory()} \
43		-e robots=off \
44		--quiet \
45		--show-progress",
46		$result
47		);
48
49		return $result === 0;
50		}
51
52	16	public function entries(string $file): Collection
53		{
54	16	$crawler = HtmlPageCrawler::create(Storage::get($file));
55
56	16	$entries = collect();
57
58	16	$entries = $entries->union($this->resourceEntries($crawler, $file));
59	16	$entries = $entries->union($this->guideEntries($crawler, $file));
60	16	$entries = $entries->union($this->sectionEntries($crawler, $file));
61
62	16	return $entries;
63		}
64
65	16	protected function resourceEntries(HtmlPageCrawler $crawler, string $file)
66		{
67	16	$entries = collect();
68
69	16	if (Str::contains($file, "{$this->url()}/resources.html")) {
70	16	$crawler->filter('h2')->each(function (HtmlPageCrawler $node) use ($entries, $file) {
71	16	$entries->push([
72	16	'name' => $this->cleanAnchorText($node->text()),
73	16	'type' => 'Resource',
74	16	'path' => Str::after($file . '#' . Str::slug($node->text()), $this->innerDirectory()),
75		]);
76	16	});
77
78	16	$crawler->filter('h3')->each(function (HtmlPageCrawler $node) use ($entries, $file) {
79	16	$entries->push([
80	16	'name' => $this->cleanAnchorText($node->text()),
81	16	'type' => 'Section',
82	16	'path' => Str::after($file . '#' . Str::slug($node->text()), $this->innerDirectory()),
83		]);
84	16	});
85
86	16	return $entries;
87		}
88	16	}
89
90	16	protected function guideEntries(HtmlPageCrawler $crawler, string $file)
91		{
92	16	$entries = collect();
93
94	16	if (Str::contains($file, "{$this->url()}/docs.html")) {
95	8	$itemsToIgnore = collect(['Release Notes', 'Typography', 'Forms', 'Aspect Ratio', 'Line Clamp']);
96
97		$crawler
98	8	->filter('nav#nav li.mt-8 a')
99	8	->each(function (HtmlPageCrawler $node) use ($entries, $itemsToIgnore) {
100	8	if (! $itemsToIgnore->contains($node->text())) {
101	8	$entries->push([
102	8	'name' => trim($node->text()),
103	8	'type' => 'Guide',
104	8	'path' => $this->url() . '/' . $node->attr('href'),
105		]);
106		}
107	8	});
108		}
109
110	16	return $entries;
111		}
112
113	16	protected function sectionEntries(HtmlPageCrawler $crawler, string $file)
114		{
115	16	$entries = collect();
116
117	16	$crawler->filter('h2')->each(function (HtmlPageCrawler $node) use ($entries, $file) {
118	16	$entries->push([
119	16	'name' => $this->cleanAnchorText($node->text()),
120	16	'type' => 'Section',
121	16	'path' => Str::after($file . '#' . Str::slug($node->text()), $this->innerDirectory()),
122		]);
123	16	});
124
125	16	return $entries;
126		}
127
128	16	public function format(string $file): string
129		{
130	16	$crawler = HtmlPageCrawler::create(Storage::get($file));
131
132	16	$this->removeTopbar($crawler);
133	16	$this->removeLeftSidebar($crawler);
134	16	$this->removeRightSidebar($crawler);
135	16	$this->removeClassesOverflow($crawler);
136
137	16	$this->updateContainerWidth($crawler);
138	16	$this->removeFooter($crawler);
139
140	16	$this->ignoreDarkModeForSomeColors($crawler);
141
142	16	$this->removeUnwantedJavaScript($crawler);
143
144	16	$this->insertOnlineRedirection($crawler, $file);
145	16	$this->insertDashTableOfContents($crawler, $file);
146
147	16	return $crawler->saveHTML();
148		}
149
150	16	protected function removeTopbar(HtmlPageCrawler $crawler)
151		{
152	16	$crawler->filter('div.sticky.top-0')->remove();
153	16	}
154
155	16	protected function removeLeftSidebar(HtmlPageCrawler $crawler)
156		{
157	16	$crawler->filter('div.hidden.fixed.z-20.inset-0.py-10.px-8.overflow-y-auto')->remove();
158	16	}
159
160	16	protected function removeRightSidebar(HtmlPageCrawler $crawler)
161		{
162	16	$crawler->filter('div.fixed.z-20.bottom-0.py-10.px-8.overflow-y-auto.hidden')->remove();
163	16	}
164
165	16	protected function removeClassesOverflow(HtmlPageCrawler $crawler)
166		{
167	16	$crawler->filter('#class-reference + div')
168	16	->removeClass('overflow-hidden')
169	16	->removeClass('lg:overflow-auto')
170	16	->addClass('overflow-auto')
171		;
172
173	16	$crawler->filter('#class-reference ~ div:nth-of-type(2)')
174	16	->remove()
175		;
176	16	}
177
178	16	protected function updateContainerWidth(HtmlPageCrawler $crawler)
179		{
180	16	$crawler->filter('div.max-w-8xl.mx-auto.px-4 > div:first-child')
181	16	->removeClass('lg:pl-[19.5rem]')
182		;
183	16	$crawler->filter('div.max-w-3xl.mx-auto.pt-10')
184	16	->removeClass('max-w-3xl')
185	16	->removeClass('mx-auto')
186	16	->removeClass('xl:max-w-none')
187	16	->removeClass('xl:mr-[15.5rem]')
188	16	->removeClass('xl:pr-16')
189		;
190	16	}
191
192	16	protected function removeFooter(HtmlPageCrawler $crawler)
193		{
194	16	$crawler->filter('div.pt-10.pb-28.border-t.border-gray-200.justify-between.text-gray-500')
195	16	->remove()
196		;
197	16	}
198
199	16	protected function ignoreDarkModeForSomeColors(HtmlPageCrawler $crawler)
200		{
201	16	$this->ignoreDarkModeForDefaultColorPaletteSection($crawler);
202	16	$this->ignoreDarkModeForVariousColorTables($crawler);
203	16	}
204
205	16	protected function ignoreDarkModeForDefaultColorPaletteSection(HtmlPageCrawler $crawler)
206		{
207	16	$crawler->filter('div.h-10.w-full.rounded.ring-1.ring-inset')->addClass('dash-ignore-dark-mode');
208	16	}
209
210	16	protected function ignoreDarkModeForVariousColorTables(HtmlPageCrawler $crawler)
211		{
212	16	$crawler->filter('h2 + div td:last-child')->addClass('dash-ignore-dark-mode');
213	16	}
214
215	16	protected function removeUnwantedJavaScript(HtmlPageCrawler $crawler)
216		{
217	16	$crawler->filter('script')->remove();
218	16	}
219
220	16	protected function insertOnlineRedirection(HtmlPageCrawler $crawler, string $file)
221		{
222	16	$onlineUrl = Str::substr(Str::after($file, $this->innerDirectory()), 1, -5);
223
224	16	$crawler->filter('html')->prepend("<!-- Online page at https://$onlineUrl -->");
225	16	}
226
227	16	protected function insertDashTableOfContents(HtmlPageCrawler $crawler, string $file)
228		{
229	16	if (! Str::contains($file, "{$this->url()}/docs.html")) {
230	16	$crawler->filter('body')
231	16	->before('<a name="//apple_ref/cpp/Section/Top" class="dashAnchor"></a>');
232
233	16	$crawler->filter('h2, h3')->each(function (HtmlPageCrawler $node) {
234	16	$node->prepend(
235	16	'<a id="' . Str::slug($node->text()) . '" name="//apple_ref/cpp/Section/' . rawurlencode($this->cleanAnchorText($node->text())) . '" class="dashAnchor"></a>'
236		);
237	16	});
238		}
239	16	}
240
241	24	protected function cleanAnchorText($anchorText)
242		{
243	24	return trim(preg_replace('/\s+/', ' ', $anchorText));
244		}
245		}
246

godbout / tailwindcss-dash-docset

Push — master ( ef8213...362d9b )

TailwindCSS::removeClassesOverflow() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like