Extract examples from new-style services

.gitignore

@@ -89,3 +89,4 @@ typings/
 # Temporary build artifacts.
 /build
 .next
+badge-examples.json

lib/all-badge-examples.js

@@ -1,5 +1,7 @@
 'use strict';
 
+const { loadServiceClasses } = require('../services');
+
 const visualStudioTeamServicesDoc = `
 <p>
   To obtain your own badge, you will first need to enable badges for your
@@ -144,14 +146,6 @@ const allBadgeExamples = [
         ],
         exampleUri: '/teamcity/http/teamcity.jetbrains.com/e/bt345.svg'
       },
-      {
-        title: 'AppVeyor',
-        previewUri: '/appveyor/ci/gruntjs/grunt.svg'
-      },
-      {
-        title: 'AppVeyor branch',
-        previewUri: '/appveyor/ci/gruntjs/grunt/master.svg'
-      },
       {
         title: 'AppVeyor tests',
         previewUri: '/appveyor/tests/NZSmartie/coap-net-iu0to.svg'
@@ -2260,4 +2254,38 @@ const allBadgeExamples = [
   }
 ];
 
+function prepareExample({ title, previewUri, exampleUri, documentation }, ServiceClass) {
+  if (! previewUri) {
+    throw Error(`Example for ${ServiceClass.name} is missing required previewUri`);
+  }
+
+  return {
+    title: title ? `${ServiceClass.name} ${title}` : ServiceClass.name,
+    previewUri: `${previewUri}.svg`,
+    exampleUri: exampleUri ? `${exampleUri}.svg` : undefined,
+    documentation,
+  };
+}
+
+function getCategory(wantedCategory) {
+  return allBadgeExamples.find(thisCat => thisCat.category.id === wantedCategory);
+}
+
+function loadExamples() {
+  loadServiceClasses().forEach(ServiceClass => {
+    const { category: wantedCategory, examples: theseExamples } = ServiceClass;
+
+    const category = getCategory(wantedCategory);
+    if (category === undefined) {
+      throw Error(`Unknown category ${wantedCategory} referenced in ${ServiceClass.name}`);
+    }
+
+    const prepared = theseExamples.map(
+      inExample => prepareExample(inExample, ServiceClass));
+    category.examples = category.examples.concat(prepared);
+  });
+}
+loadExamples();
+
 module.exports = allBadgeExamples;
+module.exports.getCategory = getCategory;

lib/all-badge-examples.spec.js

@@ -0,0 +1,29 @@
+'use strict';
+
+const { expect } = require('chai');
+
+const allBadgeExamples = require('./all-badge-examples');
+
+describe('The badge examples', function () {
+  it('should include AppVeyor, which is added automatically', function () {
+    const { examples } = allBadgeExamples.getCategory('build');
+
+    const appVeyorBuildExamples = examples.filter(ex => ex.title.includes('AppVeyor'))
+      .filter(ex => ! ex.title.includes('tests'));
+
+    expect(appVeyorBuildExamples).to.deep.equal([
+      {
+        title: 'AppVeyor',
+        previewUri: '/appveyor/ci/gruntjs/grunt.svg',
+        exampleUri: undefined,
+        documentation: undefined,
+      },
+      {
+        title: 'AppVeyor branch',
+        previewUri: '/appveyor/ci/gruntjs/grunt/master.svg',
+        exampleUri: undefined,
+        documentation: undefined,
+      },
+    ]);
+  });
+});

lib/export-badge-examples-cli.js

@@ -0,0 +1,5 @@
+'use strict';
+
+const allBadgeExamples = require('./all-badge-examples');
+
+process.stdout.write(JSON.stringify(allBadgeExamples));

lib/service-test-runner/runner.js

@@ -1,6 +1,6 @@
 'use strict';
 
-const glob = require('glob');
+const { loadTesters } = require('../../services');
 
 /**
  * Load a collection of ServiceTester objects and register them with Mocha.
@@ -16,7 +16,7 @@ class Runner {
    * Prepare the runner by loading up all the ServiceTester objects.
    */
   prepare () {
-    this.testers = glob.sync(`${__dirname}/../../services/**/*.tester.js`).map(name => require(name));
+    this.testers = loadTesters();
     this.testers.forEach(tester => {
       tester.beforeEach = () => { this.beforeEach(); };
     });

next.config.js

@@ -17,6 +17,11 @@ module.exports = {
       }));
     }
 
+    config.module.loaders = (config.module.loaders || []).concat({
+      test: /\.json$/,
+      loader: 'json-loader',
+    });
+
     return config;
   },
   exportPathMap: () => ({

package.json

@@ -66,12 +66,13 @@
     "depcheck": "check-node-version --node \">= 8.0\"",
     "postinstall": "npm run depcheck",
     "prebuild": "npm run depcheck",
-    "build": "next build && next export -o build/",
+    "examples": "node lib/export-badge-examples-cli.js > badge-examples.json",
+    "build": "npm run examples && next build && next export -o build/",
     "heroku-postbuild": "npm run build",
     "analyze": "ANALYZE=true LONG_CACHE=false BASE_URL=https://img.shields.io npm run build",
     "start:server": "RATE_LIMIT=false node server 8080 ::",
     "now-start": "node server",
-    "prestart": "npm run depcheck",
+    "prestart": "npm run depcheck && npm run examples",
     "start": "concurrently --names server,frontend \"ALLOWED_ORIGIN=http://localhost:3000 npm run start:server\" \"BASE_URL=http://[::]:8080 next dev\""
   },
   "bin": {

pages/index.js

@@ -7,7 +7,7 @@ import { BadgeExamples } from '../frontend/components/badge-examples';
 import MarkupModal from '../frontend/components/markup-modal';
 import Usage from '../frontend/components/usage';
 import Footer from '../frontend/components/footer';
-import badgeExampleData from '../lib/all-badge-examples';
+import badgeExampleData from '../badge-examples.json';
 import { prepareExamples, predicateFromQuery } from '../frontend/lib/prepare-examples';
 
 const baseUri = process.env.BASE_URL;

server.js

@@ -5,12 +5,12 @@ const dom = require('xmldom').DOMParser;
 const jp = require('jsonpath');
 const path = require('path');
 const prettyBytes = require('pretty-bytes');
-const glob = require('glob');
 const queryString = require('query-string');
 const semver = require('semver');
 const xml2js = require('xml2js');
 const xpath = require('xpath');
 
+const { loadServiceClasses } = require('./services');
 const { isDeprecated, getDeprecatedBadge } = require('./lib/deprecation-helpers');
 const { checkErrorResponse } = require('./lib/error-helper');
 const analytics = require('./lib/analytics');
@@ -196,14 +196,8 @@ camp.notfound(/.*/, function(query, match, end, request) {
 
 // Vendors.
 
-// Match modules with the same name as their containing directory.
-// e.g. services/appveyor/appveyor.js
-const serviceRegex = /\/services\/(.*)\/\1\.js$/;
-// New-style services
-glob.sync(`${__dirname}/services/**/*.js`)
-  .filter(path => serviceRegex.test(path))
-  .map(path => require(path))
-  .forEach(serviceClass => serviceClass.register(camp, cache));
+loadServiceClasses().forEach(
+  serviceClass => serviceClass.register(camp, cache));
 
 // JIRA issue integration
 camp.route(/^\/jira\/issue\/(http(?:s)?)\/(.+)\/([^/]+)\.(svg|png|gif|jpg|json)$/,

services/appveyor/appveyor.js

@@ -42,14 +42,14 @@ module.exports = class AppVeyor extends BaseService {
     };
   }
 
-  static getExamples() {
+  static get examples() {
     return [
       {
-        uri: '/appveyor/ci/gruntjs/grunt',
+        previewUri: '/appveyor/ci/gruntjs/grunt',
       },
       {
-        name: 'Branch',
-        uri: '/appveyor/ci/gruntjs/grunt/master',
+        title: 'branch',
+        previewUri: '/appveyor/ci/gruntjs/grunt/master',
       },
     ];
   }

services/base.js

@@ -57,7 +57,7 @@ module.exports = class BaseService {
    * specified in `uri`, and can be used to demonstrate how to use badges for
    * this service.
    */
-  static getExamples() {
+  static get examples() {
     return [];
   }
 

services/index.js

@@ -0,0 +1,24 @@
+'use strict';
+
+const glob = require('glob');
+
+// Match modules with the same name as their containing directory.
+// e.g. services/appveyor/appveyor.js
+const serviceRegex = /\/services\/(.*)\/\1\.js$/;
+
+function loadServiceClasses() {
+  // New-style services
+  return glob.sync(`${__dirname}/**/*.js`)
+    .filter(path => serviceRegex.test(path))
+    .map(path => require(path))
+}
+
+function loadTesters() {
+  return glob.sync(`${__dirname}/**/*.tester.js`)
+    .map(name => require(name));
+}
+
+module.exports = {
+  loadServiceClasses,
+  loadTesters,
+};