Passed
Push — master ( ec3eba...ad9fdf )
by Guillaume
18:16 queued 13:19
created

TailwindCSS::updateContainerWidth()   A

Complexity

Conditions 1
Paths 1

Size

Total Lines 11
Code Lines 8

Duplication

Lines 0
Ratio 0 %

Code Coverage

Tests 9
CRAP Score 1

Importance

Changes 3
Bugs 0 Features 0
Metric Value
cc 1
eloc 8
nc 1
nop 1
dl 0
loc 11
ccs 9
cts 9
cp 1
crap 1
rs 10
c 3
b 0
f 0
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
136 16
        $this->updateContainerWidth($crawler);
137 16
        $this->removeFooter($crawler);
138
139 16
        $this->ignoreDarkModeForSomeColors($crawler);
140
141 16
        $this->removeUnwantedJavaScript($crawler);
142
143 16
        $this->insertOnlineRedirection($crawler, $file);
144 16
        $this->insertDashTableOfContents($crawler, $file);
145
146 16
        return $crawler->saveHTML();
147
    }
148
149 16
    protected function removeTopbar(HtmlPageCrawler $crawler)
150
    {
151 16
        $crawler->filter('div.sticky.top-0')->remove();
152 16
    }
153
154 16
    protected function removeLeftSidebar(HtmlPageCrawler $crawler)
155
    {
156 16
        $crawler->filter('div.hidden.fixed.z-20.inset-0.py-10.px-8.overflow-y-auto')->remove();
157 16
    }
158
159 16
    protected function removeRightSidebar(HtmlPageCrawler $crawler)
160
    {
161 16
        $crawler->filter('div.fixed.z-20.bottom-0.py-10.px-8.overflow-y-auto.hidden')->remove();
162 16
    }
163
164 16
    protected function updateContainerWidth(HtmlPageCrawler $crawler)
165
    {
166 16
        $crawler->filter('div.max-w-8xl.mx-auto.px-4 > div:first-child')
167 16
            ->removeClass('lg:pl-[19.5rem]')
168
        ;
169 16
        $crawler->filter('div.max-w-3xl.mx-auto.pt-10')
170 16
            ->removeClass('max-w-3xl')
171 16
            ->removeClass('mx-auto')
172 16
            ->removeClass('xl:max-w-none')
173 16
            ->removeClass('xl:mr-[15.5rem]')
174 16
            ->removeClass('xl:pr-16')
175
        ;
176 16
    }
177
178 16
    protected function removeFooter(HtmlPageCrawler $crawler)
179
    {
180 16
        $crawler->filter('div.pt-10.pb-28.border-t.border-gray-200.justify-between.text-gray-500')
181 16
            ->remove()
182
        ;
183 16
    }
184
185 16
    protected function ignoreDarkModeForSomeColors(HtmlPageCrawler $crawler)
186
    {
187 16
        $this->ignoreDarkModeForDefaultColorPaletteSection($crawler);
188 16
        $this->ignoreDarkModeForVariousColorTables($crawler);
189 16
    }
190
191 16
    protected function ignoreDarkModeForDefaultColorPaletteSection(HtmlPageCrawler $crawler)
192
    {
193 16
        $crawler->filter('div.h-10.w-full.rounded.ring-1.ring-inset')->addClass('dash-ignore-dark-mode');
194 16
    }
195
196 16
    protected function ignoreDarkModeForVariousColorTables(HtmlPageCrawler $crawler)
197
    {
198 16
        $crawler->filter('h2 + div td:last-child')->addClass('dash-ignore-dark-mode');
199 16
    }
200
201 16
    protected function removeUnwantedJavaScript(HtmlPageCrawler $crawler)
202
    {
203 16
        $crawler->filter('script')->remove();
204 16
    }
205
206 16
    protected function insertOnlineRedirection(HtmlPageCrawler $crawler, string $file)
207
    {
208 16
        $onlineUrl = Str::substr(Str::after($file, $this->innerDirectory()), 1, -5);
209
210 16
        $crawler->filter('html')->prepend("<!-- Online page at https://$onlineUrl -->");
211 16
    }
212
213 16
    protected function insertDashTableOfContents(HtmlPageCrawler $crawler, string $file)
214
    {
215 16
        if (! Str::contains($file, "{$this->url()}/docs.html")) {
216 16
            $crawler->filter('body')
217 16
                ->before('<a name="//apple_ref/cpp/Section/Top" class="dashAnchor"></a>');
218
219 16
            $crawler->filter('h2, h3')->each(function (HtmlPageCrawler $node) {
220 16
                $node->prepend(
221 16
                    '<a id="' . Str::slug($node->text()) . '" name="//apple_ref/cpp/Section/' . rawurlencode($this->cleanAnchorText($node->text())) . '" class="dashAnchor"></a>'
222
                );
223 16
            });
224
        }
225 16
    }
226
227 24
    protected function cleanAnchorText($anchorText)
228
    {
229 24
        return trim(preg_replace('/\s+/', ' ', $anchorText));
230
    }
231
}
232