_____ ___  _  _ _____ ___
|_   _/ _ \| \| |_   _/ _ \
  | || (_) | .` | | || (_) |
  |_| \___/|_|\_| |_| \___/.JS
 APACHE CONFIG FILE GENERATOR

Tonto.js

This library helps with automating the generation of Apache web server configuration files. It provides a native camelCased javascript function API which support all native (and native mod) configuration directives from Apache versions 2.4, 2.2, and 2.0:

• 591 Directives For Apache 2.4
• 416 Directives For Apache 2.2
• 361 Directives For Apache 2.0

Additionally, Tonto is easily configured at instantiation to support any custom directive that you may have, (such as 3rd-party mod directives like 'PassengerRoot').

The Name "Tonto"

This library is named after the Tonto (Dilzhę́’é) people, who are one of the Western Apache groups in North America.

Long ago, their enemies called them "foolish", "wild", "crazy", and "those who you don't understand" for speaking and doing things differently than their neighbors. Today, they are known throughout the art communities for their superior fine crafts.

Installation

Use NPM to install the tonto package into your node.js project:

$ npm install tonto --save

Getting Started

1. Each instance of Tonto is a version-specific apache config document object that you add directives to by calling it's directive functions:

var tonto = new Tonto('2.4');

2. There are solo directive functions that take a single value argument, and block directive functions which take a sub-directive setter object as the second argument:

tonto.serverName('somesite.com');

tonto.virtualHost('*:80', function (subDirectiveDocument) {
  // Here, you can call any directive function directly on subDirectiveDocument, and it will be added as a sub-directive.
  subDirectiveDocument.serverName('somesite.com');
});

3. When the document object has all directives added to it, you can render the document to string by calling:

tonto.render();

4. All directives are chainable:

var renderedDocument = tonto
  .loadModule('some_module /some/path/to/module.so')
  .serverSignature('Off')
  .traceEnable('Off')
  .render();

Directive Functions

Specifying an Apache Version

Tonto.js comes with built-in support for all native (and native mod) directives in versions 2.4, 2.2, and 2.0. Additionally, you can specify any number of extra directives.

You specify which version you want to use during instantiation of the constructor:

var twoFour = Tonto('2.4');
Object.keys(twoFour).length; // 594
 
var twoTwo = Tonto('2.2');
Object.keys(twoTwo).length; // 419
 
var twoZero = Tonto('2.0');
Object.keys(twoZero).length; // 364

Directive/Function Case Differences

Whereas Apache directives are typed in TitleCase, tonto converts each of the directives into camelBackCase named functions.

For example:

• LoadModule is added to the document with: .loadModule('some_module /some/path/to/module.so')
• SSLCertificateKeyFile is added to the document with: .sslCertificateKeyFile('/some/path/to/some_key.pem')
• VirtualHost is added to the document with: .virtualHost('*:80', subDirectiveSetter)

Sub-Directive Setter

Block directives require a function as the second argument. This function has one argument itself, which is a clean sub-document. You can call any directive from the main document on a sub-document.

Here is an example of a sub-directive setter defined as a named function:

tonto.virtualHost('*:80', subDirectiveSetter);
 
function subDirectiveSetter(subDirectives) {
  subDirectives.serverName('somesite.com');
}

This example will render:

<VirtualHost *:80>
  ServerName somesite.com
</VirtualHost>

Defining Custom Directives

If you are using a 3rd party mod that provides custom directives, there is an easy way to extend tonto.js with custom functions for this purpose:

tonto.extend([
  'CustomDirective',
  '<CustomBlock>'
]);
 
tonto.customDirective('some value'); // Solo directive
 
tonto.customBlock('some value', function (subDirectives) {
  // Because CustomBlock is surrounded in < and >, it is processed as a block directive
});