degenerate

Library lets you create ES6 generators with in the (dis)comfort of ES5 JS environment (like < node@0.11.x) and without syntax sugar. This magic happens at the cost of the syntax transformations at the generator instantiation. You can use this with task.js, co, suspend or any other Generator-based flow control based library without waiting on your favorite JS environment to enable generators for you!

API

Given a generators support in your environment you should be able to write code like this:

var range = function*(from, to, step) {
  step = step || 1
  var n = from

  while (n <= to) {
    yield n
    n ++
  }

  return n
}

var digits = range(0, 9)
var step
while (step = digits.next(), !step.done) {
  console.log(step.value)
}

Unfortunately above code will throw a syntax error in engines that don't have generators support.

With a degenerate you can create equivalent range generator by typeing this:

var Generator = require("degenerate")
var range = new Generator(function(from, to, step) {
  step = step || 1
  var n = from

  while (n <= to) {
    yield(n)
    n ++
  }

  return n
})

var digits = range(0, 9)
var step
while (step = digits.next(), !step.done) {
  console.log(step.value)
}

Notice the difference ? Just loose a * and replace yield n statement with yield(n) call expression.

You can also use delegeting yields:

var concat = new Generator(function(xs, ys) {
  yield* xs
  yield* ys
})

var zs = concat(range(1, 3), range(4, 7))
while (step = zs.next(), !step.done) {
  console.log(step.value)
}

Limitations

yield isn't a function

Don't try to outsmart this tool, even though yield may feel like a first class function, it is not and any attempts to use it as such will break the code.

strict mode is strict about yield

If you try to define function that refers to yield in strict mode, you'll get a syntax error :( To overcome this limitation all you need to do is write this.yield instead:

"use strict";

var range = Generator(function(from, to) {
  while (from <= to)
    this.yield(from++)
})

var concat = new Generator(function(xs, ys) {
  this.yield* xs
  this.yield* ys
})

Enclosed variables are lost

This is the most unfortunate limitation of all! You can not enclose any scope variables, all that generator body will have has access to is a top scope or whatever has being passed into as this pseudo variable or as arguments.

What's the trick ?

Generator function parses source of the given function, transforms AST to make function expression a generator, replace yield(x), this.yield(x) with yield x. Transforms new AST via facebook/regenerator (Thank them for making it possible) and finally generates a generator from the results.

Install

npm install degenerate