Pult

Jump To … +

pult.js server.js example.js index.js static.js

¶

Pult

Client Library Example

This is an example of a Node HTTP server using Pult to bind to a local .dev domain.
```
var http = require('http');
var pult = require('pult');
```
¶

The server will be available at http://hello.dev.
```
var SERVER_NAME = 'hello';
```
¶

The port to fall back to if Pult is not available.
```
var DEFAULT_PORT = 8080;
```

Create a simple HTTP server that responds with “Hello, World!” to every request.

var server = http.createServer(function(req, res) {
  var body = 'Hello, World!';
  res.writeHead(200, {
    'Content-Type': 'text/plain',
    'Content-Length': body.length
  });
  res.write(body);
  res.end();
});

Only try to use Pult in development.

if (process.env.NODE_ENV == 'development') {

Check if Pult is running.

  pult.serverStatus(function(err, up) {
    if (err) throw err;

If the Pult server is up, retrieve a port number for SERVER_NAME from it.

    if (up) {
      pult.getPort(SERVER_NAME, function(err, port, domain) {
        if (err) throw err;

¶

Bind the HTTP server to the assigned port.
```
        server.listen(port);
```

Output a link to the .dev domain.

        console.log('http://' + domain);
      });

¶

If the Pult server is not running, bind the HTTP server to the PORT environment variable or the default development port.
```
    } else {
      var port = process.env.PORT || DEFAULT_PORT;
      server.listen(port);
```

Output a link to the server.

      console.log('http://localhost:' + port);
    }
  });

¶

In production, bind the HTTP server to the PORT environment variable.
```
} else {
  server.listen(process.env.PORT);
}
```
¶

Starting the Pult server automatically

Though not recommended because some developers may not want to run the Pult server, it is possible to automatically start it before your server starts.

Callback to start the server once Pult is running.

function startServer() {
  pult.getPort(SERVER_NAME, function(err, port, domain) {
    if (err) throw err;
    server.listen(port);
    console.log('http://' + domain);
  });
}

Check if the Pult server is already running.

pult.serverStatus(function(err, up) {
  if (err) throw err;

¶

If Pult is already running, start the server.
```
  if (up) {
    startServer();
```

Otherwise, spawn the Pult server.

  } else {
    pult.spawnServer(function(err) {
      if (err) throw err;

¶

Then start the HTTP server.
```
      startServer();
    });
  }
});
```

Pult

Client Library Example

Starting the Pult server automatically