react-server-gulp-module-tagger

react-server-gulp-module-tagger

A gulp plugin for tagging react-server logger instances with information about the module they're being used in.

To transpile your source for use with React Server, install gulp and the plugin

npm i -D gulp react-server-gulp-module-tagger

Then add the task to your gulpfile

const gulp = require('gulp');
const tagger = require('react-server-gulp-module-tagger');
gulp.task('compile', () => {
    gulp.src('src')
        .pipe(tagger())
        .pipe(gulp.dest('dist'));
});

A compile task might also use Babel with the React Server Babel preset to transpile jsx and es 7 for the browser and the server

const gulp = require('gulp');
const babel = require('gulp-babel');
const tagger = require('react-server-gulp-module-tagger');

gulp.task('compile', () => {
    gulp.src('src')
        .pipe(tagger(
            trim: 'src.'
        ))
        .pipe(babel({ presets: ['react-server'] }))
        .pipe(gulp.dest('dist'));
});

Given a getLogger call, adds the correct arguments to keep the server and the browser in sync.

For example, given a module in src/components/my-feature/foo.js, and using the options { trim: 'src.', prefix: 'react-server.' }

let logger = require("react-server").logging.getLogger(__LOGGER__);

returns a logger instance that will have consistent coloring on the server and the client, and that has a human-friendly, readable name that easily maps to the file tree (in this example react-server.components.my-feature.foo).

If you need more than one logger in your module, you can distinguish them with labels

var fooLogger = logging.getLogger(__LOGGER__({ label: "foo" }));
var barLogger = logging.getLogger(__LOGGER__({ label: "bar" }));

Two other tokens, __CHANNEL__ and __CACHE__, are reserved for future use, and will also be replaced with a module context.

Changelog

v0.6.0 (2017-01-28)

Breaking change

Previously, routes marked explicitly as GET would also accept POST and other requests. After upgrading to v0.6.0, routes will only match the verbs they are marked to accept, which may break some existing use cases. We recommended auditing your non-GET routes as part of upgrading to 0.6.0

• react-server-cli, react-server
  • #837 Address routr api changes & Handle POST. (@drewpc)
  • #809 Server side hot reload. (@drewpc)

Enhancement

• react-server-examples, react-server-redux, react-server-test-pages
  • #839 Add Redux Support. (@sresant)
• react-server-cli, react-server
  • #809 Server side hot reload. (@drewpc)
• babel-plugin-react-server, babel-preset-react-server, generator-react-server, react-server-cli, react-server-gulp-module-tagger, react-server-module-tagger, react-server
  • #787 Update dependencies with david. (@doug-wade)
• Other
  • #784 Run bootstrap as a postinstall script. (@doug-wade)
• babel-plugin-react-server
  • #778 Add support for logger labels. (@doug-wade)

Bug fix

• react-server-cli, react-server
  • #833 Fix file path issues. (@drewpc)
  • #837 Address routr api changes & Handle POST. (@drewpc)
• generator-react-server, react-server-cli
  • #836 Make output url more relative. (@drewpc)
• react-server
  • #838 Fix ReactServerAgent CORS preflight. (@drewpc)
  • #805 Handle Null and Promise.resolve(null) in renderMetaTags + renderLinkTags. (@drewpc)
• react-server-cli
  • #786 Resolve ReactMount not found error. (@doug-wade)

Documentation

• Other
  • #821 Remove asini run prepublish since it doesn't run in topo order. (@doug-wade)
  • #815 Add merging prs policy. (@doug-wade)
  • #834 Fix configuration key in documentation. (@karlhorky)
  • #827 Fix broken Markdown link in production.md. (@drewpc)
  • #817 Documentation update: bullet list for express middlewares. (@feychou)
  • #814 Documentation update: add details about node GC. (@drewpc)
  • #777 Add a guide for running react-server in production. (@drewpc)
• react-server-test-pages
  • #806 Test page for page forwarding. (@lidawang)
  • #803 Adding bottleneck vanilla test sites. (@krisxw)

Security

• react-server-test-pages, react-server-website
  • #819 Remove outdated nsprcs. (@doug-wade)
• react-server-cli
  • #812 Helmet as default express middleware in react-server-cli. (@feychou)

Commiters: 12

• Bo Borgerson (gigabo)
• Douglas Wade (doug-wade)
• Fey Chou (feychou)
• Greenkeeper (greenkeeperio-bot)
• Helen Weng (helenaut)
• Karl Horky (karlhorky)
• Kristopher X Williams (krisxw)
• Lida Wang (lidawang)
• Mark Thomas (markthethomas)
• PC Drew (drewpc)
• Richie Thomas (richiethomas)
• Sresan Thevarajah (sresant)