Basic Node API (styleguidist#183).

Author: sapegin

package.json

@@ -15,7 +15,7 @@
     "url": "https://github.com/sapegin/react-styleguidist/issues"
   },
   "license": "MIT",
-  "main": "scripts/build.js",
+  "main": "scripts/index.js",
   "bin": {
     "styleguidist": "bin/styleguidist.js"
   },

scripts/build.js

@@ -4,7 +4,7 @@ const webpack = require('webpack');
 const makeWebpackConfig = require('./make-webpack-config');
 
 module.exports = function build(config, callback) {
-	webpack(makeWebpackConfig(config, 'production'), (err, stats) => {
+	return webpack(makeWebpackConfig(config, 'production'), (err, stats) => {
 		// require('fs').writeFileSync('stats.json', JSON.stringify(stats.toJson()));
 		callback(err, stats);
 	});

scripts/index.js

@@ -0,0 +1,44 @@
+'use strict';
+
+const build = require('./build');
+const server = require('./server');
+const makeWebpackConfig = require('./make-webpack-config');
+const getConfig = require('./config');
+
+module.exports = {
+	/**
+	 * Build style guide.
+	 *
+	 * @param {object} config Styleguidist config.
+	 * @param {Function} callback callback(err, config, stats).
+	 * @return {Compiler} Webpack Compiler instance.
+	 */
+	build(config, callback) {
+		config = getConfig(config);
+		return build(config, (err, stats) => callback(err, config, stats));
+	},
+
+	/**
+	 * Start style guide dev server.
+	 *
+	 * @param {object} config Styleguidist config.
+	 * @param {Function} callback callback(err, config).
+	 * @return {Compiler} Webpack Compiler instance.
+	 */
+	server(config, callback) {
+		config = getConfig(config);
+		return server(config, err => callback(err, config));
+	},
+
+	/**
+	 * Return Styleguidist Webpack config.
+	 *
+	 * @param {object} config Styleguidist config.
+	 * @param {string} env 'production' or 'development'.
+	 * @return {object}
+	 */
+	makeWebpackConfig(config, env) {
+		config = getConfig(config);
+		return makeWebpackConfig(config, env);
+	},
+};

scripts/server.js

@@ -22,4 +22,6 @@ module.exports = function server(config, callback) {
 	}
 
 	app.listen(config.serverPort, config.serverHost, callback);
+
+	return compiler;
 };

test/run.build.js

@@ -0,0 +1,15 @@
+const path = require('path');
+const styleguidist = require('../scripts');
+
+/* eslint-disable no-console */
+
+styleguidist.build({
+	config: path.resolve(__dirname, '../examples/basic/styleguide.config.js'),
+}, (err, config) => {
+	if (err) {
+		console.log(err);
+	}
+	else {
+		console.log('Style guide published to', config.styleguideDir);
+	}
+});

test/run.server.js

@@ -0,0 +1,41 @@
+const path = require('path');
+const glob = require('glob');
+const styleguidist = require('../scripts');
+
+/* eslint-disable no-console */
+
+styleguidist.server({
+	components() {
+		return glob.sync(path.resolve(__dirname, '../examples/basic/lib/components/**/*.js'))
+			.filter(module => /\/[A-Z]\w*\.js$/.test(module))
+		;
+	},
+	updateWebpackConfig(webpackConfig) {
+		const dir = path.resolve(__dirname, '../examples/basic/lib');
+		webpackConfig.module.loaders.push(
+			{
+				test: /\.jsx?$/,
+				include: dir,
+				loader: 'babel',
+			},
+			{
+				test: /\.css$/,
+				include: dir,
+				loader: 'style!css?modules&importLoaders=1',
+			},
+			{
+				test: /\.json$/,
+				include: path.dirname(require.resolve('dog-names/package.json')),
+				loader: 'json',
+			}
+		);
+		return webpackConfig;
+	},
+}, (err, config) => {
+	if (err) {
+		console.log(err);
+	}
+	else {
+		console.log('Listening at http://' + config.serverHost + ':' + config.serverPort);
+	}
+});

test/scripts.index.spec.js

@@ -0,0 +1,23 @@
+import test from 'ava';
+import styleguidist from '../scripts';
+
+test('should have API methods', t => {
+	t.truthy(styleguidist);
+	t.is(typeof styleguidist.build, 'function');
+	t.is(typeof styleguidist.server, 'function');
+	t.is(typeof styleguidist.makeWebpackConfig, 'function');
+});
+
+test('makeWebpackConfig should return development Webpack config', t => {
+	const result = styleguidist.makeWebpackConfig({ components: '*.js' }, 'development');
+	t.truthy(result);
+	t.is(result.output.filename, 'build/bundle.js');
+	t.true(result.cache);
+});
+
+test('makeWebpackConfig should return production Webpack config', t => {
+	const result = styleguidist.makeWebpackConfig({ components: '*.js' }, 'production');
+	t.truthy(result);
+	t.is(result.output.filename, 'build/bundle.js');
+	t.false(result.cache);
+});