🎉 Initial commit

Author: kraynel

.babelrc

@@ -0,0 +1,5 @@
+{
+    "presets": [
+      ["babel-preset-gatsby-package"]
+    ]
+  }

.gitignore

@@ -0,0 +1,2 @@
+node_modules
+/gatsby-node.js

.npmignore

@@ -0,0 +1,35 @@
+# Logs
+logs
+*.log
+
+# Runtime data
+pids
+*.pid
+*.seed
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+
+# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (http://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directory
+# https://www.npmjs.org/doc/misc/npm-faq.html#should-i-check-my-node_modules-folder-into-git
+node_modules
+*.un~
+yarn.lock
+src
+flow-typed
+coverage
+decls
+examples
+

README.md

@@ -0,0 +1,143 @@
+# gatsby-transformer-gitinfo
+
+Add some git information on `File` fields: latest commit date, author and email.
+
+## Install
+
+`npm install --save gatsby-transformer-gitinfo`
+
+**Note:** You also need to have `gatsby-source-filesystem` installed and configured so it
+points to your files.
+
+## How to use
+
+In your `gatsby-config.js`
+
+```javascript
+module.exports = {
+  plugins: [
+    `gatsby-transformer-gitinfo`,
+    {
+      resolve: `gatsby-source-filesystem`,
+      options: {
+        path: `./src/data/`,
+      },
+    },
+  ],
+}
+```
+
+Where the _source folder_ `./src/data/` is a git versionned directory.
+
+The plugin will add three fields to `File` nodes: `gitDate`, `gitAuthorName` and `gitAuthorEmail`. These fields are relative to the latest commit touching that file.
+
+If the file is not versionned, these feilds will be `null`.
+
+They are exposed in your graphql schema which you can query:
+
+```graphql
+query {
+  allFile {
+    edges {
+      node {
+        fields {
+          gitDate
+          gitAuthorName
+          gitAuthorEmail
+        }
+        internal {
+          type
+          mediaType
+          description
+          owner
+        }
+      }
+    }
+  }
+}
+```
+
+Now you have a File node to work with:
+
+```json
+{
+  "data": {
+    "allFile": {
+      "edges": [
+        {
+          "node": {
+            "fields": {
+              "gitDate": "2019-10-14T12:58:39.000Z",
+              "gitAuthorName": "John Doe",
+              "gitAuthorEmail": "[email protected]"
+            },
+            "internal": {
+              "contentDigest": "c1644b03f380bc5508456ce91faf0c08",
+              "type": "File",
+              "mediaType": "text/yaml",
+              "description": "File \"src/data/example.yml\"",
+              "owner": "gatsby-source-filesystem"
+            }
+          }
+        }
+      ]
+    }
+  }
+}
+```
+
+## Configuration options
+
+**`whitelist`** [regex][optional]
+
+This plugin will try to match the absolute path of the file with the `whitelist` regex.
+If it *does not* match, the file will be skipped.
+
+```javascript
+module.exports = {
+  plugins: [
+    {
+      resolve: `gatsby-transformer-gitinfo`,
+      options: {
+        whitelist: /\.md$/i, // Only .md files
+      },
+    },
+  ],
+}
+```
+
+
+**`blacklist`** [regex][optional]
+
+This plugin will try to match the absolute path of the file with the `blacklist` regex.
+If it *does* match, the file will be skipped.
+
+```javascript
+module.exports = {
+  plugins: [
+    {
+      resolve: `gatsby-transformer-gitinfo`,
+      options: {
+        blacklist: /\.jpeg$/i, // All files except .jpeg
+      },
+    },
+  ],
+}
+```
+
+
+Note: the execution order is first whitelist, then blacklist.
+
+```javascript
+module.exports = {
+  plugins: [
+    {
+      resolve: `gatsby-transformer-gitinfo`,
+      options: {
+        whitelist: /\.md$/i,
+        blacklist: /README/i,  // Will match all .md files, except README.md
+      },
+    },
+  ],
+}
+```

index.js

@@ -0,0 +1 @@
+//no-op