This project is no longer being maintained

This project has been ported to an atom editor package. Please let us know if you are interested in taking ownership.

Linux	Windows

OSX is supported for this project but does not have build status badge yet.

AMD Butler v1.4.0

Serving Up AMD Module Imports

A Sublime Text 3 plugin for managing AMD dependency import statements. It helps you quickly sort, add, and remove AMD import statements. With features such as auto sorting and auto module name discovery it allows you to focus more on your code rather than worrying your AMD imports.

Commands

AMD Butler: Sort Imports

Sorts the existing AMD imports for the current file alphabetically. Packages are separated by a blank line. The corresponding parameter names are also reordered.

AMD Butler: Add Import

Searches your packages for possible imports and displays them in the quick panel. When an import is selected it is added to the imports for the current file. The imports for the current file are then sorted. NOTE: The file that you execute this command from must be a descendant of the packages folder path.

To prevent duplicate, imports that are already in the current file are excluded from the list.

Argument aliases are usually returned as the file name of the module (e.g. dojo/_base/array => array). However, if the file name is a reserved word in JavaScript the package name is prepended to the beginning of the file name (e.g. dojo/string => dojoString). Preferred argument aliases are also taken into account if they do not follow the standard conventions.

AMD Butler: Remove Import

Displays a quick list of all of your current imports. Selecting an import from the quick list removes it from your file. The imports are also automatically sorted.

AMD Butler: Refresh Available Imports

Refreshes the cache of available imports for the current view. This can be helpful after creating a new file that you want to import into the current view.

AMD Butler: Prune Unused Imports

Removes any import who's parameter does not show up in the module body.

Installation

Via Package Control

The preferred method for installation is via package control. First install package control, then run the “Package Control: Install Package” command and search for “AMD Butler”.

Manual Install

Clone the source code for this plugin to your Sublime Packages folder.

Settings

These settings can be set either at the package level (Preferences -> Package Settings -> AmdButler) or at the project level within the .sublime-project file.

amd_butler_packages_base_path

Type: String
The name of the folder containing your AMD packages. This folder is crawled and all files are made available as imports for the “Add AMD Import” command.

Note: No manual editing of this setting is needed. The user is prompted for the value if it's not present in either the project or package settings the first time that the “Add AMD Import” or “Refresh Available Imports” commands are run.

amd_butler_params_one_line

Type: Boolean
If true, the params will be rewritten to one line per section (instead of the default (false), one line per parameter).

Contributing

Please match existing code style.

To execute tests use the UnitTesting sublime package.