# iifefy

A Sublime Text 3 plugin for wrapping Javascript code in immediately invoking function expressions.

## Installation

### Using [Package Control][pkgcontrol] (*Recommended*)

For all Sublime Text 2/3 users we recommend install via [Package Control][pkgcontrol].

1. [Install][pkgcontrol-install] Package Control if you haven't already
2. Use `cmd+shift+P` (or `ctrl+shift+P` for Windows) then select `Package Control: Install Package`
3. Search for `iifefy` and select to install

### Manual Install

1. Click the `Preferences > Browse Packages…` menu
2. Browse up a folder and then into the `Installed Packages/` folder
3. Download the [zip archive][zip], rename it to `Iifefy.sublime-package` and copy it into the `Installed Packages/` directory
4. Restart Sublime Text

## Usage

This plugin provides two commands:

`iifefy`: Wraps each current selection in an IIFE. If nothing is selected it wraps the entire document.

`iifefy_skip_initial_comments`: Same as `iifefy`, except it begins wrapping at the first non-comment, non-blank line. This is useful for certain per-file configuration comments, which some prefer to keep as the opening line.

Both of these commands add `'use strict';` and a trailing newline to each IIFE by default, but you can change the opening and closing strings that form the IIFE to whatever you like under `Preferences > Package Settings > iifefy > Settings - User`.

The commands themselves are accessible directly in the context menu and from the `Edit > Wrap` submenu. Keyboard shortcuts can be added by going to `Preferences > Key Bindings - User` and adding the following to the file, replacing the key values with your preferred shortcuts:

```
{ "keys": [ "ctrl+i" ], "command": "iifefy", "context":
    [{ "key": "selector", "operator": "equal", "operand": "source.js", "match_all": true }]
},
{ "keys": [ "ctrl+shift+i" ], "command": "iifefy_skip_initial_comments", "context":
    [{ "key": "selector", "operator": "equal", "operand": "source.js", "match_all": true }]
}
```

## Contributing

1. Fork the repository
2. Create your feature branch: `git checkout -b my-new-feature`
3. Commit your changes: `git commit -am 'Add some feature'`
4. Push to the branch: `git push origin my-new-feature`
5. Submit a pull request

## License

Code copyright 2014 Professant LLC. Code released under [the MIT License][license].

[pkgcontrol]: https://sublime.wbond.net
[pkgcontrol-install]: https://sublime.wbond.net/installation
[zip]: https://github.com/erquhart/sublime-iifefy/archive/master.zip
[license]: https://github.com/erquhart/sublime-iifefy/blob/master/LICENSE