From f7aead95e4324fc020838eb16506f70a36e7f367 Mon Sep 17 00:00:00 2001
From: Simon Legner <Simon.Legner@gmail.com>
Date: Tue, 6 Sep 2022 19:41:21 +0200
Subject: [PATCH] Add date-fns documentation (2.29.2)

---
 Gemfile                                       |   1 +
 Gemfile.lock                                  |   2 +
 assets/javascripts/news.json                  |   4 +
 .../templates/pages/about_tmpl.coffee         |   5 +
 docs/file-scrapers.md                         |  12 ++
 lib/docs/scrapers/date_fns.rb                 | 163 ++++++++++++++++++
 public/icons/docs/date_fns/16.png             | Bin 0 -> 849 bytes
 public/icons/docs/date_fns/16@2x.png          | Bin 0 -> 1328 bytes
 public/icons/docs/date_fns/SOURCE             |   2 +
 9 files changed, 189 insertions(+)
 create mode 100755 lib/docs/scrapers/date_fns.rb
 create mode 100644 public/icons/docs/date_fns/16.png
 create mode 100644 public/icons/docs/date_fns/16@2x.png
 create mode 100644 public/icons/docs/date_fns/SOURCE

diff --git a/Gemfile b/Gemfile
index fa6189fd..ee87a784 100644
--- a/Gemfile
+++ b/Gemfile
@@ -39,6 +39,7 @@ group :development do
 end
 
 group :docs do
+  gem 'redcarpet'
   gem 'progress_bar', require: false
   gem 'unix_utils', require: false
   gem 'tty-pager', require: false
diff --git a/Gemfile.lock b/Gemfile.lock
index a1dc6be9..5e1b329d 100644
--- a/Gemfile.lock
+++ b/Gemfile.lock
@@ -77,6 +77,7 @@ GEM
     rb-fsevent (0.10.3)
     rb-inotify (0.10.0)
       ffi (~> 1.0)
+    redcarpet (3.5.1)
     rr (1.2.1)
     ruby2_keywords (0.0.5)
     sass (3.7.4)
@@ -157,6 +158,7 @@ DEPENDENCIES
   rack-ssl-enforcer
   rack-test
   rake
+  redcarpet
   rr
   sass
   sinatra
diff --git a/assets/javascripts/news.json b/assets/javascripts/news.json
index d76b8b3f..8af6192b 100644
--- a/assets/javascripts/news.json
+++ b/assets/javascripts/news.json
@@ -1,4 +1,8 @@
 [
+  [
+    "2022-09-06",
+    "New documentation: <a href=\"/date_fns/\">date-fns</a>"
+  ],
   [
     "2022-08-27",
     "New documentations: <a href=\"/sanctuary/\">Sanctuary</a>, <a href=\"/requests/\">Requests</a>, <a href=\"/axios/\">Axios</a>"
diff --git a/assets/javascripts/templates/pages/about_tmpl.coffee b/assets/javascripts/templates/pages/about_tmpl.coffee
index 365f20d9..103d3cbe 100644
--- a/assets/javascripts/templates/pages/about_tmpl.coffee
+++ b/assets/javascripts/templates/pages/about_tmpl.coffee
@@ -236,6 +236,11 @@ credits = [
     '2012 the Dart project authors',
     'CC BY-SA',
     'https://creativecommons.org/licenses/by-sa/4.0/'
+  ], [
+    'date-fns',
+    '2021 Sasha Koss and Lesha Koss',
+    'MIT',
+    'https://raw.githubusercontent.com/date-fns/date-fns/main/LICENSE.md'
   ], [
     'Deno',
     '2018–2022 the Deno authors',
diff --git a/docs/file-scrapers.md b/docs/file-scrapers.md
index caeaa891..2b1843c5 100644
--- a/docs/file-scrapers.md
+++ b/docs/file-scrapers.md
@@ -26,6 +26,18 @@ Or run the following commands in your terminal:
 curl https://storage.googleapis.com/dart-archive/channels/stable/release/$RELEASE/api-docs/dartdocs-gen-api-zip > dartApi.zip; \
 unzip dartApi.zip; mv gen-dartdocs docs/dart~$VERSION
 ```
+
+## date-fns
+
+```sh
+git clone https://github.com/date-fns/date-fns docs/date_fns
+cd docs/date_fns
+git checkout v2.29.2
+yarn install
+node scripts/build/docs.js
+ls tmp/docs.json
+```
+
 ## Django
 
 Go to https://docs.djangoproject.com/, select the version from the
diff --git a/lib/docs/scrapers/date_fns.rb b/lib/docs/scrapers/date_fns.rb
new file mode 100755
index 00000000..db9d7902
--- /dev/null
+++ b/lib/docs/scrapers/date_fns.rb
@@ -0,0 +1,163 @@
+module Docs
+  class DateFns < FileScraper
+    self.name = 'date-fns'
+    self.slug = 'date_fns'
+    self.type = 'simple'
+    self.links = {
+      home: 'https://date-fns.org/',
+      code: 'https://github.com/date-fns/date-fns'
+    }
+    self.release = '2.29.2'
+    self.base_url = "https://date-fns.org/v#{self.release}/docs/"
+
+    # https://github.com/date-fns/date-fns/blob/main/LICENSE.md
+    options[:attribution] = <<-HTML
+      &copy; 2021 Sasha Koss and Lesha Koss<br>
+      Licensed under the MIT License.
+    HTML
+
+    def build_pages
+      markdown = Redcarpet::Markdown.new(Redcarpet::Render::HTML, autolink: true, fenced_code_blocks: true, tables: true)
+
+      md_files = %w(esm.md fp.md gettingStarted.md i18n.md i18nContributionGuide.md release.md timeZones.md unicodeTokens.md upgradeGuide.md webpack.md)
+      md_files.each do |md_file|
+        md_string = request_one("docs/#{md_file}").body
+        md_file = 'index.md' if md_file == 'gettingStarted.md'
+        name = md_string.match(/^#([^\n]+)/)[1]
+        path = md_file.sub '.md', ''
+        page = {
+          path: path,
+          store_path: "#{path}.html",
+          output: markdown.render(md_string),
+          entries: [Entry.new(name, path, 'General')]
+        }
+        yield page
+      end
+
+      docs = JSON.parse(request_one('tmp/docs.json').body)
+      docs.each do |type, features|
+        features.each do |feature|
+          name = feature['title']
+          feature_id = feature['urlId']
+          next if feature_id.start_with?('fp/')
+          next if feature['type'] != 'jsdoc'
+          # fix description table on https://date-fns.org/v2.29.2/docs/parse
+          feature['content']['description'].sub! "\n| Unit", "\n\n| Unit"
+          feature['content']['description'].sub! "\nNotes:\n", "\n\nNotes:\n"
+          page = {
+            path: name,
+            store_path: "#{feature_id}.html",
+            output: ERB.new(PAGE_ERB).result(binding),
+            entries: [Entry.new(name, feature_id, type)]
+          }
+          yield page
+        end
+      end
+    end
+
+    PAGE_ERB = <<-HTML.strip_heredoc
+      <h1><%= feature['title'] %></h1>
+      <p><%= feature['description'] %></p>
+
+      <h2>Description</h2>
+      <p><%= markdown.render feature['content']['description'] %></p>
+
+      <% if feature['usage'] %>
+      <h2>Usage</h2>
+      <% feature['usage'].each do |_, usage| %>
+        <pre data-language="javascript"><%= '// ' + usage['title'] + '\n' %><%= usage['code'] %></pre>
+      <% end %>
+      <% end %>
+
+      <% if feature['syntax'] %>
+      <h2>Syntax</h2>
+      <pre data-language="javascript"><%= feature['syntax'] %></pre>
+      <% end %>
+
+      <% if feature['content']['properties'] %>
+      <h2>Properties</h2>
+      <table>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+        <% feature['content']['properties'].each do |param| %>
+          <tr>
+            <td><code><%= param['name'] %></code></td>
+            <td><code><%= param['type']['names'].join ' ' %></code></td>
+            <td><%= markdown.render param['description'] || '' %></td>
+          </tr>
+        <% end %>
+      </table>
+      <% end %>
+
+      <% if feature['content']['params'] %>
+      <h2>Arguments</h2>
+      <table>
+        <tr>
+          <th>Name</th>
+          <th>Description</th>
+        </tr>
+        <% feature['content']['params'].each do |param| %>
+          <tr>
+            <td><code><%= param['name'] %></code></td>
+            <td><%= markdown.render param['description'] || '' %></td>
+          </tr>
+        <% end %>
+      </table>
+      <% end %>
+
+      <% if feature['content']['returns'] %>
+      <h2>Returns</h2>
+      <table>
+        <tr>
+          <th>Description</th>
+        </tr>
+        <% feature['content']['returns'].each do |param| %>
+          <tr>
+            <td><%= markdown.render param['description'] || '' %></td>
+          </tr>
+        <% end %>
+      </table>
+      <% end %>
+
+      <% if feature['content']['exceptions'] %>
+      <h2>Exceptions</h2>
+      <table>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+        <% feature['content']['exceptions'].each do |param| %>
+          <tr>
+            <td><code><%= param['type']['names'].join ' ' %></code></td>
+            <td><%= markdown.render param['description'] || '' %></td>
+          </tr>
+        <% end %>
+      </table>
+      <% end %>
+
+      <% if feature['content']['examples'] %>
+      <h2>Examples</h2>
+      <% feature['content']['examples'].each do |example| %>
+        <pre data-language="javascript"><%= example %></pre>
+      <% end %>
+      <% end %>
+
+      <div class="_attribution">
+        <p class="_attribution-p">
+          <%= options[:attribution] %>
+          <br>
+          <a href="<%= self.base_url %><%= feature_id %>" class="_attribution-link">
+            <%= self.base_url %><%= feature_id %>
+          </a>
+        </p>
+      </div>
+    HTML
+
+    def get_latest_version(opts)
+      get_latest_github_release('date-fns', 'date-fns', opts)
+    end
+  end
+end
diff --git a/public/icons/docs/date_fns/16.png b/public/icons/docs/date_fns/16.png
new file mode 100644
index 0000000000000000000000000000000000000000..f102d2e4bfc4941576c1312073d6162482d48d20
GIT binary patch
literal 849
zcmeAS@N?(olHy`uVBq!ia0vp^0wB!63?wyl`GbK}Scz*yNk~R%ZjzN%XpkpET4qkF
zmA<}yZeB@Fe!6~IVp(Q#eqOP@k%6JPu7SC(k*R*Fd9q=WX_BR(p}B!^Qc_Zyv5AFQ
zT8cqpvPnvEQj)nIP={VYUiuax&wii{Ea{HEjtmSN`?>!lvI6;x#X;^)4C~IxyaaL-
zl0AZa85pY67#JE_7#My5g&JNkFq9fFFuY1&V6d9Oz#v{QXIG#NP=d3-BeEDsdw{Xq
z$!t5IVIl!OA+F^-VdXrbWjtZo>>)r&Fc&B?qETV65-74`N`m}A@eB+qCKfh!4sKx)
zQE_<%MI~hwHFXUw9X(?cQwvL1FW=yhu<(fJxcG#`q~w&;wDiof%IdlqGv_Z@wPDki
z9XogL*?aWZ@l$6mT)uk!=IuMrp1*wa?)`_4pMN}7d-4oqdXl%hOU$bq4AX&}!=5gV
zAr*|Q2icXG7#SQMs;@6_3lvw16x?)9PS8p_deOW8|M~B?uUfTAYr<`<#zQ%^TnTG_
z%52(T%d+$MZO#WT@>v&IC>RI7op<2L?NWw78J>{$r+fP+RBhsSS(~smcJVx!f@|?E
ziz*h!dI!IYz3|3IdAGg(RuhqZ?=#A}PTYE3C8b%j)#82lgo`<Bsr$-L`fXxg#Wnk+
z;?M7^1w*DjJeDrlS3liRblR@v2Y#FlmJ=!BU#sI_H;cJ7NQ6nNVUic`s{dyWOLP^c
R`6_{e&ePS;Wt~$(695tU7+?SZ

literal 0
HcmV?d00001

diff --git a/public/icons/docs/date_fns/16@2x.png b/public/icons/docs/date_fns/16@2x.png
new file mode 100644
index 0000000000000000000000000000000000000000..c918b60d048e239961aa7e5c578a17cc7baacdc7
GIT binary patch
literal 1328
zcmeAS@N?(olHy`uVBq!ia0vp^3LwnE3?yBabR7dyVI{5+B_SE5xk*-5p+TMuX_+~x
zR{Hw-xp^fy`RV#;iDj9|`FX|qMh1rFx(4RDMyC3y=E;Uhrb(8DhUNywNl8g*#wHeK
zX(<MY$tEeuNlE5<KplDodFfk(Jo|w*u%tWsIx;Y9?C1WI$O_~$76-XIF|0c$^AgBW
zNcITwWnidMV_;}#VPN<L6l!?Ez))(y!0;-8fx&791A}<MoLzx7KnczQkH}&m?E%Ja
zC$sH<hAj{932_Aql=Fm@afg+2hm`X~mGgv_^F&neMgj##(I5$d|Ns9lw^jwE!S0eE
zzhEE@229K>jFBr=wFvV!M)*E`9VDqP6!2X0!tdf~`FTGt>9WpQUc<e5K8OE@H}=&g
zIo8j<uuV5S^(SjKr`0#_lgHgZeROI%aZI0gZx#Exj!D}UZ>D8G)PDa<&-rVd#VfUc
zB|56+{r3$7rIj)tt#6xX^VV$*SD@XKg$pj`e!uGXGJ5MSi3!_UR>g(@-NKmU?e5Z(
z!+psa$bR7I;uvCadhO-R@XHPotPgg28T#fd^jaMxav^AXSo9r%4O>qHt!i*Ny7p32
zX?($9*6^6Xck|1PJUw*&9<qFL`N>}Yb7%G#3nm52IdH#{s$uoz&tltCQ>}65(ku3f
zvJWr#g)`&^9xKab+)(Xr{U&Hnvuy4L)^G2U)2BbVuq*lZ+*{X}Ilrmo)_xF>>^ouD
z)L!Xwb=EAVl_r&6W_)e)nYQ=%RgWg&YYQaR{g?WE|LAk<*BW~tz87^DdJb;h`Da^k
z$}R<UxmQnrCRQ6spQveB+$^D8v`6J2>!+mE{3~jbgl6n=@pGOr{iOB>MsxOclZ-VB
z-&$23zB!x8PcJ@y()Lq}N@i~^<o5}`6SKhT_|6?O{0*v)Gr#0C7hiE?#_8^wzO75x
zt*#d}?hd@Sd;I}s@s<})nfOIFEUS3J@b=^6nalI^Caj4J4%s~CtOdh)F(t<LVpFat
z&9A<_X1|;MiRr0{`;_7rH!_HYF20~7e(fGd#M)`@&F1-c53gc=e=Ks1SHh{;7iDAA
z6L==PpT1^Vy~d_*g|-sERK72W%Bxdz4lZT#-jo^7Rd)V#{LBcxKk5xn^Z&#Z{{FnU
z-~RExwWornY&{coxi@})xS05#2j}lky;}J`zWHLlSc&}w?q!)KZ{8o9UoZHrVuOTZ
R+%`}m^mO%eS?83{1OUqA@|6Gp

literal 0
HcmV?d00001

diff --git a/public/icons/docs/date_fns/SOURCE b/public/icons/docs/date_fns/SOURCE
new file mode 100644
index 00000000..568f4706
--- /dev/null
+++ b/public/icons/docs/date_fns/SOURCE
@@ -0,0 +1,2 @@
+https://date-fns.org/static/favicon-16x16.png
+https://date-fns.org/static/favicon-32x32.png