.gitignore is now working

../ws/bin/wscat

 No newline at end of file

Copyright (c) 2010 Benjamin Thomas, Robert Kieffer

Permission is hereby granted, free of charge, to any person obtaining a copy

of this software and associated documentation files (the "Software"), to deal

in the Software without restriction, including without limitation the rights

to use, copy, modify, merge, publish, distribute, sublicense, and/or sell

copies of the Software, and to permit persons to whom the Software is

furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in

all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR

IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,

FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE

AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER

LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,

OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN

THE SOFTWARE.

# mime

Comprehensive MIME type mapping API. Includes all 600+ types and 800+ extensions defined by the Apache project, plus additional types submitted by the node.js community.

## Install

Install with [npm](http://github.com/isaacs/npm):

    npm install mime

## API - Queries

### mime.lookup(path)

Get the mime type associated with a file. Performs a case-insensitive lookup using the extension in `path` (the substring after the last '/' or '.').  E.g.

    var mime = require('mime');

    mime.lookup('/path/to/file.txt');         // => 'text/plain'

    mime.lookup('file.txt');                  // => 'text/plain'

    mime.lookup('.TXT');                      // => 'text/plain'

    mime.lookup('htm');                       // => 'text/html'

### mime.extension(type)

Get the default extension for `type`

    mime.extension('text/html');                 // => 'html'

    mime.extension('application/octet-stream');  // => 'bin'

### mime.charsets.lookup()

Map mime-type to charset

    mime.charsets.lookup('text/plain');        // => 'UTF-8'

(The logic for charset lookups is pretty rudimentary.  Feel free to suggest improvements.)

## API - Defining Custom Types

The following APIs allow you to add your own type mappings within your project.  If you feel a type should be included as part of node-mime, see [requesting new types](https://github.com/broofa/node-mime/wiki/Requesting-New-Types).

### mime.define()

Add custom mime/extension mappings

    mime.define({

        'text/x-some-format': ['x-sf', 'x-sft', 'x-sfml'],

        'application/x-my-type': ['x-mt', 'x-mtt'],

        // etc ...

    });

    mime.lookup('x-sft');                 // => 'text/x-some-format'

The first entry in the extensions array is returned by `mime.extension()`. E.g.

    mime.extension('text/x-some-format'); // => 'x-sf'

### mime.load(filepath)

Load mappings from an Apache ".types" format file

    mime.load('./my_project.types');

The .types file format is simple -  See the `types` dir for examples.

var path = require('path');

var fs = require('fs');

function Mime() {

  // Map of extension -> mime type

  this.types = Object.create(null);

  // Map of mime type -> extension

  this.extensions = Object.create(null);

}

/**

 * Define mimetype -> extension mappings.  Each key is a mime-type that maps

 * to an array of extensions associated with the type.  The first extension is

 * used as the default extension for the type.

 *

 * e.g. mime.define({'audio/ogg', ['oga', 'ogg', 'spx']});

 *

 * @param map (Object) type definitions

 */

Mime.prototype.define = function (map) {

  for (var type in map) {

    var exts = map[type];

    for (var i = 0; i < exts.length; i++) {

      if (process.env.DEBUG_MIME && this.types[exts]) {

        console.warn(this._loading.replace(/.*\//, ''), 'changes "' + exts[i] + '" extension type from ' +

          this.types[exts] + ' to ' + type);

      }

      this.types[exts[i]] = type;

    }

    // Default extension is the first one we encounter

    if (!this.extensions[type]) {

      this.extensions[type] = exts[0];

    }

  }

};

/**

 * Load an Apache2-style ".types" file

 *

 * This may be called multiple times (it's expected).  Where files declare

 * overlapping types/extensions, the last file wins.

 *

 * @param file (String) path of file to load.

 */

Mime.prototype.load = function(file) {

  this._loading = file;

  // Read file and split into lines

  var map = {},

      content = fs.readFileSync(file, 'ascii'),

      lines = content.split(/[\r\n]+/);

  lines.forEach(function(line) {

    // Clean up whitespace/comments, and split into fields

    var fields = line.replace(/\s*#.*|^\s*|\s*$/g, '').split(/\s+/);

    map[fields.shift()] = fields;

  });

  this.define(map);

  this._loading = null;

};

/**

 * Lookup a mime type based on extension

 */

Mime.prototype.lookup = function(path, fallback) {

  var ext = path.replace(/.*[\.\/]/, '').toLowerCase();

  return this.types[ext] || fallback || this.default_type;

};

/**

 * Return file extension associated with a mime type

 */

Mime.prototype.extension = function(mimeType) {

  return this.extensions[mimeType];

};

// Default instance

var mime = new Mime();

// Load local copy of

// http://svn.apache.org/repos/asf/httpd/httpd/trunk/docs/conf/mime.types

mime.load(path.join(__dirname, 'types/mime.types'));

// Load additional types from node.js community

mime.load(path.join(__dirname, 'types/node.types'));

// Default type

mime.default_type = mime.lookup('bin');

//

// Additional API specific to the default instance

//

mime.Mime = Mime;

/**

 * Lookup a charset based on mime type.

 */

mime.charsets = {

  lookup: function(mimeType, fallback) {

    // Assume text types are utf8

    return (/^text\//).test(mimeType) ? 'UTF-8' : fallback;

  }

};

module.exports = mime;

{

  "author": {

    "name": "Robert Kieffer",

    "email": "robert@broofa.com",

    "url": "http://github.com/broofa"

  },

  "contributors": [

    {

      "name": "Benjamin Thomas",

      "email": "benjamin@benjaminthomas.org",

      "url": "http://github.com/bentomas"

    }

  ],

  "dependencies": {},

  "description": "A comprehensive library for mime-type mapping",

  "devDependencies": {},

  "keywords": [

    "util",

    "mime"

  ],

  "main": "mime.js",

  "name": "mime",

  "repository": {

    "url": "https://github.com/broofa/node-mime",

    "type": "git"

  },

  "version": "1.2.9",

  "readme": "# mime\n\nComprehensive MIME type mapping API. Includes all 600+ types and 800+ extensions defined by the Apache project, plus additional types submitted by the node.js community.\n\n## Install\n\nInstall with [npm](http://github.com/isaacs/npm):\n\n    npm install mime\n\n## API - Queries\n\n### mime.lookup(path)\nGet the mime type associated with a file. Performs a case-insensitive lookup using the extension in `path` (the substring after the last '/' or '.').  E.g.\n\n    var mime = require('mime');\n\n    mime.lookup('/path/to/file.txt');         // => 'text/plain'\n    mime.lookup('file.txt');                  // => 'text/plain'\n    mime.lookup('.TXT');                      // => 'text/plain'\n    mime.lookup('htm');                       // => 'text/html'\n\n### mime.extension(type)\nGet the default extension for `type`\n\n    mime.extension('text/html');                 // => 'html'\n    mime.extension('application/octet-stream');  // => 'bin'\n\n### mime.charsets.lookup()\n\nMap mime-type to charset\n\n    mime.charsets.lookup('text/plain');        // => 'UTF-8'\n\n(The logic for charset lookups is pretty rudimentary.  Feel free to suggest improvements.)\n\n## API - Defining Custom Types\n\nThe following APIs allow you to add your own type mappings within your project.  If you feel a type should be included as part of node-mime, see [requesting new types](https://github.com/broofa/node-mime/wiki/Requesting-New-Types).\n\n### mime.define()\n\nAdd custom mime/extension mappings\n\n    mime.define({\n        'text/x-some-format': ['x-sf', 'x-sft', 'x-sfml'],\n        'application/x-my-type': ['x-mt', 'x-mtt'],\n        // etc ...\n    });\n\n    mime.lookup('x-sft');                 // => 'text/x-some-format'\n\nThe first entry in the extensions array is returned by `mime.extension()`. E.g.\n\n    mime.extension('text/x-some-format'); // => 'x-sf'\n\n### mime.load(filepath)\n\nLoad mappings from an Apache \".types\" format file\n\n    mime.load('./my_project.types');\n\nThe .types file format is simple -  See the `types` dir for examples.\n",

  "readmeFilename": "README.md",

  "_id": "mime@1.2.9",

  "_from": "mime@"

}