lodash · veksen · Apr 17, 2019 · Apr 18, 2019
diff --git a/gatsby-config.js b/gatsby-config.js
@@ -19,6 +19,15 @@ module.exports = {
         path: `${__dirname}/src/images`,
       },
     },
+    {
+      resolve: "gatsby-source-lodash",
+      options: {
+        versions: [{
+          version: '4.17.11',
+          url: 'https://raw.githubusercontent.com/lodash/lodash/4.17.11-npm/lodash.js',
+        }]
+      },
+    },
     `gatsby-plugin-react-svg`,
     `gatsby-transformer-sharp`,
     `gatsby-plugin-sharp`,

diff --git a/plugins/gatsby-source-lodash/README.md b/plugins/gatsby-source-lodash/README.md
@@ -0,0 +1,25 @@
+# Gatsby Source Lodash
+
+A simple Gatsby Source Plugin to grab method metadata from Lodash.
+
+## Usage
+
+In the `gatsby-config.js` file, add `gatsby-source-lodash` to the `module.exports`.
+
+```js
+module.exports = {
+  plugins: [
+    ...
+    {
+      resolve: "gatsby-source-lodash",
+      options: {
+        versions: [{
+          version: '4.17.11',
+          url: 'https://raw.githubusercontent.com/lodash/lodash/4.17.11-npm/lodash.js',
+        }]
+      },
+    },
+    ...
+  ]
+}
+```
diff --git a/plugins/gatsby-source-lodash/gatsby-node.js b/plugins/gatsby-source-lodash/gatsby-node.js
@@ -0,0 +1,99 @@
+'use strict';
+
+const fetch = require("node-fetch"),
+      _ = require("lodash"),
+      Entry = require('./lib/entry.js'),
+      getEntries = Entry.getEntries;
+
+exports.sourceNodes = (
+  { actions, createNodeId, createContentDigest },
+  configOptions
+) => {
+  const { createNode } = actions
+
+  // Gatsby adds a configOption that's not needed for this plugin, delete it
+  delete configOptions.plugins
+
+  // TODO: Extend this to include multiple versions
+  const url = configOptions.versions[0].url,
+        version = configOptions.versions[0].version;
+
+  const processEntry = entry => {
+    try {
+      // Exit early if the entry is private or has no name
+      if (!entry || !entry.getName() || entry.isPrivate()) {
+        return;
+      }  
+    } catch (err) {
+      // Some of the non-lodash methods were throwing a hard to trace error
+      // from the lib code. Rather than trace back, it was easier to catch 
+      // since they aren't part of lodash.
+      return;
+    }
+
+    // Special handling of aliases to get call names. Without this, there are
+    // circular JS object references.
+    const aliases = entry.getAliases().map(alias => {
+      const member = entry.getMembers(0) || '',
+            name = alias.getName();
+      return `${member}.${name}`;
+    })
+
+    const params = entry.getParams().map(
+      ([type, name, desc]) => ({ type, name, desc }));
+
+    const entryData = {
+      aliases,
+      version,
+      params,
+      call: entry.getCall(),
+      category: entry.getCategory(),
+      desc: entry.getDesc(),
+      example: entry.getExample(),
+      hash: entry.getHash(),
+      lineNumber: entry.getLineNumber(),
+      members: entry.getMembers(),
+      name: entry.getName(),
+      related: entry.getRelated(),
+      returns: entry.getReturns(),
+      since: entry.getSince(),
+      type: entry.getType(),
+      isAlias: entry.isAlias(),
+      isCtor: entry.isCtor(),
+      isFunction: entry.isFunction(),
+      isLicense: entry.isLicense(),
+      isPlugin: entry.isPlugin(),
+      isStatic: entry.isStatic(),
+    }
+
+    const nodeData = _.assign({}, entryData, {
+      id: createNodeId(`lodash_method_${version}_${entryData.hash}_${entryData.lineNumber}`),
+      parent: null,
+      children: [],
+      internal: {
+        type: 'LodashMethod',
+        content: JSON.stringify(entryData),
+        contentDigest: createContentDigest(JSON.stringify(entryData)),
+      }
+    });
+
+    return nodeData;
+  }
+
+  return (
+    fetch(url)
+      .then(res => res.text())
+      .then(body => {
+        const entries = getEntries(body);
+
+        // For each entry, create node.
+        _.each(entries, entry => {
+          entry = new Entry(entry, body);
+          const nodeData = processEntry(entry);
+          if (nodeData) {
+            createNode(nodeData);
+          }
+        })
+      })
+  )
+}