[ { "path": ".codeintel/config", "content": "{\n\t\"Python\": {\n\t\t\"pythonExtraPaths\": [\n\t\t\t\"libs\",\n\t\t\t\"~/Applications/Sublime Text 2.app/Contents/MacOS\",\n\t\t\t\"/Applications/Sublime Text 2.app/Contents/MacOS\"\n\t\t]\n\t}\n}\n" }, { "path": ".gitignore", "content": ".git\n.hg\n.svn\n\n*.pyc\n*.pyo\n\n.DS_Store\n" }, { "path": "Default (Linux).sublime-keymap", "content": "[\n { \"keys\": [\"ctrl+alt+l\"], \"command\": \"sublimelinter\", \"args\": {\"action\": \"lint\"} },\n { \"keys\": [\"ctrl+alt+e\"], \"command\": \"find_next_lint_error\" },\n { \"keys\": [\"ctrl+alt+shift+e\"], \"command\": \"find_previous_lint_error\" }\n]\n" }, { "path": "Default (OSX).sublime-keymap", "content": "[\n { \"keys\": [\"ctrl+super+l\"], \"command\": \"sublimelinter\", \"args\": {\"action\": \"lint\"} },\n { \"keys\": [\"ctrl+super+e\"], \"command\": \"find_next_lint_error\" },\n { \"keys\": [\"ctrl+super+shift+e\"], \"command\": \"find_previous_lint_error\" }\n]\n" }, { "path": "Default (Windows).sublime-keymap", "content": "[\n { \"keys\": [\"ctrl+alt+l\"], \"command\": \"sublimelinter\", \"args\": {\"action\": \"lint\"} },\n { \"keys\": [\"ctrl+alt+e\"], \"command\": \"find_next_lint_error\" },\n { \"keys\": [\"ctrl+alt+shift+e\"], \"command\": \"find_previous_lint_error\" }\n]\n" }, { "path": "Default.sublime-commands", "content": "[\n {\n \"caption\": \"SublimeLinter: Lint Current File\",\n \"command\": \"sublimelinter_lint\",\n \"args\": {\"action\": \"lint\"}\n },\n {\n \"caption\": \"SublimeLinter: Show Error List\",\n \"command\": \"sublimelinter_show_errors\",\n \"args\": {\"action\": \"lint\", \"show_popup\": true}\n },\n {\n \"caption\": \"SublimeLinter: Background Linting\",\n \"command\": \"sublimelinter_lint\",\n \"args\": {\"action\": \"on\"}\n },\n {\n \"caption\": \"SublimeLinter: Load-Save Linting\",\n \"command\": \"sublimelinter_enable_load_save\",\n \"args\": {\"action\": \"load-save\"}\n },\n {\n \"caption\": \"SublimeLinter: Save-Only Linting\",\n \"command\": \"sublimelinter_enable_save_only\",\n \"args\": {\"action\": \"save-only\"}\n },\n {\n \"caption\": \"SublimeLinter: Disable Linting\",\n \"command\": \"sublimelinter_disable\",\n \"args\": {\"action\": \"off\"}\n },\n {\n \"caption\": \"SublimeLinter: Extract Annotations\",\n \"command\": \"sublimelinter_annotations\",\n \"args\": {}\n },\n {\n \"caption\": \"SublimeLinter: Reset\",\n \"command\": \"sublimelinter_lint\",\n \"args\": {\"action\": \"reset\"}\n },\n {\n \"caption\": \"Preferences: SublimeLinter Settings – Default\",\n \"command\": \"open_file\", \"args\":\n {\n \"file\": \"${packages}/SublimeLinter/SublimeLinter.sublime-settings\"\n }\n },\n {\n \"caption\": \"Preferences: SublimeLinter Settings – User\",\n \"command\": \"open_file\", \"args\":\n {\n \"file\": \"${packages}/User/SublimeLinter.sublime-settings\"\n }\n }\n]\n" }, { "path": "LICENSE", "content": "Copyright Germán M. Bravo, Aparajita Fishman, Jacob Swartwood, and other\ncontributors.\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in\nall copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\nTHE SOFTWARE.\n" }, { "path": "Main.sublime-menu", "content": "[\n {\n \"caption\": \"Preferences\",\n \"mnemonic\": \"n\",\n \"id\": \"preferences\",\n \"children\":\n [\n {\n \"caption\": \"Package Settings\",\n \"mnemonic\": \"P\",\n \"id\": \"package-settings\",\n \"children\":\n [\n {\n \"caption\": \"SublimeLinter\",\n \"children\":\n [\n {\n \"command\": \"open_file\",\n \"args\": {\"file\": \"${packages}/SublimeLinter/README.md\"},\n \"caption\": \"README\"\n },\n {\n \"command\": \"open_file\",\n \"args\": {\"file\": \"${packages}/SublimeLinter/changelog.txt\"},\n \"caption\": \"Change Log\"\n },\n { \"caption\": \"-\" },\n {\n \"command\": \"open_file\",\n \"args\": {\"file\": \"${packages}/SublimeLinter/SublimeLinter.sublime-settings\"},\n \"caption\": \"Settings – Default\"\n },\n {\n \"command\": \"open_file\",\n \"args\": {\"file\": \"${packages}/User/SublimeLinter.sublime-settings\"},\n \"caption\": \"Settings – User\"\n },\n {\n \"command\": \"open_file_settings\",\n \"caption\": \"Settings – Syntax Specific – User\"\n },\n { \"caption\": \"-\" },\n {\n \"command\": \"open_file\",\n \"args\": {\n \"file\": \"${packages}/SublimeLinter/Default (OSX).sublime-keymap\",\n \"platform\": \"OSX\"\n },\n \"caption\": \"Key Bindings – Default\"\n },\n {\n \"command\": \"open_file\",\n \"args\": {\n \"file\": \"${packages}/SublimeLinter/Default (Linux).sublime-keymap\",\n \"platform\": \"Linux\"\n },\n \"caption\": \"Key Bindings – Default\"\n },\n {\n \"command\": \"open_file\",\n \"args\": {\n \"file\": \"${packages}/SublimeLinter/Default (Windows).sublime-keymap\",\n \"platform\": \"Windows\"\n },\n \"caption\": \"Key Bindings – Default\"\n },\n {\n \"command\": \"open_file\",\n \"args\": {\n \"file\": \"${packages}/User/Default (OSX).sublime-keymap\",\n \"platform\": \"OSX\"\n },\n \"caption\": \"Key Bindings – User\"\n },\n {\n \"command\": \"open_file\",\n \"args\": {\n \"file\": \"${packages}/User/Default (Linux).sublime-keymap\",\n \"platform\": \"Linux\"\n },\n \"caption\": \"Key Bindings – User\"\n },\n {\n \"command\": \"open_file\",\n \"args\": {\n \"file\": \"${packages}/User/Default (Windows).sublime-keymap\",\n \"platform\": \"Windows\"\n },\n \"caption\": \"Key Bindings – User\"\n },\n { \"caption\": \"-\" }\n ]\n }\n ]\n }\n ]\n }\n]\n" }, { "path": "README.md", "content": "SublimeLinter\n=============\n\n## SublimeLinter 3 has landed!\n\nSublimeLinter for Sublime Text 3 is [here](https://github.com/SublimeLinter/SublimeLinter3), and it’s soooooo much better than before! Install it from Package Control and enjoy!\n\nUnless someone else comes forward, SublimeLinter for Sublime Text 2 will no longer be supported. I strongly encourage everyone to upgrade to Sublime Text 3 and SublimeLinter 3 — you’ll be glad you did! Take a look at the [extensive documentation](http://sublimelinter.readthedocs.org/) to see the great new features in SublimeLinter 3.\n\n## Share the love!\n\nI spent hundreds of hours writing and documenting SublimeLinter 3 to make it the best it can be — easy to use, easy to configure, easy to update, easy to extend. If you use SublimeLinter and feel it is making your coding life better and easier, please consider making a donation to help fund development and support. Thank you!\n\nTo donate: https://github.com/SublimeLinter/SublimeLinter3#share-the-love\n\nThank you for your support!\n\n---\n\nSublimeLinter v1.7 Overview\n---------\n\nSublimeLinter is a plugin that supports \"lint\" programs (known as \"linters\"). SublimeLinter highlights\nlines of code the linter deems to contain (potential) errors. It also\nsupports highlighting special annotations (for example: TODO) so that they\ncan be quickly located.\n\nSublimeLinter has built in linters for the following languages:\n\n* C/C++ - lint via `cppcheck`\n* CoffeeScript - lint via `coffee -s -l`\n* CSS - lint via built-in [csslint](http://csslint.net)\n* Git Commit Messages - lint via built-in module based on [A Note About Git Commit Messages](http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html).\n* Haml - syntax check via `haml -c`\n* HTML - lint via `tidy` (actually [tidy for HTML5](http://w3c.github.com/tidy-html5/))\n* Java - lint via `javac -Xlint`\n* JavaScript - lint via built in [jshint](http://jshint.org), [jslint](http://jslint.com), or the [closure linter (gjslint)](https://developers.google.com/closure/utilities/docs/linter_howto) (if installed)\n* Lua - syntax check via `luac`\n* Objective-J - lint via built-in [capp_lint](https://github.com/aparajita/capp_lint)\n* Perl - lint via [Perl::Critic](http://perlcritic.com/) or syntax+deprecation check via `perl -c`\n* PHP - syntax check via `php -l`\n* Puppet - syntax check via `puppet parser validate` or `puppet-lint`\n* Python - native, moderately-complete lint\n* Ruby - syntax check via `ruby -wc`\n* Squirrel - syntax check via `sq`\n* XML - lint via `xmllint`\n\nQuickstart\n------------\n\n* Install using [Package Control ST2 plugin](http://wbond.net/sublime_packages/package_control/installation).\n* `SublimeLinter` runs in the background (by default), linting files for style and potential errors.\n* Season to taste (edit configuration) by editing `Preferences->Package Settings->SublimeLinter->Settings - User`.\n* Produce better code!\n\n\nInstalling\n----------\n**With the Package Control plugin:** The easiest way to install SublimeLinter is through Package Control, which can be found at this site: http://wbond.net/sublime_packages/package_control\n\nOnce you install Package Control, restart ST2 and bring up the Command Palette (`Command+Shift+P` on OS X, `Control+Shift+P` on Linux/Windows). Select \"Package Control: Install Package\", wait while Package Control fetches the latest package list, then select SublimeLinter when the list appears. The advantage of using this method is that Package Control will automatically keep SublimeLinter up to date with the latest version.\n\n**Without Git:** Download the latest source from [GitHub](https://github.com/SublimeLinter/SublimeLinter) and copy the SublimeLinter folder to your Sublime Text \"Packages\" directory.\n\n**With Git:** Clone the repository in your Sublime Text \"Packages\" directory:\n\n git clone https://github.com/SublimeLinter/SublimeLinter.git\n\n\nThe \"Packages\" directory is located at:\n\n* OS X:\n\n ~/Library/Application Support/Sublime Text 2/Packages/\n\n* Linux:\n\n ~/.config/sublime-text-2/Packages/\n\n* Windows:\n\n %APPDATA%/Sublime Text 2/Packages/\n\n### JavaScript-based linters\nIf you plan to edit files that use a JavaScript-based linter (JavaScript, CSS), your system\nmust have a JavaScript engine installed. Mac OS X comes with a preinstalled JavaScript engine called\nJavaScriptCore, which is used if Node.js is not installed. On Windows, you **must** install the\nJavaScript engine Node.js, which can be downloaded from [the Node.js site](http://nodejs.org/#download).\n\nOn Mac OS X, you **must** install Node.js if you plan to edit JavaScript or CSS files that\nuse non-ASCII characters in strings or comments, because JavaScriptCore is not Unicode-aware.\n\nAfter installing Node.js, if the Node.js executable (\"node\" on Mac OS X, \"node.exe\" on Windows)\ncannot be found by SublimeLinter, you may have to set the path to the executable in the\n\"sublimelinter\\_executable\\_map\" setting. See the \"Configuring\" section below for info on\nSublimeLinter settings.\n\n\nUsing\n-----\nSublimeLinter runs in one of three modes, which is determined by the \"sublimelinter\" user setting:\n\n* **Background mode (the default)** - When the \"sublimelinter\" setting is true, linting is performed in the background as you modify a file (if the relevant linter supports it). If you like instant feedback, this is the best way to use SublimeLinter. If you want feedback, but not instantly, you can try another mode or set a minimum queue delay with the \"sublimelinter_delay\" setting, so that the linter will only run after a certain amount of idle time.\n* **Load-save mode** - When the \"sublimelinter\" setting is \"load-save\", linting is performed only when a file is loaded and after saving. Errors are cleared as soon as the file is modified.\n* **Save-only mode** - When the \"sublimelinter\" setting is \"save-only\", linting is performed only after a file is saved. Errors are cleared as soon as the file is modified.\n* **On demand mode** - When the \"sublimelinter\" setting is false, linting is performed only when initiated by you. Use the `Control+Command+L` (OS X) or `Control+Alt+L` (Linux/Windows) key equivalent or the Command Palette to lint the current file. If the current file has no associated linter, the command will not be available.\n\nWithin a file whose language/syntax is supported by SublimeLinter, you can control SublimeLinter via the Command Palette (`Command+Shift+P` on OS X, `Control+Shift+P` on Linux/Windows). The available commands are:\n\n* **SublimeLinter: Lint Current File** - Lints the current file, highlights any errors and displays how many errors were found.\n* **SublimeLinter: Show Error List** - Lints the current file, highlights any errors and displays a quick panel with any errors that are found. Selecting an item from the quick panel jumps to that line.\n* **SublimeLinter: Background Linting** - Enables background linting mode for the current view and lints it.\n* **SublimeLinter: Disable Linting** - Disables linting mode for the current view and clears all lint errors.\n* **SublimeLinter: Load-Save Linting** - Enables load-save linting mode for the current view and clears all lint errors.\n* **SublimeLinter: Save-Only Linting** - Enables save-only linting mode for the current view and clears all lint errors.\n* **SublimeLinter: Reset** - Clears all lint errors and sets the linting mode to the value in the SublimeLinter.sublime-settings file.\n\nDepending on the file and the current state of background enabling, some of the commands will not be available.\n\nWhen an error is highlighted by the linter, putting the cursor on the offending line will result in the error message being displayed on the status bar.\n\nIf you want to be shown a popup list of all errors whenever a file is saved, modify the user setting:\n\n \"sublimelinter_popup_errors_on_save\": true\n\nIf there are errors in the file, a quick panel will appear which shows the error message, line number and source code for each error. The starting location of all errors on the line are marked with \"^\". Selecting an error in the quick panel jumps directly to the location of the first error on that line.\n\nWhile editing a file, you can quickly move to the next/previous lint error with the following key equivalents:\n\n* **OS X**:\n\n next: Control+Command+E\n prev: Control+Command+Shift+E\n\n* **Linux, Windows**:\n\n next: Control+Alt+E\n prev: Control+Alt+Shift+E\n\nBy default the search will wrap. You can turn wrapping off with the user setting:\n\n \"sublimelinter_wrap_find\": false\n\nPlease note: these key commands may conflict with other important cmds (such as generating the € character - this was discussed in issue [#182](https://github.com/SublimeLinter/SublimeLinter/issues/182)). If these controls are problematic, you may always adjust your settings by copying the defaults stored in `Preferences->Package Settings->SublimeLinter->Key Bindings - Default` into `Preferences->Key Bindings - User` and then modifying the values appropriately.\n\nConfiguring\n-----------\nThere are a number of settings available to customize the behavior of SublimeLinter and its linters. For the latest information on what settings are available, select the menu item `Preferences->Package Settings->SublimeLinter->Settings - Default`.\n\nDo **NOT** edit the default SublimeLinter settings. Your changes will be lost when SublimeLinter is updated. ALWAYS edit the user SublimeLinter settings by selecting `Preferences->Package Settings->SublimeLinter->Settings - User`. Note that individual settings you include in your user settings will _completely_ replace the corresponding default setting, so you must provide that setting in its entirety.\n\n### Linter-specific notes\nFollowing are notes specific to individual linters that you should be aware of:\n\n* **C/C++** - The default C/C++ linter is [cppcheck](http://cppcheck.sourceforge.net/), however Google's [cpplint.py](http://google-styleguide.googlecode.com/svn/trunk/cpplint/) is also supported.\n\n To swap `cppcheck` out for `cpplint.py` you will need to adjust `sublimelinter_syntax_map` and possibly `sublimelinter_executable_map` also. First change the _linter language_ for `C` and `C++` to `c_cpplint` via `sublimelinter_syntax_map`. If `cpplint.py` is not on your system `PATH`, then add an entry for `c_cpplint` into `sublimelinter_executable_map` with the path to the file. As usual add these adjustments to the SublimeLinter **User Settings** file. An example:\n\n \"sublimelinter_syntax_map\":\n {\n \"Python Django\": \"python\",\n \"Ruby on Rails\": \"ruby\",\n \"C++\": \"c_cpplint\",\n \"C\": \"c_cpplint\"\n },\n \"sublimelinter_executable_map\":\n {\n \"c_cpplint\": \"/Users/[my username]/Desktop/cpplint.py\"\n }\n\n* **CSS** - This linter runs [csslint](http://csslint.net). This linter requires a JavaScript engine (like Node.js) to be installed (see notes above for the JavaScript linters: \"jshint\" or \"jslint\").\n\n By default all CSSLint settings are turned on. You may customize CSSLint behavior with the \"csslint_options\" setting. Please select `Preferences->Package Settings->SublimeLinter->Settings - Default` for more information on turning off or adjusting severity of tests. For more information about options available to CSSLint, see https://github.com/stubbornella/csslint/wiki/Rules.\n\n* **HTML** - This linter will not run unless you have a version of tidy with HTML5 support. To use this linter, please see: https://github.com/w3c/tidy-html5\n\n* **Java** - Because it uses `javac` to do linting, each time you run the linter the entire dependency graph of the current file will be checked. Depending on the number of classes you import, this can be **extremely** slow. Also note that you **must** provide the `-sourcepath`, `-classpath`, `-Xlint` and `{filename}` arguments to `javac` in your per-project settings. See \"Per-project settings\" below for more information.\n\n* **JavaScript** - If the \"javascript_linter\" setting is \"jshint\" or \"jslint\", this linter runs [jshint](http://jshint.org) (or [jslint](http://jslint.com) respectively) using Node.js. See \"JavaScript-based linters\" above for information on how to install Node.js.\n\n If the \"javascript_linter\" setting is \"gjslint\", this linter runs the [closure linter (gjslint)](https://developers.google.com/closure/utilities/docs/linter_howto). After installation, if gjslint cannot be found by SublimeLinter, you may have to set the path to gjslint in the \"sublimelinter\\_executable\\_map\" setting.\n\n You may want to modify the options passed to jshint, jslint, or gjslint. This can be done by using the **jshint_options**, **jslint_options**, or **gjslint_options** setting. Refer to the jshint.org site, the jslint.com site, or run `gjslint --help` for more information on the configuration options available.\n\n SublimeLinter supports `.jshintrc` files. If using JSHint, SublimeLinter will recursively search the directory tree (from the file location to the file-system root directory). This functionality is specified in the [JSHint README](https://github.com/jshint/node-jshint/#within-your-projects-directory-tree).\n\n* **Perl** - Due to a vulnerability (issue [#77](https://github.com/SublimeLinter/SublimeLinter/issues/77)) with the Perl linter, Perl syntax checking is no longer enabled by default. The default linter for Perl has been replaced by Perl::Critic. The standard Perl syntax checker can still be invoked by switching the \"perl_linter\" setting to \"perl\".\n\n* **Puppet** - Optional alternative linter using puppet-lint. Install with `gem install puppet-lint`. Add these adjustments to the SublimeLinter **User Settings** file. An example:\n\"sublimelinter_syntax_map\": { \"Puppet\": \"puppet-lint\" }. Note this only lints on file save.\n\n* **Ruby** - If you are using rvm or rbenv, you will probably have to specify the full path to the ruby you are using in the \"sublimelinter_executable_map\" setting. See \"Configuring\" below for more info.\n\n### Per-project settings\nSublimeLinter supports per-project/per-language settings. This is useful if a linter requires path configuration on a per-project basis. To edit your project settings, select the menu item `Project->Edit Project`. If there is no \"settings\" object at the top level, add one and then add a \"SublimeLinter\" sub-object, like this:\n\n {\n \"folders\":\n [\n {\n \"path\": \"/Users/aparajita/Projects/foo/src\"\n }\n ],\n \"settings\":\n {\n \"SublimeLinter\":\n {\n }\n }\n }\n\nWithin the \"SublimeLinter\" object, you can add a settings object for each language. The language name must match the language item in the linter's CONFIG object, which can be found in the linter's source file in the SublimeLinter/sublimelinter/modules folder. Each language can have two settings:\n\n* \"working_directory\" - If present and a valid absolute directory path, the working directory is set to this path before the linter executes. This is useful if you are providing linter arguments that contain paths and you want to use working directory-relative paths instead of absolute paths.\n* \"lint_args\" - If present, it must be a sequence of string arguments to pass to the linter. If your linter expects a filename as an argument, use the argument \"{filename}\" as a placeholder. If it expects stdin, use \"-\". Note that if you provide this item, you are responsible for passing **all** required arguments to the linter, as it will override default arguments.\n\nFor example, let's say we are editing a Java project and want to use the \"java\" linter, which requires a source path and class path. In addition, we want to ignore serialization errors. Our project settings might look like this:\n\n {\n \"folders\":\n [\n {\n \"path\": \"/Users/aparajita/Projects/foo/src\"\n }\n ],\n \"settings\":\n {\n \"SublimeLinter\":\n {\n \"Java\":\n {\n \"working_directory\": \"/Users/aparajita/Projects/foo\",\n\n \"lint_args\":\n [\n \"-sourcepath\", \"src\",\n \"-classpath\", \"libs/log4j-1.2.9.jar:libs/commons-logging-1.1.jar\",\n \"-Xlint\", \"-Xlint:-serial\",\n \"{filename}\"\n ]\n }\n }\n }\n }\n\nThe jshint follows convention set by node-jshint (though node is not required) and will attempt to locate the configuration file for you starting in pwd. (or \"present working directory\") If this does not yield a .jshintrc file, it will move one level up (..) the directory tree all the way up to the filesystem root. If a file is found, it stops immediately and uses that set of configuration instead of \"jshint_options\".\n\n### Customizing colors\n**IMPORTANT** - The theme style names have recently changed. The old and new color\nnames are:\n\n Old New\n --------------------- -----------------------------\n sublimelinter. sublimelinter.outline.\n invalid. sublimelinter.underline.\n\nPlease change the names in your color themes accordingly.\n\nThere are three types of \"errors\" flagged by SublimeLinter: illegal,\nviolation, and warning. For each type, SublimeLinter will indicate the offending\nline and the character position at which the error occurred on the line.\n\nBy default SublimeLinter will outline offending lines using the background color\nof the \"sublimelinter.outline.\" theme style, and underline the character position\nusing the background color of the \"sublimelinter.underline.\" theme style, where \nis one of the three error types.\n\nIf these styles are not defined, the color will be black when there is a light\nbackground color and black when there is a dark background color. You may\ndefine a single \"sublimelinter.outline\" or \"sublimelinter.underline\" style to color all three types,\nor define separate substyles for one or more types to color them differently.\n\nIf you want to make the offending lines glaringly obvious (perhaps for those\nwho tend to ignore lint errors), you can set the user setting:\n\n \"sublimelinter_mark_style\": \"fill\"\n\nWhen this is set true, lines that have errors will be colored with the background\nand foreground color of the \"sublime.outline.\" theme style. Unless you have defined\nthose styles, this setting should be left as \"outline\".\n\nYou may want to disable drawing of outline boxes entirely. If so, change\nusing the user setting to:\n\n \"sublimelinter_mark_style\": \"none\"\n\nYou may also mark lines with errors by putting an \"x\" in the gutter with the user setting:\n\n \"sublimelinter_gutter_marks\": true\n\nTo customize the colors used for highlighting errors and user notes, add the following\nto your theme (adapting the color to your liking):\n\n \n name\n SublimeLinter Annotations\n scope\n sublimelinter.annotations\n settings\n \n background\n #FFFFAA\n foreground\n #FFFFFF\n \n \n \n name\n SublimeLinter Error Outline\n scope\n sublimelinter.outline.illegal\n settings\n \n background\n #FF4A52\n foreground\n #FFFFFF\n \n \n \n name\n SublimeLinter Error Underline\n scope\n sublimelinter.underline.illegal\n settings\n \n background\n #FF0000\n \n \n \n name\n SublimeLinter Warning Outline\n scope\n sublimelinter.outline.warning\n settings\n \n background\n #DF9400\n foreground\n #FFFFFF\n \n \n \n name\n SublimeLinter Warning Underline\n scope\n sublimelinter.underline.warning\n settings\n \n background\n #FF0000\n \n \n \n name\n SublimeLinter Violation Outline\n scope\n sublimelinter.outline.violation\n settings\n \n background\n #ffffff33\n foreground\n #FFFFFF\n \n \n \n name\n SublimeLinter Violation Underline\n scope\n sublimelinter.underline.violation\n settings\n \n background\n #FF0000\n \n \n\nTroubleshooting\n---------------\nIf a linter does not seem to be working, you can check the ST2 console to see if it was enabled. When SublimeLinter is loaded, you will see messages in the console like this:\n\n Reloading plugin /Users/aparajita/Library/Application Support/Sublime Text 2/Packages/SublimeLinter/sublimelinter_plugin.py\n SublimeLinter: JavaScript loaded\n SublimeLinter: annotations loaded\n SublimeLinter: Objective-J loaded\n SublimeLinter: perl loaded\n SublimeLinter: php loaded\n SublimeLinter: python loaded\n SublimeLinter: ruby loaded\n SublimeLinter: pylint loaded\n\nThe first time a linter is asked to lint, it will check to see if it can be enabled. You will then see messages like this:\n\n SublimeLinter: JavaScript enabled (using JavaScriptCore)\n SublimeLinter: Ruby enabled (using \"ruby\" for executable)\n\nLet's say the ruby linter is not working. If you look at the console, you may see a message like this:\n\n SublimeLinter: ruby disabled (\"ruby\" cannot be found)\n\nThis means that the ruby executable cannot be found on your system, which means it is not installed or not in your executable path.\n\nCreating New Linters\n--------------------\nIf you wish to create a new linter to support a new language, SublimeLinter makes it easy. Here are the steps involved:\n\n* Create a new file in sublimelinter/modules. If your linter uses an external executable, you will probably want to copy perl.py. If your linter uses built in code, copy objective-j.py. The convention is to name the file the same as the language that will be linted.\n\n* Configure the CONFIG dict in your module. See the comments in base\\_linter.py for information on the values in that dict. You only need to set the values in your module that differ from the defaults in base\\_linter.py, as your module's CONFIG is merged with the default. Note that if your linter uses an external executable that does not take stdin, setting 'input\\_method' to INPUT\\_METHOD\\_TEMP\\_FILE will allow interactive linting with that executable.\n\n* If your linter uses built in code, override `built_in_check()` and return the errors found.\n\n* Override `parse_errors()` and process the errors. If your linter overrides `built_in_check()`, `parse_errors()` will receive the result of that method. If your linter uses an external executable, `parse_errors()` receives the raw output of the executable, stripped of leading and trailing whitespace.\n\n* If you linter is powered via JavaScript (eg. Node.js), there are few steps that will simplify the integration.\n\n Create a folder matching your linter name in the `SublimeLinter/sublimelinter/modules/lib` directory. This folder should include the linting library JS file (eg. jshint.js, csslint-Node.js) and a **linter.js** file. The **linter.js** file should `require()` the actual linter library file and export a `lint()` function. The `lint()` function should return a list of errors back to the python language handler file (via the `errors` parameter to the `parse_errors()` method).\n\n Although **linter.js** should follow the Node.js api, the linter may also be run via JavaScriptCore on OS X if Node.js is not installed. In the case where JavaScriptCore is used, require + export are shimmed to keep things consistent. However, it is important not to assume that a full Node.js api is available. If you must know what JS engine you are using, you may check for `USING_JSC` to be set as `true` when JavaScriptCore is used.\n\n For examples of using the JS engines, see **csslint**, **jslint**, and **jshint** in `SublimeLinter/sublimelinter/modules/libs` and the respective python code of **css.py** and **javascript.py** in `SublimeLinter/sublimelinter/modules`.\n\n\nIf your linter has more complex requirements, see the comments for CONFIG in base\\_linter.py, and use the existing linters as guides.\n\nBeta\n----\nThe SublimeLinter Beta package is available via Package Control. The beta version is considered unstable and should only be used for testing the next release. If you like living on the edge, please report any bugs you find on the [SublimeLinter issues](https://github.com/SublimeLinter/SublimeLinter/issues) page.\n" }, { "path": "SublimeLinter.py", "content": "from functools import partial\nimport os\nimport re\nimport sys\nimport time\nimport threading\n\nimport sublime\nimport sublime_plugin\n\nfrom sublimelinter.loader import Loader\nfrom sublimelinter.modules.base_linter import INPUT_METHOD_FILE\n\nLINTERS = {} # mapping of language name to linter module\nQUEUE = {} # views waiting to be processed by linter\nERRORS = {} # error messages on given line obtained from linter; they are\n # displayed in the status bar when cursor is on line with error\nVIOLATIONS = {} # violation messages, they are displayed in the status bar\nWARNINGS = {} # warning messages, they are displayed in the status bar\nUNDERLINES = {} # underline regions related to each lint message\nTIMES = {} # collects how long it took the linting to complete\nMOD_LOAD = Loader(os.getcwdu(), LINTERS) # utility to load (and reload\n # if necessary) linter modules [useful when working on plugin]\n\n\n# For snappier linting, different delays are used for different linting times:\n# (linting time, delays)\nDELAYS = (\n (50, (50, 100)),\n (100, (100, 300)),\n (200, (200, 500)),\n (400, (400, 1000)),\n (800, (800, 2000)),\n (1600, (1600, 3000)),\n)\n\n# Select one of the predefined gutter mark themes, the options are:\n# \"alpha\", \"bright\", \"dark\", \"hard\" and \"simple\"\nMARK_THEMES = ('alpha', 'bright', 'dark', 'hard', 'simple')\n# The path to the built-in gutter mark themes\nMARK_THEMES_PATH = os.path.join('..', 'SublimeLinter', 'gutter_mark_themes')\n# The original theme for anyone interested the previous minimalist approach\nORIGINAL_MARK_THEME = {\n 'violation': 'dot',\n 'warning': 'dot',\n 'illegal': 'circle'\n}\n\n# All available settings for SublimeLinter;\n# only these are inherited from SublimeLinter.sublime-settings\nALL_SETTINGS = [\n 'annotations',\n 'csslint_options',\n 'gjslint_ignore',\n 'gjslint_options',\n 'javascript_linter',\n 'jshint_options',\n 'jslint_options',\n 'pep8',\n 'pep8_ignore',\n 'perl_linter',\n 'pyflakes_ignore',\n 'pyflakes_ignore_import_*',\n 'sublimelinter',\n 'sublimelinter_delay',\n 'sublimelinter_disable',\n 'sublimelinter_executable_map',\n 'sublimelinter_fill_outlines',\n 'sublimelinter_gutter_marks',\n 'sublimelinter_gutter_marks_theme',\n 'sublimelinter_mark_style',\n 'sublimelinter_notes',\n 'sublimelinter_objj_check_ascii',\n 'sublimelinter_popup_errors_on_save',\n 'sublimelinter_syntax_map',\n 'sublimelinter_wrap_find',\n]\n\n\nWHITESPACE_RE = re.compile(r'\\s+')\n\n\ndef get_delay(t, view):\n delay = 0\n\n for _t, d in DELAYS:\n if _t <= t:\n delay = d\n else:\n break\n\n delay = delay or DELAYS[0][1]\n\n # If the user specifies a delay greater than the built in delay,\n # figure they only want to see marks when idle.\n minDelay = int(view.settings().get('sublimelinter_delay', 0) * 1000)\n\n if minDelay > delay[1]:\n erase_lint_marks(view)\n\n return (minDelay, minDelay) if minDelay > delay[1] else delay\n\n\ndef last_selected_lineno(view):\n viewSel = view.sel()\n if not viewSel:\n return None\n return view.rowcol(viewSel[0].end())[0]\n\n\ndef update_statusbar(view):\n vid = view.id()\n lineno = last_selected_lineno(view)\n errors = []\n\n if lineno is not None:\n if vid in ERRORS and lineno in ERRORS[vid]:\n errors.extend(ERRORS[vid][lineno])\n\n if vid in VIOLATIONS and lineno in VIOLATIONS[vid]:\n errors.extend(VIOLATIONS[vid][lineno])\n\n if vid in WARNINGS and lineno in WARNINGS[vid]:\n errors.extend(WARNINGS[vid][lineno])\n\n if errors:\n view.set_status('Linter', '; '.join(errors))\n else:\n view.erase_status('Linter')\n\n\ndef run_once(linter, view, **kwargs):\n '''run a linter on a given view regardless of user setting'''\n if not linter:\n return\n\n vid = view.id()\n ERRORS[vid] = {}\n VIOLATIONS[vid] = {}\n WARNINGS[vid] = {}\n start = time.time()\n text = view.substr(sublime.Region(0, view.size())).encode('utf-8')\n lines, error_underlines, violation_underlines, warning_underlines, ERRORS[vid], VIOLATIONS[vid], WARNINGS[vid] = linter.run(view, text, (view.file_name() or '').encode('utf-8'))\n\n UNDERLINES[vid] = error_underlines[:]\n UNDERLINES[vid].extend(violation_underlines)\n UNDERLINES[vid].extend(warning_underlines)\n\n add_lint_marks(view, lines, error_underlines, violation_underlines, warning_underlines)\n\n if view.settings().get('sublimelinter_notes'):\n highlight_notes(view)\n\n update_statusbar(view)\n end = time.time()\n TIMES[vid] = (end - start) * 1000 # Keep how long it took to lint\n\n if kwargs.get('event', None) == 'on_post_save' and view.settings().get('sublimelinter_popup_errors_on_save'):\n popup_error_list(view)\n\n\ndef popup_error_list(view):\n vid = view.id()\n errors = ERRORS[vid].copy()\n\n for message_map in [VIOLATIONS[vid], WARNINGS[vid]]:\n for line, messages in message_map.items():\n if line in errors:\n errors[line].extend(messages)\n else:\n errors[line] = messages\n\n # Flatten the errors into a list\n error_list = []\n\n for line in sorted(errors.keys()):\n for index, message in enumerate(errors[line]):\n error_list.append({'line': line, 'message': message})\n\n panel_items = []\n\n for error in error_list:\n line_text = view.substr(view.full_line(view.text_point(error['line'], 0)))\n item = [error['message'], u'{0}: {1}'.format(error['line'] + 1, line_text.strip())]\n panel_items.append(item)\n\n def on_done(selected_item):\n if selected_item == -1:\n return\n\n selected = view.sel()\n selected.clear()\n\n error = error_list[selected_item]\n region_begin = view.text_point(error['line'], 0)\n\n # Go to the first non-whitespace character of the line\n line_text = view.substr(view.full_line(region_begin))\n match = WHITESPACE_RE.match(line_text)\n\n if (match):\n region_begin += len(match.group(0))\n\n selected.add(sublime.Region(region_begin, region_begin))\n # We have to force a move to update the cursor position\n view.run_command('move', {'by': 'characters', 'forward': True})\n view.run_command('move', {'by': 'characters', 'forward': False})\n view.show_at_center(region_begin)\n\n view.window().show_quick_panel(panel_items, on_done)\n\n\ndef add_lint_marks(view, lines, error_underlines, violation_underlines, warning_underlines):\n '''Adds lint marks to view.'''\n vid = view.id()\n erase_lint_marks(view)\n types = {'warning': warning_underlines, 'violation': violation_underlines, 'illegal': error_underlines}\n\n for type_name, underlines in types.items():\n if underlines:\n view.add_regions('lint-underline-' + type_name, underlines, 'sublimelinter.underline.' + type_name, sublime.DRAW_EMPTY_AS_OVERWRITE)\n\n if lines:\n outline_style = view.settings().get('sublimelinter_mark_style', 'outline')\n\n # This test is for the legacy \"fill\" setting; it will be removed\n # in a future version (likely v1.7).\n if view.settings().get('sublimelinter_fill_outlines', False):\n outline_style = 'fill'\n\n gutter_mark_enabled = True if view.settings().get('sublimelinter_gutter_marks', False) else False\n\n gutter_mark_theme = view.settings().get('sublimelinter_gutter_marks_theme', 'simple')\n\n outlines = {'warning': [], 'violation': [], 'illegal': []}\n\n for line in ERRORS[vid]:\n outlines['illegal'].append(view.full_line(view.text_point(line, 0)))\n\n for line in WARNINGS[vid]:\n outlines['warning'].append(view.full_line(view.text_point(line, 0)))\n\n for line in VIOLATIONS[vid]:\n outlines['violation'].append(view.full_line(view.text_point(line, 0)))\n\n for lint_type in outlines:\n if outlines[lint_type]:\n args = [\n 'lint-outlines-{0}'.format(lint_type),\n outlines[lint_type],\n 'sublimelinter.outline.{0}'.format(lint_type)\n ]\n\n gutter_mark_image = ''\n\n if gutter_mark_enabled:\n if gutter_mark_theme == 'original':\n gutter_mark_image = ORIGINAL_MARK_THEME[lint_type]\n elif gutter_mark_theme in MARK_THEMES:\n gutter_mark_image = os.path.join(MARK_THEMES_PATH, gutter_mark_theme + '-' + lint_type)\n else:\n gutter_mark_image = gutter_mark_theme + '-' + lint_type\n\n args.append(gutter_mark_image)\n\n if outline_style == 'none':\n args.append(sublime.HIDDEN)\n elif outline_style == 'fill':\n pass # outlines are filled by default\n else:\n args.append(sublime.DRAW_OUTLINED)\n view.add_regions(*args)\n\n\ndef erase_lint_marks(view):\n '''erase all \"lint\" error marks from view'''\n view.erase_regions('lint-underline-illegal')\n view.erase_regions('lint-underline-violation')\n view.erase_regions('lint-underline-warning')\n view.erase_regions('lint-outlines-illegal')\n view.erase_regions('lint-outlines-violation')\n view.erase_regions('lint-outlines-warning')\n view.erase_regions('lint-annotations')\n\n\ndef get_lint_regions(view, reverse=False, coalesce=False):\n vid = view.id()\n underlines = UNDERLINES.get(vid, [])[:]\n\n if (coalesce):\n # Each of these regions is one character, so transform it into the character points\n points = sorted([region.begin() for region in underlines])\n\n # Now coalesce adjacent characters into a single region\n underlines = []\n last_point = -999\n\n for point in points:\n if point != last_point + 1:\n underlines.append(sublime.Region(point, point))\n else:\n region = underlines[-1]\n underlines[-1] = sublime.Region(region.begin(), point)\n\n last_point = point\n\n # Now get all outlines, which includes the entire line where underlines are\n outlines = view.get_regions('lint-outlines-illegal')\n outlines.extend(view.get_regions('lint-outlines-violation'))\n outlines.extend(view.get_regions('lint-outlines-warning'))\n outlines.extend(view.get_regions('lint-annotations'))\n\n # If an outline region contains an underline region, use only the underline\n regions = underlines\n\n for outline in outlines:\n contains_underlines = False\n\n for underline in underlines:\n if outline.contains(underline):\n contains_underlines = True\n break\n\n if not contains_underlines:\n regions.append(outline)\n\n return sorted(regions, key=lambda x: x.begin(), reverse=reverse)\n\n\ndef select_lint_region(view, region):\n selected = view.sel()\n selected.clear()\n\n # Find the first underline region within the region to select.\n # If there are none, put the cursor at the beginning of the line.\n underlineRegion = find_underline_within(view, region)\n\n if underlineRegion is None:\n underlineRegion = sublime.Region(region.begin(), region.begin())\n\n selected.add(underlineRegion)\n view.show(underlineRegion, True)\n\n\ndef find_underline_within(view, region):\n underlines = view.get_regions('lint-underline-illegal')\n underlines.extend(view.get_regions('lint-underline-violation'))\n underlines.extend(view.get_regions('lint-underline-warning'))\n underlines.sort(key=lambda x: x.begin())\n\n for underline in underlines:\n if region.contains(underline):\n return underline\n\n return None\n\n\ndef syntax_name(view):\n syntax = os.path.basename(view.settings().get('syntax'))\n syntax = os.path.splitext(syntax)[0]\n return syntax\n\n\ndef select_linter(view, ignore_disabled=False):\n '''selects the appropriate linter to use based on language in current view'''\n syntax = syntax_name(view)\n lc_syntax = syntax.lower()\n language = None\n linter = None\n syntaxMap = view.settings().get('sublimelinter_syntax_map', {})\n\n if syntax in syntaxMap:\n language = syntaxMap.get(syntax, '').lower()\n elif lc_syntax in syntaxMap:\n language = syntaxMap.get(lc_syntax, '').lower()\n elif lc_syntax in LINTERS:\n language = lc_syntax\n\n if language:\n if ignore_disabled:\n disabled = []\n else:\n disabled = view.settings().get('sublimelinter_disable', [])\n\n if language not in disabled:\n linter = LINTERS.get(language)\n\n # If the enabled state is False, it must be checked.\n # Enabled checking has to be deferred to first view use because\n # user settings cannot be loaded during plugin startup.\n if linter is not None and not linter.enabled:\n enabled, message = linter.check_enabled(view)\n print 'SublimeLinter: {0} {1} ({2})'.format(language, 'enabled' if enabled else 'disabled', message)\n\n if not enabled:\n del LINTERS['' + language]\n linter = None\n\n return linter\n\n\ndef highlight_notes(view):\n '''highlight user-specified annotations in a file'''\n view.erase_regions('lint-annotations')\n text = view.substr(sublime.Region(0, view.size()))\n regions = LINTERS['annotations'].built_in_check(view, text, '')\n\n if regions:\n view.add_regions('lint-annotations', regions, 'sublimelinter.annotations', sublime.DRAW_EMPTY_AS_OVERWRITE)\n\n\ndef _update_view(view, filename, **kwargs):\n # It is possible that by the time the queue is run,\n # the original file is no longer being displayed in the view,\n # or the view may be gone. This happens especially when\n # viewing files temporarily by single-clicking on a filename\n # in the sidebar or when selecting a file through the choose file palette.\n valid_view = False\n view_id = view.id()\n\n for window in sublime.windows():\n for v in window.views():\n if v.id() == view_id:\n valid_view = True\n break\n\n if not valid_view or view.is_loading() or (view.file_name() or '').encode('utf-8') != filename:\n return\n\n try:\n run_once(select_linter(view), view, **kwargs)\n except RuntimeError, ex:\n print ex\n\n\ndef queue_linter(linter, view, timeout=-1, preemptive=False, event=None):\n '''Put the current view in a queue to be examined by a linter'''\n if linter is None:\n erase_lint_marks(view) # may have changed file type and left marks behind\n\n # No point in queuing anything if no linters will run\n if not view.settings().get('sublimelinter_notes'):\n return\n\n if preemptive:\n timeout = busy_timeout = 0\n elif timeout == -1:\n timeout, busy_timeout = get_delay(TIMES.get(view.id(), 100), view)\n else:\n busy_timeout = timeout\n\n kwargs = {'timeout': timeout, 'busy_timeout': busy_timeout, 'preemptive': preemptive, 'event': event}\n queue(view, partial(_update_view, view, (view.file_name() or '').encode('utf-8'), **kwargs), kwargs)\n\n\ndef _callback(view, filename, kwargs):\n kwargs['callback'](view, filename, **kwargs)\n\n\ndef background_linter():\n __lock_.acquire()\n\n try:\n callbacks = QUEUE.values()\n QUEUE.clear()\n finally:\n __lock_.release()\n\n for callback in callbacks:\n sublime.set_timeout(callback, 0)\n\n################################################################################\n# Queue dispatcher system:\n\nqueue_dispatcher = background_linter\nqueue_thread_name = 'background linter'\nMAX_DELAY = 10\n\n\ndef queue_loop():\n '''An infinite loop running the linter in a background thread meant to\n update the view after user modifies it and then does no further\n modifications for some time as to not slow down the UI with linting.'''\n global __signaled_, __signaled_first_\n\n while __loop_:\n #print 'acquire...'\n __semaphore_.acquire()\n __signaled_first_ = 0\n __signaled_ = 0\n #print 'DISPATCHING!', len(QUEUE)\n queue_dispatcher()\n\n\ndef queue(view, callback, kwargs):\n global __signaled_, __signaled_first_\n now = time.time()\n __lock_.acquire()\n\n try:\n QUEUE[view.id()] = callback\n timeout = kwargs['timeout']\n busy_timeout = kwargs['busy_timeout']\n\n if now < __signaled_ + timeout * 4:\n timeout = busy_timeout or timeout\n\n __signaled_ = now\n _delay_queue(timeout, kwargs['preemptive'])\n\n if not __signaled_first_:\n __signaled_first_ = __signaled_\n #print 'first',\n #print 'queued in', (__signaled_ - now)\n finally:\n __lock_.release()\n\n\ndef _delay_queue(timeout, preemptive):\n global __signaled_, __queued_\n now = time.time()\n\n if not preemptive and now <= __queued_ + 0.01:\n return # never delay queues too fast (except preemptively)\n\n __queued_ = now\n _timeout = float(timeout) / 1000\n\n if __signaled_first_:\n if MAX_DELAY > 0 and now - __signaled_first_ + _timeout > MAX_DELAY:\n _timeout -= now - __signaled_first_\n if _timeout < 0:\n _timeout = 0\n timeout = int(round(_timeout * 1000, 0))\n\n new__signaled_ = now + _timeout - 0.01\n\n if __signaled_ >= now - 0.01 and (preemptive or new__signaled_ >= __signaled_ - 0.01):\n __signaled_ = new__signaled_\n #print 'delayed to', (preemptive, __signaled_ - now)\n\n def _signal():\n if time.time() < __signaled_:\n return\n __semaphore_.release()\n\n sublime.set_timeout(_signal, timeout)\n\n\ndef delay_queue(timeout):\n __lock_.acquire()\n try:\n _delay_queue(timeout, False)\n finally:\n __lock_.release()\n\n\n# only start the thread once - otherwise the plugin will get laggy\n# when saving it often.\n__semaphore_ = threading.Semaphore(0)\n__lock_ = threading.Lock()\n__queued_ = 0\n__signaled_ = 0\n__signaled_first_ = 0\n\n# First finalize old standing threads:\n__loop_ = False\n__pre_initialized_ = False\n\n\ndef queue_finalize(timeout=None):\n global __pre_initialized_\n\n for thread in threading.enumerate():\n if thread.isAlive() and thread.name == queue_thread_name:\n __pre_initialized_ = True\n thread.__semaphore_.release()\n thread.join(timeout)\nqueue_finalize()\n\n# Initialize background thread:\n__loop_ = True\n__active_linter_thread = threading.Thread(target=queue_loop, name=queue_thread_name)\n__active_linter_thread.__semaphore_ = __semaphore_\n__active_linter_thread.start()\n\n################################################################################\n\nUNRECOGNIZED = '''\n* Unrecognized option * : %s\n==============================================\n\n'''\n\n\ndef view_in_tab(view, title, text, file_type):\n '''Helper function to display information in a tab.\n '''\n tab = view.window().new_file()\n tab.set_name(title)\n _id = tab.buffer_id()\n tab.set_scratch(_id)\n tab.settings().set('gutter', True)\n tab.settings().set('line_numbers', False)\n tab.set_syntax_file(file_type)\n ed = tab.begin_edit()\n tab.insert(ed, 0, text)\n tab.end_edit(ed)\n return tab, _id\n\n\ndef lint_views(linter):\n if not linter:\n return\n\n viewsToLint = []\n\n for window in sublime.windows():\n for view in window.views():\n viewLinter = select_linter(view)\n\n if viewLinter == linter:\n viewsToLint.append(view)\n\n for view in viewsToLint:\n queue_linter(linter, view, preemptive=True)\n\n\ndef reload_view_module(view):\n for name, linter in LINTERS.items():\n module = sys.modules[linter.__module__]\n\n if module.__file__.encode('utf-8') == (view.file_name() or '').encode('utf-8'):\n print 'SublimeLinter: reloading language:', linter.language\n MOD_LOAD.reload_module(module)\n lint_views(linter)\n break\n\n\ndef settings_changed():\n for window in sublime.windows():\n for view in window.views():\n linter = select_linter(view)\n\n if (linter):\n reload_settings(view)\n\n\ndef reload_settings(view):\n '''Restores user settings.'''\n settings = sublime.load_settings(__name__ + '.sublime-settings')\n settings.clear_on_change(__name__)\n settings.add_on_change(__name__, settings_changed)\n\n for setting in ALL_SETTINGS:\n if settings.get(setting) != None:\n view.settings().set(setting, settings.get(setting))\n\n if view.settings().get('sublimelinter') == None:\n view.settings().set('sublimelinter', True)\n\n\nclass LintCommand(sublime_plugin.TextCommand):\n '''command to interact with linters'''\n\n def __init__(self, view):\n self.view = view\n self.help_called = False\n\n def run_(self, action):\n '''method called by default via view.run_command;\n used to dispatch to appropriate method'''\n if not action:\n return\n\n try:\n lc_action = action.lower()\n except AttributeError:\n return\n\n if lc_action == 'reset':\n self.reset()\n elif lc_action == 'on':\n self.on()\n elif lc_action == 'load-save':\n self.enable_load_save()\n elif lc_action == 'save-only':\n self.enable_save_only()\n elif lc_action == 'off':\n self.off()\n elif action.lower() in LINTERS:\n self._run(lc_action)\n\n def reset(self):\n '''Removes existing lint marks and restores user settings.'''\n erase_lint_marks(self.view)\n reload_settings(self.view)\n\n def on(self):\n '''Turns background linting on.'''\n self.view.settings().set('sublimelinter', True)\n queue_linter(select_linter(self.view), self.view, preemptive=True)\n\n def enable_load_save(self):\n '''Turns load-save linting on.'''\n self.view.settings().set('sublimelinter', 'load-save')\n erase_lint_marks(self.view)\n\n def enable_save_only(self):\n '''Turns save-only linting on.'''\n self.view.settings().set('sublimelinter', 'save-only')\n erase_lint_marks(self.view)\n\n def off(self):\n '''Turns background linting off.'''\n self.view.settings().set('sublimelinter', False)\n erase_lint_marks(self.view)\n\n def _run(self, name):\n '''runs an existing linter'''\n run_once(LINTERS[name.lower()], self.view)\n\n\nclass BackgroundLinter(sublime_plugin.EventListener):\n '''This plugin controls a linter meant to work in the background\n to provide interactive feedback as a file is edited. It can be\n turned off via a setting.\n '''\n\n def __init__(self):\n super(BackgroundLinter, self).__init__()\n self.lastSelectedLineNo = -1\n\n def on_modified(self, view):\n if view.is_scratch():\n return\n\n if view.settings().get('sublimelinter') != True:\n erase_lint_marks(view)\n return\n\n linter = select_linter(view)\n\n # File-based linters are not invoked during a modify\n if linter and linter.input_method == INPUT_METHOD_FILE:\n erase_lint_marks(view)\n return\n\n # Reset the last selected line number so that the current line will show error messages\n # when update_statusbar is called.\n self.lastSelectedLineNo = -1\n queue_linter(linter, view)\n\n def on_load(self, view):\n reload_settings(view)\n\n sublimelinter_setting = view.settings().get('sublimelinter')\n\n if view.is_scratch() or sublimelinter_setting == False or sublimelinter_setting == 'save-only':\n return\n\n queue_linter(select_linter(view), view, event='on_load')\n\n def on_post_save(self, view):\n sublimelinter_setting = view.settings().get('sublimelinter')\n\n if sublimelinter_setting == None:\n reload_settings(view)\n\n if view.is_scratch() or sublimelinter_setting == False:\n return\n\n reload_view_module(view)\n queue_linter(select_linter(view), view, preemptive=True, event='on_post_save')\n\n def on_selection_modified(self, view):\n if view.is_scratch():\n return\n delay_queue(1000) # on movement, delay queue (to make movement responsive)\n\n # We only display errors in the status bar for the last line in the current selection.\n # If that line number has not changed, there is no point in updating the status bar.\n lastSelectedLineNo = last_selected_lineno(view)\n\n if lastSelectedLineNo != self.lastSelectedLineNo:\n self.lastSelectedLineNo = lastSelectedLineNo\n update_statusbar(view)\n\n\nclass FindLintErrorCommand(sublime_plugin.TextCommand):\n '''This command is just a superclass for other commands, it is never enabled.'''\n def is_enabled(self):\n return select_linter(self.view) is not None\n\n def find_lint_error(self, forward):\n linter = select_linter(self.view, ignore_disabled=True)\n\n if not linter:\n return\n\n self.view.run_command('lint', linter.language)\n regions = get_lint_regions(self.view, reverse=not forward, coalesce=True)\n\n if len(regions) == 0:\n sublime.error_message('No lint errors.')\n return\n\n selected = self.view.sel()\n point = selected[0].begin() if forward else selected[-1].end()\n regionToSelect = None\n\n # If going forward, find the first region beginning after the point.\n # If going backward, find the first region ending before the point.\n # If nothing is found in the given direction, wrap to the first/last region.\n if forward:\n for index, region in enumerate(regions):\n if point < region.begin():\n regionToSelect = region\n break\n else:\n for index, region in enumerate(regions):\n if point > region.end():\n regionToSelect = region\n break\n\n # If there is only one error line and the cursor is in that line, we cannot move.\n # Otherwise wrap to the first/last error line unless settings disallow that.\n if regionToSelect is None and (len(regions) > 1 or not regions[0].contains(point)):\n if self.view.settings().get('sublimelinter_wrap_find', True):\n regionToSelect = regions[0]\n\n if regionToSelect is not None:\n select_lint_region(self.view, regionToSelect)\n else:\n sublime.error_message('No {0} lint errors.'.format('next' if forward else 'previous'))\n\n return regionToSelect\n\n\nclass FindNextLintErrorCommand(FindLintErrorCommand):\n def run(self, edit):\n '''\n Move the cursor to the next lint error in the current view.\n The search will wrap to the top unless the sublimelinter_wrap_find\n setting is set to false.\n '''\n self.find_lint_error(forward=True)\n\n\nclass FindPreviousLintErrorCommand(FindLintErrorCommand):\n def run(self, edit):\n '''\n Move the cursor to the previous lint error in the current view.\n The search will wrap to the bottom unless the sublimelinter_wrap_find\n setting is set to false.\n '''\n self.find_lint_error(forward=False)\n\n\nclass SublimelinterWindowCommand(sublime_plugin.WindowCommand):\n def is_enabled(self):\n view = self.window.active_view()\n\n if view:\n if view.is_scratch():\n return False\n else:\n return True\n else:\n return False\n\n def run_(self, args):\n pass\n\n\nclass SublimelinterAnnotationsCommand(SublimelinterWindowCommand):\n '''Commands to extract annotations and display them in\n a file\n '''\n def run_(self, args):\n linter = LINTERS.get('annotations', None)\n\n if linter is None:\n return\n\n view = self.window.active_view()\n\n if not view:\n return\n\n text = view.substr(sublime.Region(0, view.size())).encode('utf-8')\n filename = (view.file_name() or '').encode('utf-8')\n notes = linter.extract_annotations(text, view, filename)\n _, filename = os.path.split(filename)\n annotations_view, _id = view_in_tab(view, 'Annotations from {0}'.format(filename), notes, '')\n\n\nclass SublimelinterCommand(SublimelinterWindowCommand):\n def is_enabled(self):\n enabled = super(SublimelinterCommand, self).is_enabled()\n\n if not enabled:\n return False\n\n linter = select_linter(self.window.active_view(), ignore_disabled=True)\n return linter is not None\n\n def run_(self, args={}):\n view = self.window.active_view()\n action = args.get('action', '')\n\n if view and action:\n if action == 'lint':\n self.lint_view(view, show_popup_list=args.get('show_popup', False))\n else:\n view.run_command('lint', action)\n\n def lint_view(self, view, show_popup_list):\n linter = select_linter(view, ignore_disabled=True)\n\n if linter:\n view.run_command('lint', linter.language)\n regions = get_lint_regions(view, coalesce=True)\n\n if regions:\n if show_popup_list:\n popup_error_list(view)\n else:\n sublime.error_message('{0} lint error{1}.'.format(len(regions), 's' if len(regions) != 1 else ''))\n else:\n sublime.error_message('No lint errors.')\n else:\n syntax = syntax_name(view)\n sublime.error_message('No linter for the syntax \"{0}\"'.format(syntax))\n\n\nclass SublimelinterLintCommand(SublimelinterCommand):\n def is_enabled(self):\n enabled = super(SublimelinterLintCommand, self).is_enabled()\n\n if enabled:\n view = self.window.active_view()\n\n if view and view.settings().get('sublimelinter') == True:\n return False\n\n return enabled\n\n\nclass SublimelinterShowErrorsCommand(SublimelinterCommand):\n def is_enabled(self):\n return super(SublimelinterShowErrorsCommand, self).is_enabled()\n\n\nclass SublimelinterEnableLoadSaveCommand(SublimelinterCommand):\n def is_enabled(self):\n enabled = super(SublimelinterEnableLoadSaveCommand, self).is_enabled()\n\n if enabled:\n view = self.window.active_view()\n\n if view and view.settings().get('sublimelinter') == 'load-save':\n return False\n\n return enabled\n\n\nclass SublimelinterEnableSaveOnlyCommand(SublimelinterCommand):\n def is_enabled(self):\n enabled = super(SublimelinterEnableSaveOnlyCommand, self).is_enabled()\n\n if enabled:\n view = self.window.active_view()\n\n if view and view.settings().get('sublimelinter') == 'save-only':\n return False\n\n return enabled\n\n\nclass SublimelinterDisableCommand(SublimelinterCommand):\n def is_enabled(self):\n enabled = super(SublimelinterDisableCommand, self).is_enabled()\n\n if enabled:\n view = self.window.active_view()\n\n if view and view.settings().get('sublimelinter') == False:\n return False\n\n return enabled\n" }, { "path": "SublimeLinter.sublime-settings", "content": "/*\n SublimeLinter default settings\n*/\n{\n /*\n Sets the mode in which SublimeLinter runs:\n\n true - Linting occurs in the background as you type.\n false - Linting only occurs when you initiate it.\n \"load-save\" - Linting occurs only when a file is loaded and saved (the default).\n \"save-only\" - Linting occurs only when a file is saved.\n */\n \"sublimelinter\": \"load-save\",\n\n /*\n Maps language names **as listed at the beginning of the README** (but all lowercase)\n to executables for non-built in linters. If the executable is not in the default system path,\n or on posix systems is not in /usr/local/bin or ~/bin, then you must specify\n the full path to the executable. Note that paths in Windows must use double\n backslashes, for example \"C:\\\\Program Files (x86)\\\\nodejs\\\\node.exe\".\n\n Please note that the map _keys_ do not always match the name of the\n executable, but rather the language syntax for the executable to lint.\n\n This is the effective default map; your mappings may override these.\n\n \"sublimelinter_executable_map\":\n {\n \"perl\": \"perl\",\n \"php\": \"php\",\n \"ruby\": \"ruby\"\n },\n */\n \"sublimelinter_executable_map\":\n {\n },\n\n /*\n Maps syntax names to linters. This allows variations on a syntax\n (for example \"Python (Django)\") to be linted. The key is\n the name of the syntax **as it appears in the syntax list\n at the bottom right of the window**, and the value\n is the linter name **as listed in the README** (all lowercase)\n that the syntax maps to.\n */\n \"sublimelinter_syntax_map\":\n {\n \"Python Django\": \"python\",\n \"Ruby on Rails\": \"ruby\",\n \"C++\": \"c\"\n },\n\n // An array of linter names to disable. Names should be lowercase.\n \"sublimelinter_disable\":\n [\n ],\n\n /*\n The minimum delay in seconds (fractional seconds are okay) before\n a linter is run when the \"sublimelinter\" setting is true. This allows\n you to have background linting active, but defer the actual linting\n until you are idle. When this value is greater than the built in linting delay,\n errors are erased when the file is modified, since the assumption is\n you don't want to see errors while you type.\n */\n \"sublimelinter_delay\": 2,\n\n /*\n Selects the way the lines with errors or warnings are marked; \"outline\" draws\n outline boxes around the lines, \"fill\" fills the lines with the outline color,\n and \"none\" (default) disables all outline styles.\n */\n \"sublimelinter_mark_style\": \"none\",\n\n /*\n If true, lines with errors or warnings will be filled in with the\n outline color.\n\n This setting is DEPRECATED and will be ignored in future\n versions. Use \"sublimelinter_mark_style\" instead. For backwards\n compatibility reasons, this setting overrides \"sublimelinter_mark_style\"\n if that one is set to \"outline\", but has no effect if it's set to \"none\".\n */\n \"sublimelinter_fill_outlines\": false,\n\n // If true, lines with errors or warnings will have a gutter mark.\n \"sublimelinter_gutter_marks\": true,\n\n /*\n Choose the theme for gutter marks; available built-in options are:\n \"alpha\", \"bright\", \"dark\", \"hard\" and \"simple\"\n\n Anything else will be treated as a path to a set of images.\n For instance, setting the value to \"../User/my-awesome-theme\"\n would cause SublimeLinter to look for the images:\n \"../User/my-awesome-theme-illegal.png\",\n \"../User/my-awesome-theme-violation.png\",\n \"../User/my-awesome-theme-warning.png\"\n These images should all be approximately 32x32px.\n */\n \"sublimelinter_gutter_marks_theme\": \"simple\",\n\n // If true, the find next/previous error commands will wrap.\n \"sublimelinter_wrap_find\": true,\n\n // If true, when the file is saved any errors will appear in a popup list\n \"sublimelinter_popup_errors_on_save\": false,\n\n // JavaScript linter: \"gjslint\" to use the closure javascript linter (if available),\n // or either \"jshint\" or \"jslint\" to use a built in linter.\n \"javascript_linter\": \"jshint\",\n\n // jshint: options for linting JavaScript. See http://www.jshint.com/docs/#options for more info.\n // By deault, eval is allowed.\n \"jshint_options\":\n {\n // To fix column positions for JSHint errors you may want to add `\"indent\": 1` to your\n // **User** \"jshint_options\". This issue affects users with tabs for indentation.\n // This fix was reverted due to a conflict with using the `\"white\": true` option.\n // \"indent\": 1,\n \"evil\": true,\n \"regexdash\": true,\n \"browser\": true,\n \"wsh\": true,\n \"trailing\": true,\n \"sub\": true,\n \"devel\": true\n },\n\n // A list of command line options to send to gjslint. --nobeep is always sent.\n \"gjslint_options\":\n [\n ],\n\n // A list of gjslint error numbers to ignore. The list of error codes is here:\n // http://closure-linter.googlecode.com/svn/trunk/closure_linter/errors.py\n \"gjslint_ignore\":\n [\n 110 // line too long\n ],\n\n // CSSLint options:\n // Each rule can have three values: error|warning|true|false\n // false => rule is disabled.\n // true => alias to 'error'\n // All rules are enabled by default.\n // Currently the only difference between warnings and errors is in the prefix of the message in the Sublime status bar.\n \"csslint_options\":\n {\n \"adjoining-classes\": \"warning\",\n \"box-model\": true,\n \"box-sizing\": \"warning\",\n \"compatible-vendor-prefixes\": \"warning\",\n \"display-property-grouping\": true,\n \"duplicate-background-images\": \"warning\",\n \"duplicate-properties\": true,\n \"empty-rules\": true,\n \"errors\": true,\n \"fallback-colors\": \"warning\",\n \"floats\": \"warning\",\n \"font-faces\": \"warning\",\n \"font-sizes\": \"warning\",\n \"gradients\": \"warning\",\n \"ids\": \"warning\",\n \"import\": \"warning\",\n \"important\": \"warning\",\n \"known-properties\": true,\n \"outline-none\": \"warning\",\n \"overqualified-elements\": \"warning\",\n \"qualified-headings\": \"warning\",\n \"regex-selectors\": \"warning\",\n \"rules-count\": \"warning\",\n \"shorthand\": \"warning\",\n \"star-property-hack\": \"warning\",\n \"text-indent\": \"warning\",\n \"underscore-property-hack\": \"warning\",\n \"unique-headings\": \"warning\",\n \"universal-selector\": \"warning\",\n \"vendor-prefix\": true,\n \"zero-units\": \"warning\"\n },\n\n // Set this to false to turn pep8 checking off completely\n \"pep8\": true,\n\n /*\n A list of pep8 error numbers to ignore. By default \"line too long\" errors are ignored.\n The list of error codes is in this file: https://github.com/jcrocholl/pep8/blob/master/pep8.py.\n Search for \"Ennn:\", where nnn is a 3-digit number.\n */\n \"pep8_ignore\":\n [\n \"E501\"\n ],\n\n /*\n If you use SublimeLinter for pyflakes checks, you can ignore some of the \"undefined name xxx\"\n errors (comes in handy if you work with post-processors, globals/builtins available only at runtime, etc.).\n You can control what names will be ignored with the user setting \"pyflakes_ignore\".\n\n Example:\n\n \"pyflakes_ignore\":\n [\n \"some_custom_builtin_o_mine\",\n \"A_GLOBAL_CONSTANT\"\n ],\n */\n \"pyflakes_ignore\":\n [\n ],\n\n /*\n Ordinarily pyflakes will issue a warning when 'from foo import *' is used,\n but it is ignored since the warning is not that helpful. If you want to see this warning,\n set this option to false.\n */\n \"pyflakes_ignore_import_*\": true,\n\n /*\n Perl linter: \"perl\" to use the Perl language syntax check, or \"perlcritic\" to use Perl::Critic linting.\n Perl is now set to use \"perlcritic\" by default due to a vulnerability with blindly running `perl -c`\n on files with `BEGIN` or `CHECK` blocks.\n */\n \"perl_linter\": \"perlcritic\",\n\n // Objective-J: if true, non-ascii characters are flagged as an error.\n \"sublimelinter_objj_check_ascii\": false,\n\n // Set to true to highlight annotations\n \"sublimelinter_notes\": false,\n\n // The set of annotation phrases to highlight\n \"annotations\": [\"TODO\", \"README\", \"FIXME\"]\n}\n" }, { "path": "changelog.txt", "content": "SublimeLinter 1.5.1 changelog\n=============================\n\nNEW FEATURES\n------------\n- SublimeLinter keeps its settings in its own settings file now:\n SublimeLinter.sublime-settings. You will need to copy your\n user settings to this file. To do so, follow these steps:\n\n 1. Select \"Preferences->Settings - User\" in one tab/window.\n The title of this tab should be \"Preferences.sublime-settings\".\n 2. Open another tab/window and select\n `Preferences->Package Settings->SublimeLinter->Settings - User`.\n The title of this window should be\n `SublimeLinter.sublime-settings`.\n 3. Copy/cut any of the following settings from\n Preferences.sublime-settings to SublimeLinter.sublime-settings:\n\n sublimelinter\n sublimelinter_executable_map\n sublimelinter_syntax_map\n sublimelinter_disable\n sublimelinter_delay\n sublimelinter_fill_outlines\n sublimelinter_gutter_marks\n sublimelinter_wrap_find\n sublimelinter_popup_errors_on_save\n javascript_linter\n jshint_options\n pep8_ignore\n pyflakes_ignore\n pyflakes_ignore_import_*\n sublimelinter_objj_check_ascii\n\n 4. Save SublimeLinter.sublime-settings. The changes may not take\n effect until you restart Sublime Text.\n\n When changes are made to the user SublimeLinter settings, they\n are immediately reloaded into every open view. Note that this will\n override any temporary changes you may have made to the settings in\n a given view.\n- The google closure JavaScript linter (gjslint) is now supported.\n (https://developers.google.com/closure/utilities/docs/linter_howto)\n There is a new setting, `javascript_linter`, which determines which\n linter to use, jshint or gjslinter. You may also customize gjslint\n behavior with the `gjslint_options` and `gjslint_ignore` settings.\n Please select\n `Preferences->Package Settings->SublimeLinter->Settings - Default`\n for more information on these settings.\n- The color theme names have been changed to avoid clashes with\n built in names.\n\n Old New\n --------------------- -----------------------------\n sublimelinter. sublimelinter.outline.\n invalid. sublimelinter.underline.\n\n You will have to update your color themes accordingly. Please\n select `Preferences->Package Settings->SublimeLinter->README` and\n search for \"Customizing colors\" for more information.\n- When selecting an error from the popup error list, the view is\n centered on the error line.\n\nCHANGES/FIXES\n-------------\n- The PHP error regex has been updated to work with PHP 5.3.8 on Mac\n OS X.\n- The popup error list will no longer choke on non-ASCII text.\n- Selecting an error from the popup error list no longer attempts to\n go directly to the point of an error as this could not be done\n reliably. It will jump to the first non-whitespace character of\n the error's line.\n- Go to next/previous error works correctly when an error line has\n no underlines.\n- If an exception is thrown by jshint (e.g. too many errors), the\n errors captured up to that point are displayed.\n- The built in jshint has been updated from the master jshint.\n- Fixed errors that would occur with the popup error list when there\n was more than error on a line.\n\n\nSublimeLinter 1.5.2 changelog\n=============================\n\nCHANGES/FIXES\n-------------\n- Fixed a problem with messages.json that prevented correct\n upgrading.\n\nIMPORTANT\n---------\nPlease check to see if you have multiple listings for `SublimeLinter`\nin `Preferences -> Package Settings`. If you do see 2 listings,\nplease run `Package Control: Upgrade/Overwrite All Packages` from\nthe Command Palette (`Tools -> Command Palette`).\n\n\nSublimeLinter 1.5.3 changelog\n=============================\n\nCHANGES/FIXES\n-------------\n- Annotations have been fixed.\n- Entries in \"sublimelinter_syntax_map\" take precedence over built\n in mappings.\n- Lint errors in PHP files will hopefully not be logged to the PHP\n log file.\n\n\nSublimeLinter 1.5.4 changelog\n=============================\n\nCHANGES/FIXES\n-------------\n- jshint.js has been updated to the latest master version.\n- [issue #128] An \"unsafe\" option has been added to jshint. If set\n true, any UTF-8 characters are allowed in the source.\n\n\nSublimeLinter 1.5.5 changelog\n=============================\n\nCHANGES/FIXES\n-------------\n- This change log is available from the SublimeLinter preferences\n menu.\n\n\nSublimeLinter 1.5.6 changelog\n=============================\n\nCHANGES/FIXES\n-------------\n- Fixed a problem with messages.json that prevented correct\n upgrading.\n\nIMPORTANT\n---------\nPlease check to see if you have multiple listings for `SublimeLinter`\nin `Preferences -> Package Settings`. If you do see 2 listings,\nplease run `Package Control: Upgrade/Overwrite All Packages` from\nthe Command Palette (`Tools -> Command Palette`).\n\n\nSublimeLinter 1.5.7 changelog\n=============================\n\nCHANGES/FIXES\n-------------\n- node.js is the preferred JavaScript engine on Mac OS X and will be\n used if it is installed. JavaScriptCore does not handle non-ASCII\n text correctly and you should install node.js if possible.\n- If you imported `BaseLinter.JSC_PATH`, please change your linter to\n use the `self.jsc_path()` method instead. JSC_PATH should no\n longer be considered public.\n\n\nSublimeLinter 1.6.0 changelog\n=============================\n\nNEW FEATURES\n------------\n- Simpler abstraction of JavaScript engines for JS powered linters.\n\n To leverage a JS linter, include a \"linter.js\" file; this file\n should `require` the actual linter library file and export a `lint`\n function. The `lint` function should return a list of errors back\n to the python language handler file (via the `errors` parameter to\n the `parse_errors` method).\n\n Although \"linter.js\" should follow the Node.js api, the linter may\n also be run via JavaScriptCore on OS X if Node.js is not installed.\n In the case where JavaScriptCore is used, require + export are\n shimmed to keep things consistent. However, it is important not to\n assume that a full Node.js api is available. If you must know what\n JS engine you are using, you may check for `USING_JSC` to be set\n as `true` when JavaScriptCore is used.\n\n For examples of using the JS engines, see \"csslint\", \"jslint\", and\n \"jshint\" in \"SublimeLinter/sublimelinter/modules/libs\" and the\n respective python code of \"css.py\" and \"javascript.py\" in\n \"SublimeLinter/sublimelinter/modules\".\n- Douglas Crockford's [JSLint](http://jslint.com) JavaScript linter\n is now supported. To use JSLint set the \"javascript_linter\" setting\n to \"jslint\". You may also customize jslint behavior with the\n \"jslint_options\" setting. For more information about options\n available to JSLint, see http://jslint.com/lint.html.\n- The [CSSLint](http://csslint.net) CSS linter is now supported.\n By default all CSSLint settings are turned on. You may customize\n csslint behavior with the \"csslint_options\" setting. Please select\n \"Preferences->Package Settings->SublimeLinter->Settings - Default\"\n for more information on turning off or adjusting severity of tests.\n For more information about options available to CSSLint, see\n https://github.com/stubbornella/csslint/wiki/Rules.\n\n\nSublimeLinter 1.6.1 changelog\n=============================\n\nCHANGES/FIXES\n-------------\n- Fixed an issue (#141) with JSLint running in Node.js\n- Updated CSSLint, JSLint, JSHint to latest stable releases.\n- Added additional debugging output (in Sublime console) when\n errors occur running linters written in JavaScript.\n\n\nSublimeLinter 1.6.2 changelog\n=============================\n\nCHANGES/FIXES\n-------------\n- Replaced the default perl linter with Perl::Critic. The standard\n Perl syntax checker can still be invoked by switching the\n \"perl_linter\" setting to \"perl\".\n- Added a LICENSE file to define appropriate usage of SublimeLinter\n and its source.\n- Converted README back to markdown.\n\nIMPORTANT\n---------\nDue to a vulnerability (issue #77) with the Perl linter, Perl syntax\nchecking is no longer enabled by default. The default linter for\nPerl has been replaced by Perl::Critic.\n\n\nSublimeLinter 1.6.3 changelog\n=============================\n\nNEW FEATURES\n------------\n- Support for `.jshintrc` files. If using JSHint, SublimeLinter\n will recursively search the directory tree (from the file location\n to the file-system root directory). This functionality is\n specified in the JSHint README.\n https://github.com/jshint/node-jshint/#within-your-projects-directory-tree\n\nCHANGES/FIXES\n-------------\n- Fixed README reference in the menu.\n- Updated CoffeeScript module to be compatible with the updated\n coffee command in version 1.3.\n\nIMPORTANT\n---------\nIf you are using the CoffeeScript linting, please upgrade\nthe installed coffee-script NPM module to 1.3 or greater.\n\n npm update -g coffee-script\n\n\nSublimeLinter 1.6.4 changelog\n=============================\n\nIMPORTANT!!\n-----------\nPlease note that the SublimeLinter repository has moved to:\n\n https://github.com/SublimeLinter/SublimeLinter\n\nIssues and pull requests should be made there.\n\nNEW FEATURES\n------------\n- The Objective-J linter now catches spaces inside parentheses\n and dependent clauses on the same line as a control structure.\n\nCHANGES/FIXES\n-------------\n- The README has been reorganized to hopefully be clearer.\n- More explicit Node.js installation instructions have been provided.\n- The \"pep8\" setting is now recognized in SublimeLinter's settings.\n- When a minimum delay is specified with the \"sublimelinter_delay\"\n setting, SublimeLinter will only lint the currently displayed file\n when the queued linters run. This allows you to avoid linting of\n files as they are selected in the choose file palette.\n\n\nSublimeLinter 1.6.5 changelog\n=============================\n\nNEW FEATURES\n------------\n- Added a (Ruby) Haml linter based on `haml -c`. For more\n information about Haml, please see http://haml.info.\n- Added a simple Git commit message linter. This linter follows the\n rules as defined by\n http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html\n\nCHANGES/FIXES\n-------------\n- Updated several links to point to the SublimeLinter's new Github\n location.\n- \"Ruby on Rails\" syntax maps to \"ruby\" as part of the default\n settings.\n- Linter arguments are now consistently defined as arrays (instead\n of tuples).\n- Syntax map settings are no longer (sometimes) case-sensitive.\n\n\nSublimeLinter 1.6.6 changelog\n=============================\n\nCHANGES/FIXES\n-------------\n- JSHint now shows underlines at the appropriate character positions\n when using tabs for indentation.\n- Upgrading CSSLint to the latest version (v0.9.8). This adds\n support for the latest \"Compatibility\" options: \"Disallow star\n hack\" and \"Disallow underscore hack\".\n- Annotation highlighting is working again.\n- Git Commit Message linting now ignores `git --diff` output in\n messages. These lines are automatically generated and inserted\n when running `git commit -v`.\n\n\nSublimeLinter 1.6.7 changelog\n=============================\n\nNEW FEATURES\n------------\n- Puppet linting is now supported via `puppet parser validate`.\n- Added an option for more granular control of outline decorations.\n Set the value of \"sublimelinter_mark_style\" to \"outline\", \"fill\",\n or \"none\" in the user settings.\n\nCHANGES/FIXES\n-------------\n- Repaired the built-in CSS linter (CSSLint). This was broken with\n with the last update.\n- Added missing documentation for \"save-only\" linting in the\n settings file.\n- Adjusted ambiguous/misleading documentation for the\n \"sublimelinter_executable_map\" setting.\n\n\nSublimeLinter 1.6.8 changelog\n=============================\n\nNEW FEATURES\n------------\n- HTML5 linting support via `tidy`. This linter will not run unless\n you have a version of tidy with HTML5 support. To use this linter,\n please see: https://github.com/w3c/tidy-html5\n- XML linting via `xmllint`.\n\nCHANGES/FIXES\n-------------\n- Made significant progress on issue (#181). However, SublimeLinter\n still throws with some linter types on Windows 7 when a user has\n non-ascii characters in the path (to the SL plugin).\n- Updated PEP8 to v1.1\n- Updated Pyflakes to v0.5.0\n- Updated JSHint to latest stable (r11).\n- Reverted a fix for accurate (JSHint) error column positions (when\n using tab indentation) due to a regression with the `\"white\": true`\n option. You may still manually fix error positions by setting\n `\"indent\": 1`.\n- Changed (the default) background linting delay to a more sane 2\n seconds. This reduces memory usage, cpu processing, and visual\n noise while you are actively writing code.\n\n\nSublimeLinter 1.6.9 changelog\n=============================\n\nNEW FEATURES\n------------\n- C/C++ lint via `cppcheck`. Also added alternative (hidden) support\n for `cpplint.py`. Please see README for more info.\n- Lua syntax check via `luac`.\n\nCHANGES/FIXES\n-------------\n- Adding a 'beta' channel for SublimeLinter into Package Control.\n This branch will act as a more formal method for testing new\n features and fixes before a release.\n\n\nSublimeLinter 1.6.10 changelog\n==============================\n\nCHANGES/FIXES\n-------------\n- Puppet validation supports error output for Puppet v3.0+.\n- JSHint options now support the (proper) \"globals\" definition.\n- Lua syntax check no longer creates luac.out file clutter.\n- Clarified documentation for styling sublimelinter.annotations.\n\n\nSublimeLinter 1.6.11 changelog\n==============================\n\nCHANGES/FIXES\n-------------\n- Github (nodeload) zip url scheme changed.\n\n\nSublimeLinter 1.6.12 changelog\n==============================\n\nCHANGES/FIXES\n-------------\n- Cpplint no longer uses a temporary file - it leverages stdin\n instead.\n- Fixed issue #298: C linter throws \"KeyError\"\n\n\nSublimeLinter 1.6.13 changelog\n==============================\n\nCHANGES/FIXES\n-------------\n- Updated PEP8 to version v1.4\n- Updated PyFlakes to v0.6.1\n- Updated CSSLint to v0.9.10\n- Update JSHint to v1.0.0\n- Update JSLint to latest\n- Fixed issues with attempting to encode file name when using\n scratch space.\n\n\nSublimeLinter 1.7.0 changelog\n=============================\n\nNEW FEATURES\n------------\n- Add \"Quick Start\" section to the README\n- New commands for the (Sublime Text) command palette to open the\n SublimeLinter preferences files (Default & User)\n- Ruby linting support via [ruby-lint](https://github.com/YorickPeterse/ruby-lint)\n- Haskell linting support via [hlint](http://community.haskell.org/~ndm/hlint/)\n- Add gutter mark themes. Add 5 new built-in themes:\n \"alpha\", \"bright\", \"dark\", \"hard\", and \"simple\".\n Custom themes can also be used.\n\nCHANGES/FIXES\n-------------\n- Update JSHint to v1.1.0\n- Update CoffeeScript linter to support latest error message format\n- Settings are refreshed when a new file is saved; this should fix\n several bugs: #233, #359, #149, #367\n- The `lint_args` setting now matches the documentation; it will\n override the default arguments rather than extend them. This will\n give users full control over linter/checker arguments.\n- Clean up markdown formatting in changelog\n\nIMPORTANT\n---------\nDue to the fix for `lint_args`, if you are currently customizing this\nsetting, you **must** adjust your settings.\n\n\nSublimeLinter 1.7.1 changelog\n=============================\n\nCHANGES/FIXES\n-------------\n- Update JSLint to latest\n- Update JSHint to v2.1.5\n- Updated link to JSHint documentation\n- Updated PEP8 to v1.4.6\n- Updated Pyflakes to v0.7.3\n- Gutter mark icons are now retina quality\n- Included Gutter mark icon PSD (for tinkering :)\n\n\nSublimeLinter 1.7.2 changelog\n=============================\n\nCHANGES/FIXES\n-------------\n- Update JSHint to v2.1.8\n- Fixing compatibility regression with latest JSHint\n- Fixing compatibility regression with latest Pyflakes\n- Apologizing for hasty v1.7.1 release ;)\n" }, { "path": "messages/1.5.1.txt", "content": "SublimeLinter 1.5.1 changelog\n=============================\n\nNEW FEATURES\n------------\n- SublimeLinter keeps its settings in its own settings file now:\n SublimeLinter.sublime-settings. You will need to copy your\n user settings to this file. To do so, follow these steps:\n \n 1. Select \"Preferences->Settings - User\" in one tab/window.\n The title of this tab should be \"Preferences.sublime-settings\".\n 2. Open another tab/window and select\n `Preferences->Package Settings->SublimeLinter->Settings - User`.\n The title of this window should be\n `SublimeLinter.sublime-settings`.\n 3. Copy/cut any of the following settings from\n Preferences.sublime-settings to SublimeLinter.sublime-settings:\n\n sublimelinter\n sublimelinter_executable_map\n sublimelinter_syntax_map\n sublimelinter_disable\n sublimelinter_delay\n sublimelinter_fill_outlines\n sublimelinter_gutter_marks\n sublimelinter_wrap_find\n sublimelinter_popup_errors_on_save\n javascript_linter\n jshint_options\n pep8_ignore\n pyflakes_ignore\n pyflakes_ignore_import_*\n sublimelinter_objj_check_ascii\n\n 4. Save SublimeLinter.sublime-settings. The changes may not take\n effect until you restart Sublime Text.\n\n When changes are made to the user SublimeLinter settings, they\n are immediately reloaded into every open view. Note that this will\n override any temporary changes you may have made to the settings in\n a given view.\n- The google closure JavaScript linter (gjslint) is now supported.\n (https://developers.google.com/closure/utilities/docs/linter_howto)\n There is a new setting, `javascript_linter`, which determines which\n linter to use, jshint or gjslinter. You may also customize gjslint\n behavior with the `gjslint_options` and `gjslint_ignore` settings.\n Please select\n `Preferences->Package Settings->SublimeLinter->Settings - Default`\n for more information on these settings.\n- The color theme names have been changed to avoid clashes with\n built in names.\n\n Old New\n --------------------- -----------------------------\n sublimelinter. sublimelinter.outline.\n invalid. sublimelinter.underline.\n\n You will have to update your color themes accordingly. Please \n select `Preferences->Package Settings->SublimeLinter->README` and \n search for \"Customizing colors\" for more information.\n- When selecting an error from the popup error list, the view is \n centered on the error line.\n\nCHANGES/FIXES\n-------------\n- The PHP error regex has been updated to work with PHP 5.3.8 on Mac\n OS X.\n- The popup error list will no longer choke on non-ASCII text.\n- Selecting an error from the popup error list no longer attempts to\n go directly to the point of an error as this could not be done \n reliably. It will jump to the first non-whitespace character of \n the error's line.\n- Go to next/previous error works correctly when an error line has\n no underlines.\n- If an exception is thrown by jshint (e.g. too many errors), the \n errors captured up to that point are displayed.\n- The built in jshint has been updated from the master jshint.\n- Fixed errors that would occur with the popup error list when there \n was more than error on a line.\n\n" }, { "path": "messages/1.5.2.txt", "content": "SublimeLinter 1.5.2 changelog\n=============================\n\nCHANGES/FIXES\n-------------\n- Fixed a problem with messages.json that prevented correct\n upgrading.\n\nIMPORTANT\n---------\nPlease check to see if you have multiple listings for `SublimeLinter`\nin `Preferences -> Package Settings`. If you do see 2 listings, \nplease run `Package Control: Upgrade/Overwrite All Packages` from \nthe Command Palette (`Tools -> Command Palette`).\n" }, { "path": "messages/1.5.3.txt", "content": "SublimeLinter 1.5.3 changelog\n=============================\n\nCHANGES/FIXES\n-------------\n- Annotations have been fixed.\n- Entries in \"sublimelinter_syntax_map\" take precedence over built\n in mappings.\n- Lint errors in PHP files will hopefully not be logged to the PHP \n log file.\n" }, { "path": "messages/1.5.4.txt", "content": "SublimeLinter 1.5.4 changelog\n=============================\n\nCHANGES/FIXES\n-------------\n- jshint.js has been updated to the latest master version.\n- [issue #128] An \"unsafe\" option has been added to jshint. If set \n true, any UTF-8 characters are allowed in the source.\n" }, { "path": "messages/1.5.5.txt", "content": "SublimeLinter 1.5.5 changelog\n=============================\n\nCHANGES/FIXES\n-------------\n- This change log is available from the SublimeLinter preferences \n menu.\n" }, { "path": "messages/1.5.6.txt", "content": "SublimeLinter 1.5.6 changelog\n=============================\n\nCHANGES/FIXES\n-------------\n- Fixed a problem with messages.json that prevented correct\n upgrading.\n\nIMPORTANT\n---------\nPlease check to see if you have multiple listings for `SublimeLinter`\nin `Preferences -> Package Settings`. If you do see 2 listings, \nplease run `Package Control: Upgrade/Overwrite All Packages` from \nthe Command Palette (`Tools -> Command Palette`).\n" }, { "path": "messages/1.5.7.txt", "content": "SublimeLinter 1.5.7 changelog\n=============================\n\nCHANGES/FIXES\n-------------\n- node.js is the preferred JavaScript engine on Mac OS X and will be \n used if it is installed. JavaScriptCore does not handle non-ASCII \n text correctly and you should install node.js if possible.\n- If you imported `BaseLinter.JSC_PATH`, please change your linter to\n use the `self.jsc_path()` method instead. JSC_PATH should no \n longer be considered public.\n" }, { "path": "messages/1.6.0.txt", "content": "SublimeLinter 1.6.0 changelog\n=============================\n\nNEW FEATURES\n------------\n- Simpler abstraction of JavaScript engines for JS powered linters.\n\n To leverage a JS linter, include a \"linter.js\" file; this file \n should `require` the actual linter library file and export a `lint`\n function. The `lint` function should return a list of errors back \n to the python language handler file (via the `errors` parameter to \n the `parse_errors` method).\n\n Although \"linter.js\" should follow the Node.js api, the linter may \n also be run via JavaScriptCore on OS X if Node.js is not installed.\n In the case where JavaScriptCore is used, require + export are \n shimmed to keep things consistent. However, it is important not to \n assume that a full Node.js api is available. If you must know what \n JS engine you are using, you may check for `USING_JSC` to be set \n as `true` when JavaScriptCore is used.\n \n For examples of using the JS engines, see \"csslint\", \"jslint\", and\n \"jshint\" in \"SublimeLinter/sublimelinter/modules/libs\" and the \n respective python code of \"css.py\" and \"javascript.py\" in\n \"SublimeLinter/sublimelinter/modules\".\n- Douglas Crockford's [JSLint](http://jslint.com) JavaScript linter\n is now supported. To use JSLint set the \"javascript_linter\" setting\n to \"jslint\". You may also customize jslint behavior with the\n \"jslint_options\" setting. For more information about options \n available to JSLint, see http://jslint.com/lint.html.\n- The [CSSLint](http://csslint.net) CSS linter is now supported.\n By default all CSSLint settings are turned on. You may customize\n csslint behavior with the \"csslint_options\" setting. Please select\n \"Preferences->Package Settings->SublimeLinter->Settings - Default\"\n for more information on turning off or adjusting severity of tests.\n For more information about options available to CSSLint, see\n https://github.com/stubbornella/csslint/wiki/Rules.\n" }, { "path": "messages/1.6.1.txt", "content": "SublimeLinter 1.6.1 changelog\n=============================\n\nCHANGES/FIXES\n-------------\n- Fixed an issue (#141) with JSLint running in Node.js\n- Updated CSSLint, JSLint, JSHint to latest stable releases.\n- Added additional debugging output (in Sublime console) when\n errors occur running linters written in JavaScript.\n" }, { "path": "messages/1.6.10.txt", "content": "SublimeLinter 1.6.10 changelog\n==============================\n\nCHANGES/FIXES\n-------------\n- Puppet validation supports error output for Puppet v3.0+.\n- JSHint options now support the (proper) \"globals\" definition.\n- Lua syntax check no longer creates luac.out file clutter.\n- Clarified documentation for styling sublimelinter.annotations.\n" }, { "path": "messages/1.6.11.txt", "content": "SublimeLinter 1.6.11 changelog\n==============================\n\nCHANGES/FIXES\n-------------\n- Github (nodeload) zip url scheme changed.\n" }, { "path": "messages/1.6.12.txt", "content": "SublimeLinter 1.6.12 changelog\n==============================\n\nCHANGES/FIXES\n-------------\n- Cpplint no longer uses a temporary file - it leverages stdin\n instead.\n- Fixed issue #298: C linter throws \"KeyError\"\n" }, { "path": "messages/1.6.13.txt", "content": "SublimeLinter 1.6.13 changelog\n==============================\n\nCHANGES/FIXES\n-------------\n- Updated PEP8 to version v1.4\n- Updated PyFlakes to v0.6.1\n- Updated CSSLint to v0.9.10\n- Update JSHint to v1.0.0\n- Update JSLint to latest\n- Fixed issues with attempting to encode file name when using \n scratch space.\n" }, { "path": "messages/1.6.2.txt", "content": "SublimeLinter 1.6.2 changelog\n=============================\n\nCHANGES/FIXES\n-------------\n- Replaced the default perl linter with Perl::Critic. The standard \n Perl syntax checker can still be invoked by switching the \n \"perl_linter\" setting to \"perl\".\n- Added a LICENSE file to define appropriate usage of SublimeLinter \n and its source.\n- Converted README back to markdown.\n\nIMPORTANT\n---------\nDue to a vulnerability (issue #77) with the Perl linter, Perl syntax\nchecking is no longer enabled by default. The default linter for\nPerl has been replaced by Perl::Critic.\n" }, { "path": "messages/1.6.3.txt", "content": "SublimeLinter 1.6.3 changelog\n=============================\n\nNEW FEATURES\n------------\n- Support for `.jshintrc` files. If using JSHint, SublimeLinter\n will recursively search the directory tree (from the file location\n to the file-system root directory). This functionality is\n specified in the JSHint README.\n https://github.com/jshint/node-jshint/#within-your-projects-directory-tree\n\nCHANGES/FIXES\n-------------\n- Fixed README reference in the menu.\n- Updated CoffeeScript module to be compatible with the updated\n coffee command in version 1.3.\n\nIMPORTANT\n---------\nIf you are using the CoffeeScript linting, please upgrade\nthe installed coffee-script NPM module to 1.3 or greater.\n\n npm update -g coffee-script\n" }, { "path": "messages/1.6.4.txt", "content": "SublimeLinter 1.6.4 changelog\n=============================\n\nIMPORTANT!!\n-----------\nPlease note that the SublimeLinter repository has moved to:\n\n https://github.com/SublimeLinter/SublimeLinter\n\nIssues and pull requests should be made there.\n\nNEW FEATURES\n------------\n- The Objective-J linter now catches spaces inside parentheses\n and dependent clauses on the same line as a control structure.\n\nCHANGES/FIXES\n-------------\n- The README has been reorganized to hopefully be clearer.\n- More explicit Node.js installation instructions have been provided.\n- The \"pep8\" setting is now recognized in SublimeLinter's settings.\n- When a minimum delay is specified with the \"sublimelinter_delay\" \n setting, SublimeLinter will only lint the currently displayed file \n when the queued linters run. This allows you to avoid linting of \n files as they are selected in the choose file palette.\n" }, { "path": "messages/1.6.5.txt", "content": "SublimeLinter 1.6.5 changelog\n=============================\n\nNEW FEATURES\n------------\n- Added a (Ruby) Haml linter based on `haml -c`. For more \n information about Haml, please see http://haml.info.\n- Added a simple Git commit message linter. This linter follows the\n rules as defined by\n http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html\n\nCHANGES/FIXES\n-------------\n- Updated several links to point to the SublimeLinter's new Github\n location.\n- \"Ruby on Rails\" syntax maps to \"ruby\" as part of the default\n settings.\n- Linter arguments are now consistently defined as arrays (instead\n of tuples).\n- Syntax map settings are no longer (sometimes) case-sensitive.\n" }, { "path": "messages/1.6.6.txt", "content": "SublimeLinter 1.6.6 changelog\n=============================\n\nCHANGES/FIXES\n-------------\n- JSHint now shows underlines at the appropriate character positions \n when using tabs for indentation.\n- Upgrading CSSLint to the latest version (v0.9.8). This adds \n support for the latest \"Compatibility\" options: \"Disallow star \n hack\" and \"Disallow underscore hack\".\n- Annotation highlighting is working again.\n- Git Commit Message linting now ignores `git --diff` output in\n messages. These lines are automatically generated and inserted\n when running `git commit -v`.\n" }, { "path": "messages/1.6.7.txt", "content": "SublimeLinter 1.6.7 changelog\n=============================\n\nNEW FEATURES\n------------\n- Puppet linting is now supported via `puppet parser validate`.\n- Added an option for more granular control of outline decorations. \n Set the value of \"sublimelinter_mark_style\" to \"outline\", \"fill\", \n or \"none\" in the user settings.\n\nCHANGES/FIXES\n-------------\n- Repaired the built-in CSS linter (CSSLint). This was broken with\n with the last update.\n- Added missing documentation for \"save-only\" linting in the\n settings file.\n- Adjusted ambiguous/misleading documentation for the\n \"sublimelinter_executable_map\" setting.\n" }, { "path": "messages/1.6.8.txt", "content": "SublimeLinter 1.6.8 changelog\n=============================\n\nNEW FEATURES\n------------\n- HTML5 linting support via `tidy`. This linter will not run unless\n you have a version of tidy with HTML5 support. To use this linter, \n please see: https://github.com/w3c/tidy-html5\n- XML linting via `xmllint`.\n\nCHANGES/FIXES\n-------------\n- Made significant progress on issue (#181). However, SublimeLinter \n still throws with some linter types on Windows 7 when a user has \n non-ascii characters in the path (to the SL plugin).\n- Updated PEP8 to v1.1\n- Updated Pyflakes to v0.5.0\n- Updated JSHint to latest stable (r11).\n- Reverted a fix for accurate (JSHint) error column positions (when \n using tab indentation) due to a regression with the `\"white\": true`\n option. You may still manually fix error positions by setting\n `\"indent\": 1`.\n- Changed (the default) background linting delay to a more sane 2\n seconds. This reduces memory usage, cpu processing, and visual \n noise while you are actively writing code.\n" }, { "path": "messages/1.6.9.txt", "content": "SublimeLinter 1.6.9 changelog\n=============================\n\nNEW FEATURES\n------------\n- C/C++ lint via `cppcheck`. Also added alternative (hidden) support \n for `cpplint.py`. Please see README for more info.\n- Lua syntax check via `luac`.\n\nCHANGES/FIXES\n-------------\n- Adding a 'beta' channel for SublimeLinter into Package Control.\n This branch will act as a more formal method for testing new\n features and fixes before a release.\n" }, { "path": "messages/1.7.0.txt", "content": "SublimeLinter 1.7.0 changelog\n=============================\n\nNEW FEATURES\n------------\n- Add \"Quick Start\" section to the README\n- New commands for the (Sublime Text) command palette to open the \n SublimeLinter preferences files (Default & User)\n- Ruby linting support via [ruby-lint](https://github.com/YorickPeterse/ruby-lint)\n- Haskell linting support via [hlint](http://community.haskell.org/~ndm/hlint/)\n- Add gutter mark themes. Add 5 new built-in themes:\n \"alpha\", \"bright\", \"dark\", \"hard\", and \"simple\".\n Custom themes can also be used.\n\nCHANGES/FIXES\n-------------\n- Update JSHint to v1.1.0\n- Update CoffeeScript linter to support latest error message format\n- Settings are refreshed when a new file is saved; this should fix\n several bugs: #233, #359, #149, #367\n- The `lint_args` setting now matches the documentation; it will\n override the default arguments rather than extend them. This will\n give users full control over linter/checker arguments.\n- Clean up markdown formatting in changelog\n\nIMPORTANT\n---------\nDue to the fix for `lint_args`, if you are currently customizing this\nsetting, you **must** adjust your settings.\n" }, { "path": "messages/1.7.1.txt", "content": "SublimeLinter 1.7.1 changelog\n=============================\n\nCHANGES/FIXES\n-------------\n- Update JSLint to latest\n- Update JSHint to v2.1.5\n- Updated link to JSHint documentation\n- Updated PEP8 to v1.4.6\n- Updated Pyflakes to v0.7.3\n- Gutter mark icons are now retina quality\n- Included Gutter mark icon PSD (for tinkering :)\n" }, { "path": "messages/1.7.2.txt", "content": "SublimeLinter 1.7.2 changelog\n=============================\n\nCHANGES/FIXES\n-------------\n- Update JSHint to v2.1.8\n- Fixing compatibility regression with latest JSHint\n- Fixing compatibility regression with latest Pyflakes\n- Apologizing for hasty v1.7.1 release ;)\n" }, { "path": "messages/SublimeLinter3-update1.txt", "content": "=====================\nSublimeLinter for ST3\nFundraising update\n=====================\n\nAs of October 28, we have raised $980 (after fees) from 90 donations.\nThis is enough to get started, but I was hoping for twice that amount.\nIf you are one of the thousands of happy SublimeLinter users who has not donated,\nplease consider making a small donation to keep this plugin alive.\nOpen source software is not free! It is we the developers who usually\nend up paying for it.\n\nTo donate and find out more about what you can expect from SublimeLinter3,\ngo here:\n\nhttps://github.com/SublimeLinter/SublimeLinter3#sublimelinter3\n\nIf you are interested in helping with development, please leave a message\nhere:\n\nhttps://github.com/SublimeLinter/SublimeLinter3/issues/3\n\nThanks again for your support,\n\n- Aparajita Fishman\n SublimeLinter maintainer\n" }, { "path": "messages/SublimeLinter3-update2.txt", "content": "=====================\nSublimeLinter for ST3\nFundraising update\nOctober 31, 2013\n=====================\n\nThrough October 30, we have raised $2885 (after fees) from 226 donations. Thank you for your support!\nDevelopment has started, and I’m very excited about this new version! But there is still a lot of work\nto do, and I’m getting cool new ideas every day.\n\nSo if you are one of the thousands of happy SublimeLinter users who has not donated yet, it isn’t too late\nto contribute. Please consider making a small donation to fund ongoing development and to compensate\nRyan Hileman for the great work on which SublimeLinter3 is based.\n\nOpen source software is not free! It is we the developers who usually end up paying for it.\nTo donate and find out more about what you can expect from SublimeLinter3, go here:\n\nhttps://github.com/SublimeLinter/SublimeLinter3#sublimelinter3\n\nIf you are interested in helping with development, please leave a message here:\n\nhttps://github.com/SublimeLinter/SublimeLinter3/issues/3\n\nThanks again for your support,\n\n- Aparajita Fishman\n SublimeLinter maintainer\n" }, { "path": "messages/SublimeLinter3-update3.txt", "content": "\n ____ _ _ _ _ _ _ _____\n / ___| _ _| |__ | (_)_ __ ___ ___| | (_)_ __ | |_ ___ _ __ |___ /\n \\___ \\| | | | '_ \\| | | '_ ` _ \\ / _ \\ | | | '_ \\| __/ _ \\ '__| |_ \\\n ___) | |_| | |_) | | | | | | | | __/ |___| | | | | || __/ | ___) |\n |____/ \\__,_|_.__/|_|_|_| |_| |_|\\___|_____|_|_| |_|\\__\\___|_| |____/\n\n _\n | |__ __ _ ___\n | '_ \\ / _` / __|\n | | | | (_| \\__ \\\n |_| |_|\\__,_|___/\n\n\n _ _ _ _\n | | __ _ _ __ __| | ___ __| | |\n | |/ _` | '_ \\ / _` |/ _ \\/ _` | |\n | | (_| | | | | (_| | __/ (_| |_|\n |_|\\__,_|_| |_|\\__,_|\\___|\\__,_(_)\n\n\nSublimeLinter for Sublime Text 3 is here, and it’s soooooo much better than before!\nInstall it from Package Control and enjoy!\n\nUnless someone else comes forward, SublimeLinter for Sublime Text 2 will no longer\nbe supported. I strongly encourage everyone to upgrade to Sublime Text 3 and\nSublimeLinter 3 — you’ll be glad you did! Take a look at the extensive documentation\nto see the great new features in SublimeLinter 3.\n\nhttps://github.com/SublimeLinter/SublimeLinter3\n\n\n*****************\n Share the love!\n*****************\n\nI spent hundreds of hours writing and documenting SublimeLinter 3 to make it the best\nit can be — easy to use, easy to configure, easy to update, easy to extend. If you use\nSublimeLinter and feel it is making your coding life better and easier, please consider\nmaking a donation to help fund development and support. Thank you!\n\nTo donate: https://github.com/SublimeLinter/SublimeLinter3#share-the-love\n\nThank you for your support!\n\n- Aparajita Fishman\n SublimeLinter maintainer\n" }, { "path": "messages/SublimeLinter3.txt", "content": "=====================\nSublimeLinter for ST3\nWe need your help!\n=====================\n\nAccording to the Package Control site, SublimeLinter is the 4th most popular\nplugin for Sublime Text, with 224K installs. That's an incredible number.\nThank you to everyone!\n\nWe all want SublimeLinter to become fully compatible with Sublime Text 3,\nand we want it to be better supported. In moving to ST3 (and python 3),\nwe decided to start from scratch with a new architecture (based on sublimelint)\nthat allows us to get the most out of both ST3 and python 3. And we plan\nto join forces with Ryan Hileman and merge sublimelint and SublimeLinter,\nso we can pool our resources.\n\nTo find out more about what you can expect from SublimeLinter3,\nread about it here:\n\nhttps://github.com/SublimeLinter/SublimeLinter3#sublimelinter3\n\nTo make this happen any time soon, we need your help. I have lots of other\nprojects that currently have a higher priority than SublimeLinter3. If you\nvalue SublimeLinter and want to see it running on ST3 sooner rather than later,\nplease consider donating. If we can raise $3-5K, I'll move SublimeLinter3\nto top of my priority list and finish it off within a week or two.\n\nSee the link above for info on donating.\n\nThanks again,\n\n- Aparajita Fishman\n SublimeLinter maintainer\n" }, { "path": "messages/install.txt", "content": "SublimeLinter\n=============\n\nSublimeLinter is a plugin that supports \"lint\" programs (known as \"linters\"). SublimeLinter highlights\nlines of code the linter deems to contain (potential) errors. It also\nsupports highlighting special annotations (for example: TODO) so that they\ncan be quickly located.\n\nSublimeLinter has built in linters for the following languages:\n\n* C/C++ - lint via `cppcheck`\n* CoffeeScript - lint via `coffee -s -l`\n* CSS - lint via built-in [csslint](http://csslint.net)\n* Git Commit Messages - lint via built-in module based on [A Note About Git Commit Messages](http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html).\n* Haml - syntax check via `haml -c`\n* HTML - lint via `tidy` (actually [tidy for HTML5](http://w3c.github.com/tidy-html5/))\n* Java - lint via `javac -Xlint`\n* JavaScript - lint via built in [jshint](http://jshint.org), [jslint](http://jslint.com), or the [closure linter (gjslint)](https://developers.google.com/closure/utilities/docs/linter_howto) (if installed)\n* Lua - syntax check via `luac`\n* Objective-J - lint via built-in [capp_lint](https://github.com/aparajita/capp_lint)\n* Perl - lint via [Perl:Critic](http://perlcritic.com/) or syntax+deprecation check via `perl -c`\n* PHP - syntax check via `php -l`\n* Puppet - syntax check via `puppet parser validate`\n* Python - native, moderately-complete lint\n* Ruby - syntax check via `ruby -wc`\n* XML - lint via `xmllint`\n\n\nFor more information:\n---------------------\nPlease take the time to read the documentation:\n\n* Online - https://github.com/SublimeLinter/SublimeLinter\n* Sublime Text - Select Preferences->Package Settings->SublimeLinter->README\n\n\nIMPORTANT\n\nDo NOT edit the default SublimeLinter settings. Your changes will be lost\nwhen SublimeLinter is updated. ALWAYS edit the user SublimeLinter settings\nby selecting \"Preferences->Package Settings->SublimeLinter->Settings - User\".\nNote that individual settings you include in your user settings will **completely**\nreplace the corresponding default setting, so you must provide that setting in its entirety.\n" }, { "path": "messages.json", "content": "{\n \"install\": \"messages/install.txt\",\n \"1.5.1\": \"messages/1.5.1.txt\",\n \"1.5.2\": \"messages/1.5.2.txt\",\n \"1.5.3\": \"messages/1.5.3.txt\",\n \"1.5.4\": \"messages/1.5.4.txt\",\n \"1.5.5\": \"messages/1.5.5.txt\",\n \"1.5.6\": \"messages/1.5.6.txt\",\n \"1.5.7\": \"messages/1.5.7.txt\",\n \"1.6.0\": \"messages/1.6.0.txt\",\n \"1.6.1\": \"messages/1.6.1.txt\",\n \"1.6.2\": \"messages/1.6.2.txt\",\n \"1.6.3\": \"messages/1.6.3.txt\",\n \"1.6.4\": \"messages/1.6.4.txt\",\n \"1.6.5\": \"messages/1.6.5.txt\",\n \"1.6.6\": \"messages/1.6.6.txt\",\n \"1.6.7\": \"messages/1.6.7.txt\",\n \"1.6.8\": \"messages/1.6.8.txt\",\n \"1.6.9\": \"messages/1.6.9.txt\",\n \"1.6.10\": \"messages/1.6.10.txt\",\n \"1.6.11\": \"messages/1.6.11.txt\",\n \"1.6.12\": \"messages/1.6.12.txt\",\n \"1.6.13\": \"messages/1.6.13.txt\",\n \"1.7.0\": \"messages/1.7.0.txt\",\n \"1.7.1\": \"messages/1.7.1.txt\",\n \"1.7.2\": \"messages/1.7.2.txt\",\n \"1.7.2+1\": \"messages/SublimeLinter3.txt\",\n \"1.7.2+3\": \"messages/SublimeLinter3-update1.txt\",\n \"1.7.2+4\": \"messages/SublimeLinter3-update2.txt\",\n \"1.7.2+5\": \"messages/SublimeLinter3-update3.txt\"\n}\n" }, { "path": "package_control.json", "content": "{\n\t\"schema_version\": \"1.1\",\n\t\"packages\": [\n\t\t{\n\t\t\t\"name\": \"SublimeLinter\",\n\t\t\t\"description\": \"Inline lint highlighting for the Sublime Text 2 editor\",\n\t\t\t\"author\": \"Kronuz, Aparajita Fishman, Jake Swartwood\",\n\t\t\t\"homepage\": \"http://github.com/SublimeLinter/SublimeLinter\",\n\t\t\t\"platforms\": {\n\t\t\t\t\"*\": [\n\t\t\t\t\t{\n\t\t\t\t\t\t\"version\": \"1.7.2+4\",\n\t\t\t\t\t\t\"url\": \"https://nodeload.github.com/SublimeLinter/SublimeLinter/zip/v1.7.2+4\"\n\t\t\t\t\t}\n\t\t\t\t]\n\t\t\t}\n\t\t},\n\t\t{\n\t\t\t\"name\": \"SublimeLinter Beta\",\n\t\t\t\"description\": \"This version is considered unstable; only install this package if you plan on testing\",\n\t\t\t\"author\": \"Kronuz, Aparajita Fishman, Jake Swartwood\",\n\t\t\t\"homepage\": \"https://github.com/SublimeLinter/SublimeLinter/tree/beta\",\n\t\t\t\"platforms\": {\n\t\t\t\t\"*\": [\n\t\t\t\t\t{\n\t\t\t\t\t\t\"version\": \"1.7.3-beta.0\",\n\t\t\t\t\t\t\"url\": \"https://nodeload.github.com/SublimeLinter/SublimeLinter/zip/beta\"\n\t\t\t\t\t}\n\t\t\t\t]\n\t\t\t}\n\t\t}\n\t]\n}\n" }, { "path": "sublimelinter/__init__.py", "content": "" }, { "path": "sublimelinter/loader.py", "content": "# Note: Unlike linter modules, changes made to this module will NOT take effect until\n# Sublime Text is restarted.\n\nimport glob\nimport os\nimport os.path\nimport sys\n\nimport modules.base_linter as base_linter\n\n# sys.path appears to ignore individual paths with unicode characters.\n# This means that this lib_path will be ignored for Windows 7 users with\n# non-ascii characters in their username (thus as their home directory).\n#\n# libs_path = os.path.abspath(os.path.join(os.path.dirname(__file__.encode('utf-8')), u'modules', u'libs'))\n#\n# if libs_path not in sys.path:\n# sys.path.insert(0, libs_path)\n\n# As a fix for the Windows 7 lib path issue (#181), the individual modules in\n# the `libs` folder can be explicitly imported. This obviously doesn't scale\n# well, but may be a necessary evil until ST2 upgrades its internal Python.\n#\ntmpdir = os.getcwdu()\nos.chdir(os.path.abspath(os.path.join(os.path.dirname(__file__.encode('utf-8')), u'modules', u'libs')))\n\nfor mod in [u'capp_lint', u'pep8', u'pyflakes', u'pyflakes.api', u'pyflakes.checker', u'pyflakes.messages', u'pyflakes.reporter']:\n __import__(mod)\n print u'imported {0}'.format(mod)\n\nos.chdir(tmpdir)\n\n\nclass Loader(object):\n '''utility class to load (and reload if necessary) SublimeLinter modules'''\n def __init__(self, basedir, linters):\n '''assign relevant variables and load all existing linter modules'''\n self.basedir = basedir\n self.basepath = u'sublimelinter/modules'\n self.linters = linters\n self.modpath = self.basepath.replace('/', u'.')\n self.ignored = ('__init__', 'base_linter')\n self.fix_path()\n self.load_all()\n\n def fix_path(self):\n if os.name != 'posix':\n return\n\n path = os.environ['PATH'].encode('utf-8')\n home_path = os.path.join(os.path.expanduser(u'~'), u'bin')\n\n if path:\n dirs = path.encode('utf-8').split(':')\n\n if u'/usr/local/bin' not in dirs:\n dirs.insert(0, u'/usr/local/bin')\n\n if home_path not in dirs:\n dirs.append(home_path)\n\n os.environ['PATH'] = u':'.join(dirs)\n\n def load_all(self):\n '''loads all existing linter modules'''\n for modf in glob.glob(u'{0}/*.py'.format(self.basepath)):\n base, name = os.path.split(modf)\n name = name.split('.', 1)[0]\n\n if name in self.ignored:\n continue\n\n self.load_module(name)\n\n def load_module(self, name):\n '''loads a single linter module'''\n fullmod = u'{0}.{1}'.format(self.modpath, name)\n\n # make sure the path didn't change on us (this is needed for submodule reload)\n pushd = os.getcwdu()\n os.chdir(self.basedir)\n\n __import__(fullmod)\n\n # this following line of code does two things:\n # first, we get the actual module from sys.modules,\n # not the base mod returned by __import__\n # second, we get an updated version with reload()\n # so module development is easier\n # (to make sublime text reload language submodule,\n # just save sublimelinter_plugin.py )\n mod = sys.modules[fullmod] = reload(sys.modules[fullmod])\n\n # update module's __file__ to absolute path so we can reload it\n # if saved with sublime text\n mod.__file__ = os.path.abspath(mod.__file__.encode('utf-8')).rstrip('co')\n\n language = ''\n\n try:\n config = base_linter.CONFIG.copy()\n\n try:\n config.update(mod.CONFIG)\n language = config['language']\n except (AttributeError, KeyError):\n pass\n\n if language:\n if hasattr(mod, 'Linter'):\n linter = mod.Linter(config)\n else:\n linter = base_linter.BaseLinter(config)\n\n lc_language = language.lower()\n self.linters[lc_language] = linter\n print u'SublimeLinter: {0} loaded'.format(language)\n else:\n print u'SublimeLinter: {0} disabled (no language specified in module)'.format(name)\n\n except KeyError:\n print u'SublimeLinter: general error importing {0} ({1})'.format(name, language or '')\n\n os.chdir(pushd)\n\n def reload_module(self, module):\n '''reload a single linter module\n This method is meant to be used when editing a given\n linter module so that changes can be viewed immediately\n upon saving without having to restart Sublime Text'''\n fullmod = module.__name__\n\n if not fullmod.startswith(self.modpath):\n return\n\n name = fullmod.replace(self.modpath + '.', '', 1)\n self.load_module(name)\n" }, { "path": "sublimelinter/modules/__init__.py", "content": "" }, { "path": "sublimelinter/modules/base_linter.py", "content": "# base_linter.py - base class for linters\n\nimport os\nimport os.path\nimport json\nimport re\nimport subprocess\n\nimport sublime\n\n# If the linter uses an executable that takes stdin, use this input method.\nINPUT_METHOD_STDIN = 1\n\n# If the linter uses an executable that does not take stdin but you wish to use\n# a temp file so that the current view can be linted interactively, use this input method.\n# If the current view has been saved, the tempfile will have the same name as the\n# view's file, which is necessary for some linters.\nINPUT_METHOD_TEMP_FILE = 2\n\n# If the linter uses an executable that does not take stdin and you wish to have\n# linting occur only on file load and save, use this input method.\nINPUT_METHOD_FILE = 3\n\nCONFIG = {\n # The display language name for this linter.\n 'language': '',\n\n # Linters may either use built in code or use an external executable. This item may have\n # one of the following values:\n #\n # string - An external command (or path to a command) to execute\n # None - The linter is considered to be built in\n #\n # Alternately, your linter class may define the method get_executable(),\n # which should return the three-tuple (, , ):\n # must be a boolean than indicates whether the executable is available and usable.\n # If is True, must be one of:\n # - A command string (or path to a command) if an external executable will be used\n # - None if built in code will be used\n # - False if no suitable executable can be found or the linter should be disabled\n # for some other reason.\n # is the message that will be shown in the console when the linter is\n # loaded, to aid the user in knowing what the status of the linter is. If None or an empty string,\n # a default message will be returned based on the value of . Otherwise it\n # must be a string.\n 'executable': None,\n\n # If an external executable is being used, this item specifies the arguments\n # used when checking the existence of the executable to determine if the linter can be enabled.\n # If more than one argument needs to be passed, use a tuple/list.\n # Defaults to '-v' if this item is missing.\n 'test_existence_args': '-v',\n\n # If an external executable is being used, this item specifies the arguments to be passed\n # when linting. If there is more than one argument, use a tuple/list.\n # If the input method is anything other than INPUT_METHOD_STDIN, put a {filename} placeholder in\n # the args where the filename should go.\n #\n # Alternately, if your linter class may define the method get_lint_args(), which should return\n # None for no arguments or a tuple/list for one or more arguments.\n 'lint_args': None,\n\n # If an external executable is being used, the method used to pass input to it. Defaults to STDIN.\n 'input_method': INPUT_METHOD_STDIN\n}\n\nTEMPFILES_DIR = os.path.abspath(os.path.join(os.path.dirname(__file__.encode('utf-8')), u'..', u'.tempfiles'))\n\nJSON_MULTILINE_COMMENT_RE = re.compile(r'\\/\\*[\\s\\S]*?\\*\\/')\nJSON_SINGLELINE_COMMENT_RE = re.compile(r'\\/\\/[^\\n\\r]*')\n\nif not os.path.exists(TEMPFILES_DIR):\n os.mkdir(TEMPFILES_DIR)\n\n\nclass BaseLinter(object):\n '''A base class for linters. Your linter module needs to do the following:\n\n - Set the relevant values in CONFIG\n - Override built_in_check() if it uses a built in linter. You may return\n whatever value you want, this value will be passed to parse_errors().\n - Override parse_errors() and populate the relevant lists/dicts. The errors\n argument passed to parse_errors() is the output of the executable run through strip().\n\n If you do subclass and override __init__, be sure to call super(MyLinter, self).__init__(config).\n '''\n\n JSC_PATH = '/System/Library/Frameworks/JavaScriptCore.framework/Versions/A/Resources/jsc'\n\n LIB_PATH = os.path.abspath(os.path.join(os.path.dirname(__file__.encode('utf-8')), u'libs'))\n\n JAVASCRIPT_ENGINES = ['node', 'jsc']\n JAVASCRIPT_ENGINE_NAMES = {'node': 'node.js', 'jsc': 'JavaScriptCore'}\n JAVASCRIPT_ENGINE_WRAPPERS_PATH = os.path.join(LIB_PATH, 'jsengines')\n\n def __init__(self, config):\n self.language = config['language']\n self.enabled = False\n self.executable = config.get('executable', None)\n self.test_existence_args = config.get('test_existence_args', ['-v'])\n self.js_engine = None\n\n if isinstance(self.test_existence_args, basestring):\n self.test_existence_args = (self.test_existence_args,)\n\n self.input_method = config.get('input_method', INPUT_METHOD_STDIN)\n self.filename = None\n self.lint_args = config.get('lint_args', [])\n\n if isinstance(self.lint_args, basestring):\n self.lint_args = [self.lint_args]\n\n def check_enabled(self, view):\n if hasattr(self, 'get_executable'):\n try:\n self.enabled, self.executable, message = self.get_executable(view)\n\n if self.enabled and not message:\n message = 'using \"{0}\"'.format(self.executable) if self.executable else 'built in'\n except Exception as ex:\n self.enabled = False\n message = unicode(ex)\n else:\n self.enabled, message = self._check_enabled(view)\n\n return (self.enabled, message or '')\n\n def _check_enabled(self, view):\n if self.executable is None:\n return (True, 'built in')\n elif isinstance(self.executable, basestring):\n self.executable = self.get_mapped_executable(view, self.executable)\n elif isinstance(self.executable, bool) and self.executable is False:\n return (False, 'unknown error')\n else:\n return (False, 'bad type for CONFIG[\"executable\"]')\n\n # If we get this far, the executable is external. Test that it can be executed\n # and capture stdout and stderr so they don't end up in the system log.\n try:\n args = [self.executable]\n args.extend(self.test_existence_args)\n subprocess.Popen(args, startupinfo=self.get_startupinfo(),\n stdout=subprocess.PIPE, stderr=subprocess.STDOUT).communicate()\n except OSError:\n return (False, '\"{0}\" cannot be found'.format(self.executable))\n\n return (True, 'using \"{0}\" for executable'.format(self.executable))\n\n def _get_lint_args(self, view, code, filename):\n if hasattr(self, 'get_lint_args'):\n return self.get_lint_args(view, code, filename) or []\n else:\n lintArgs = self.lint_args or []\n settings = view.settings().get('SublimeLinter', {}).get(self.language, {})\n\n if settings:\n if 'lint_args' in settings:\n lintArgs = settings['lint_args']\n\n cwd = settings.get('working_directory', '').encode('utf-8')\n\n if cwd and os.path.isabs(cwd) and os.path.isdir(cwd):\n os.chdir(cwd)\n\n return [arg.format(filename=filename) for arg in lintArgs]\n\n def built_in_check(self, view, code, filename):\n return ''\n\n def executable_check(self, view, code, filename):\n args = [self.executable]\n tempfilePath = None\n\n if self.input_method == INPUT_METHOD_STDIN:\n args.extend(self._get_lint_args(view, code, filename))\n\n elif self.input_method == INPUT_METHOD_TEMP_FILE:\n if filename:\n filename = os.path.basename(filename)\n else:\n filename = u'view{0}'.format(view.id())\n\n tempfilePath = os.path.join(TEMPFILES_DIR, filename)\n\n with open(tempfilePath, 'w') as f:\n f.write(code)\n\n args.extend(self._get_lint_args(view, code, tempfilePath))\n code = u''\n\n elif self.input_method == INPUT_METHOD_FILE:\n args.extend(self._get_lint_args(view, code, filename))\n code = u''\n\n else:\n return u''\n\n try:\n process = subprocess.Popen(args,\n stdin=subprocess.PIPE,\n stdout=subprocess.PIPE,\n stderr=subprocess.STDOUT,\n startupinfo=self.get_startupinfo())\n process.stdin.write(code)\n result = process.communicate()[0]\n finally:\n if tempfilePath:\n os.remove(tempfilePath)\n\n return result.strip()\n\n def parse_errors(self, view, errors, lines, errorUnderlines, violationUnderlines, warningUnderlines, errorMessages, violationMessages, warningMessages):\n pass\n\n def add_message(self, lineno, lines, message, messages):\n # Assume lineno is one-based, ST2 wants zero-based line numbers\n lineno -= 1\n lines.add(lineno)\n message = message[0].upper() + message[1:]\n\n # Remove trailing period from error message\n if message[-1] == '.':\n message = message[:-1]\n\n if lineno in messages:\n messages[lineno].append(message)\n else:\n messages[lineno] = [message]\n\n def underline_range(self, view, lineno, position, underlines, length=1):\n # Assume lineno is one-based, ST2 wants zero-based line numbers\n lineno -= 1\n line = view.full_line(view.text_point(lineno, 0))\n position += line.begin()\n\n for i in xrange(length):\n underlines.append(sublime.Region(position + i))\n\n def underline_regex(self, view, lineno, regex, lines, underlines, wordmatch=None, linematch=None):\n # Assume lineno is one-based, ST2 wants zero-based line numbers\n lineno -= 1\n lines.add(lineno)\n offset = 0\n line = view.full_line(view.text_point(lineno, 0))\n lineText = view.substr(line)\n\n if linematch:\n match = re.match(linematch, lineText)\n\n if match:\n lineText = match.group('match')\n offset = match.start('match')\n else:\n return\n\n iters = re.finditer(regex, lineText)\n results = [(result.start('underline'), result.end('underline')) for result in iters if not wordmatch or result.group('underline') == wordmatch]\n\n # Make the lineno one-based again for underline_range\n lineno += 1\n\n for start, end in results:\n self.underline_range(view, lineno, start + offset, underlines, end - start)\n\n def underline_word(self, view, lineno, position, underlines):\n # Assume lineno is one-based, ST2 wants zero-based line numbers\n lineno -= 1\n line = view.full_line(view.text_point(lineno, 0))\n position += line.begin()\n\n word = view.word(position)\n underlines.append(word)\n\n def run(self, view, code, filename=None):\n self.filename = filename\n\n if self.executable is None:\n errors = self.built_in_check(view, code, filename)\n else:\n errors = self.executable_check(view, code, filename)\n\n lines = set()\n errorUnderlines = [] # leave this here for compatibility with original plugin\n errorMessages = {}\n violationUnderlines = []\n violationMessages = {}\n warningUnderlines = []\n warningMessages = {}\n\n self.parse_errors(view, errors, lines, errorUnderlines, violationUnderlines, warningUnderlines, errorMessages, violationMessages, warningMessages)\n return lines, errorUnderlines, violationUnderlines, warningUnderlines, errorMessages, violationMessages, warningMessages\n\n def get_mapped_executable(self, view, default):\n map = view.settings().get('sublimelinter_executable_map')\n\n if map:\n lang = self.language.lower()\n\n if lang in map:\n return map[lang].encode('utf-8')\n\n return default\n\n def get_startupinfo(self):\n info = None\n\n if os.name == 'nt':\n info = subprocess.STARTUPINFO()\n info.dwFlags |= subprocess.STARTF_USESHOWWINDOW\n info.wShowWindow = subprocess.SW_HIDE\n\n return info\n\n def execute_get_output(self, args):\n try:\n return subprocess.Popen(args, self.get_startupinfo()).communicate()[0]\n except:\n return ''\n\n def jsc_path(self):\n '''Return the path to JavaScriptCore. Use this method in case the path\n has to be dynamically calculated in the future.'''\n return self.JSC_PATH\n\n def find_file(self, filename, view):\n '''Find a file with the given name, starting in the view's directory,\n then ascending the file hierarchy up to root.'''\n path = (view.file_name() or '').encode('utf-8')\n\n # quit if the view is temporary\n if not path:\n return None\n\n dirname = os.path.dirname(path)\n\n while True:\n path = os.path.join(dirname, filename)\n\n if os.path.isfile(path):\n with open(path, 'r') as f:\n return f.read()\n\n # if we hit root, quit\n parent = os.path.dirname(dirname)\n\n if parent == dirname:\n return None\n else:\n dirname = parent\n\n def strip_json_comments(self, json_str):\n stripped_json = JSON_MULTILINE_COMMENT_RE.sub('', json_str)\n stripped_json = JSON_SINGLELINE_COMMENT_RE.sub('', stripped_json)\n return json.dumps(json.loads(stripped_json))\n\n def get_javascript_args(self, view, linter, code):\n path = os.path.join(self.LIB_PATH, linter)\n options = self.get_javascript_options(view)\n\n if options is None:\n options = json.dumps(view.settings().get('%s_options' % linter) or {})\n\n self.get_javascript_engine(view)\n engine = self.js_engine\n\n if (engine['name'] == 'jsc'):\n args = [engine['wrapper'], '--', path + os.path.sep, str(code.count('\\n')), options]\n else:\n args = [engine['wrapper'], path + os.path.sep, options]\n\n return args\n\n def get_javascript_options(self, view):\n '''Subclasses should override this if they want to provide options\n for a JavaScript-based linter. If the subclass cannot provide\n options, it should return None (or not return anything).'''\n return None\n\n def get_javascript_engine(self, view):\n if self.js_engine is None:\n for engine in self.JAVASCRIPT_ENGINES:\n if engine == 'node':\n try:\n path = self.get_mapped_executable(view, 'node')\n subprocess.call([path, u'-v'], startupinfo=self.get_startupinfo())\n self.js_engine = {\n 'name': engine,\n 'path': path,\n 'wrapper': os.path.join(self.JAVASCRIPT_ENGINE_WRAPPERS_PATH, engine + '.js'),\n }\n break\n except OSError:\n pass\n\n elif engine == 'jsc':\n if os.path.exists(self.jsc_path()):\n self.js_engine = {\n 'name': engine,\n 'path': self.jsc_path(),\n 'wrapper': os.path.join(self.JAVASCRIPT_ENGINE_WRAPPERS_PATH, engine + '.js'),\n }\n break\n\n if self.js_engine is not None:\n return (True, self.js_engine['path'], 'using {0}'.format(self.JAVASCRIPT_ENGINE_NAMES[self.js_engine['name']]))\n\n # Didn't find an engine, tell the user\n engine_list = ', '.join(self.JAVASCRIPT_ENGINE_NAMES.values())\n return (False, '', 'One of the following JavaScript engines must be installed: ' + engine_list)\n" }, { "path": "sublimelinter/modules/c.py", "content": "import re\n\nfrom base_linter import BaseLinter, INPUT_METHOD_TEMP_FILE\n\nCONFIG = {\n 'language': 'C',\n 'executable': 'cppcheck',\n 'lint_args': ['--enable=style', '--quiet', '{filename}'],\n 'input_method': INPUT_METHOD_TEMP_FILE\n}\n\n\nclass Linter(BaseLinter):\n CPPCHECK_RE = re.compile(r'\\[.+?:(\\d+?)\\](.+)')\n\n def __init__(self, config):\n super(Linter, self).__init__(config)\n\n def parse_errors(self, view, errors, lines, errorUnderlines,\n violationUnderlines, warningUnderlines,\n errorMessages, violationMessages,\n warningMessages):\n # Go through each line in the output of cppcheck\n for line in errors.splitlines():\n match = self.CPPCHECK_RE.match(line)\n if match:\n # The regular expression matches the line number and\n # the message as its two groups.\n lineno, message = match.group(1), match.group(2)\n # Remove the colon at the beginning of the message\n if len(message) > 0 and message[0] == ':':\n message = message[1:].strip()\n lineno = int(lineno)\n self.add_message(lineno, lines, message, errorMessages)\n" }, { "path": "sublimelinter/modules/c_cpplint.py", "content": "import re\n\nfrom base_linter import BaseLinter\n\nCONFIG = {\n 'language': 'c_cpplint',\n 'executable': 'cpplint.py',\n 'test_existence_args': ['--help'],\n 'lint_args': '-',\n}\n\n\nclass Linter(BaseLinter):\n def parse_errors(self, view, errors, lines, errorUnderlines, violationUnderlines, warningUnderlines, errorMessages, violationMessages, warningMessages):\n for line in errors.splitlines():\n match = re.match(r'^.+:(?P\\d+):\\s+(?P.+)', line)\n\n if match:\n error, line = match.group('error'), match.group('line')\n self.add_message(int(line), lines, error, errorMessages)\n" }, { "path": "sublimelinter/modules/coffeescript.py", "content": "import re\nimport os\n\nfrom base_linter import BaseLinter\n\nCONFIG = {\n 'language': 'CoffeeScript',\n 'executable': 'coffee.cmd' if os.name == 'nt' else 'coffee',\n 'lint_args': ['-s', '-l']\n}\n\n\nclass Linter(BaseLinter):\n def parse_errors(self, view, errors, lines, errorUnderlines,\n violationUnderlines, warningUnderlines, errorMessages,\n violationMessages, warningMessages):\n\n for line in errors.splitlines():\n match = re.match(r'.*?Error: Parse error on line '\n r'(?P\\d+): (?P.+)', line)\n if not match:\n match = re.match(r'.*?Error: (?P.+) '\n r'on line (?P\\d+)', line)\n if not match:\n match = re.match(r'[^:]+:(?P\\d+):\\d+: '\n r'error: (?P.+)', line)\n\n if match:\n line, error = match.group('line'), match.group('error')\n self.add_message(int(line), lines, error, errorMessages)\n" }, { "path": "sublimelinter/modules/css.py", "content": "import json\n\nfrom base_linter import BaseLinter\n\nCONFIG = {\n 'language': 'CSS'\n}\n\n\nclass Linter(BaseLinter):\n def __init__(self, config):\n super(Linter, self).__init__(config)\n\n def get_executable(self, view):\n return self.get_javascript_engine(view)\n\n def get_lint_args(self, view, code, filename):\n return self.get_javascript_args(view, 'csslint', code)\n\n def parse_errors(self, view, errors, lines, errorUnderlines, violationUnderlines, warningUnderlines, errorMessages, violationMessages, warningMessages):\n try:\n errors = json.loads(errors.strip() or '[]')\n except ValueError:\n raise ValueError(\"Error from csslint: {0}\".format(errors))\n\n for error in errors:\n lineno = error['line']\n\n if error['type'] == 'warning':\n messages = warningMessages\n underlines = warningUnderlines\n else:\n messages = errorMessages\n underlines = errorUnderlines\n\n self.add_message(lineno, lines, error['reason'], messages)\n self.underline_range(view, lineno, error['character'] - 1, underlines)\n" }, { "path": "sublimelinter/modules/git_commit_message.py", "content": "from base_linter import BaseLinter\n\n\nCONFIG = {\n 'language': 'Git Commit Message'\n}\n\n\nclass ErrorType:\n WARNING = 'warning'\n VIOLATION = 'violation'\n ERROR = 'error'\n\n\nclass Linter(BaseLinter):\n\n def built_in_check(self, view, code, filename):\n lines = code.splitlines()\n lineno = 0\n real_lineno = 0\n first_line_of_message = None\n first_line_of_body = None\n errors = []\n\n for line in lines:\n real_lineno += 1\n\n if line.startswith('#'):\n continue\n\n if line.startswith('diff --git'):\n break\n\n lineno += 1\n\n if first_line_of_message is None:\n if line.strip():\n first_line_of_message = lineno\n\n if len(line) > 68:\n errors.append({\n 'type': ErrorType.ERROR,\n 'message': 'Subject line must be 68 characters or less (github will truncate).',\n 'lineno': real_lineno,\n 'col': 68,\n })\n elif len(line) > 50:\n errors.append({\n 'type': ErrorType.WARNING,\n 'message': 'Subject line should be 50 characters or less.',\n 'lineno': real_lineno,\n 'col': 50,\n })\n elif lineno != 1:\n errors.append({\n 'type': ErrorType.ERROR,\n 'message': 'Subject must be on first line.',\n 'lineno': real_lineno,\n })\n elif line[0].upper() != line[0]:\n errors.append({\n 'type': ErrorType.VIOLATION,\n 'message': 'Subject line should be capitalized.',\n 'lineno': real_lineno,\n })\n elif first_line_of_body is None:\n if len(line):\n first_line_of_body = lineno\n\n if lineno == first_line_of_message + 1:\n if len(line):\n errors.append({\n 'message': 'Leave a blank line between the message subject and body.',\n 'lineno': first_line_of_message + 1,\n })\n elif lineno > first_line_of_message + 2:\n errors.append({\n 'message': 'Leave exactly 1 blank line between the message subject and body.',\n 'lineno': real_lineno,\n })\n if first_line_of_body is not None:\n if len(line) > 72:\n errors.append({\n 'message': 'Lines must not exceed 72 characters.',\n 'lineno': real_lineno,\n 'col': 72,\n })\n\n return errors\n\n def parse_errors(self, view, errors, lines, errorUnderlines, violationUnderlines, warningUnderlines, errorMessages, violationMessages, warningMessages):\n for error in errors:\n error_type = error.get('type', ErrorType.ERROR)\n col = error.get('col', 0)\n\n messages = {\n ErrorType.WARNING: warningMessages,\n ErrorType.VIOLATION: violationMessages,\n ErrorType.ERROR: errorMessages,\n }[error_type]\n underlines = {\n ErrorType.WARNING: warningUnderlines,\n ErrorType.VIOLATION: violationUnderlines,\n ErrorType.ERROR: errorUnderlines,\n }[error_type]\n\n self.add_message(error['lineno'], lines, error['message'], messages)\n self.underline_range(view, error['lineno'], col, underlines, length=1)\n" }, { "path": "sublimelinter/modules/haml.py", "content": "import re\n\nfrom base_linter import BaseLinter\n\nCONFIG = {\n 'language': 'Ruby Haml',\n 'executable': 'haml',\n 'lint_args': '-c'\n}\n\n\nclass Linter(BaseLinter):\n def parse_errors(self, view, errors, lines, errorUnderlines, violationUnderlines, warningUnderlines, errorMessages, violationMessages, warningMessages):\n for line in errors.splitlines():\n match = re.match(r'^.+(?P\\d+):\\s+(?P.+)', line)\n\n if match:\n error, line = match.group('error'), match.group('line')\n self.add_message(int(line), lines, error, errorMessages)\n" }, { "path": "sublimelinter/modules/haskell.py", "content": "import re\nfrom base_linter import BaseLinter, INPUT_METHOD_FILE\n\n\nCONFIG = {\n 'language': 'haskell',\n 'executable': 'hlint',\n 'input_method': INPUT_METHOD_FILE,\n 'lint_args': '{filename}'\n}\n\n\nclass Linter(BaseLinter):\n def parse_errors(self, view, errors, lines, errorUnderlines, violationUnderlines, warningUnderlines, errorMessages, violationMessages, warningMessages):\n i = 0\n error_lines = errors.splitlines()\n while i < len(error_lines):\n error = re.match(r'^.+:(?P\\d+):(?P\\d+): (?P.+)', error_lines[i])\n\n if error:\n message, lineno, col = error.group('error'), int(error.group('line')), int(error.group('col'))\n\n if error_lines[i + 1] == \"Error message:\":\n message = error_lines[i + 2]\n i += 2\n\n lint_error = re.match(r'^(?PError|Warning): (?P.+)', message)\n\n if lint_error:\n error_type, message = lint_error.group('type'), lint_error.group('error')\n\n if error_type == 'Warning':\n messages = warningMessages\n underlines = warningUnderlines\n else:\n messages = errorMessages\n underlines = errorUnderlines\n\n self.add_message(lineno, lines, message, messages)\n self.underline_range(view, lineno, col - 1, underlines)\n\n i += 1\n" }, { "path": "sublimelinter/modules/html.py", "content": "# Example error messages\n#\n# line 1 column 1 - Warning: missing declaration\n# line 200 column 1 - Warning: discarding unexpected \n# line 1 column 1 - Warning: inserting missing 'title' element\n\nimport re\nimport subprocess\n\nfrom base_linter import BaseLinter\n\nCONFIG = {\n 'language': 'HTML',\n 'executable': 'tidy',\n 'lint_args': '-eq'\n}\n\n\nclass Linter(BaseLinter):\n def get_executable(self, view):\n try:\n path = self.get_mapped_executable(view, 'tidy')\n version_string = subprocess.Popen([path, '-v'], startupinfo=self.get_startupinfo(), stdout=subprocess.PIPE).communicate()[0]\n\n if u'HTML5' in version_string:\n return (True, path, 'using tidy for executable')\n\n return (False, '', 'tidy is not ready for HTML5')\n except OSError:\n return (False, '', 'tidy cannot be found')\n\n def parse_errors(self, view, errors, lines, errorUnderlines, violationUnderlines, warningUnderlines, errorMessages, violationMessages, warningMessages):\n for line in errors.splitlines():\n match = re.match(r'^line\\s(?P\\d+)\\scolumn\\s\\d+\\s-\\s(?P.+)', line)\n\n if match:\n error, line = match.group('error'), match.group('line')\n self.add_message(int(line), lines, error, errorMessages)\n" }, { "path": "sublimelinter/modules/java.py", "content": "import os\nimport os.path\nimport re\n\nfrom base_linter import BaseLinter, INPUT_METHOD_FILE\n\nCONFIG = {\n 'language': 'Java',\n 'executable': 'javac',\n 'test_existence_args': '-version',\n 'input_method': INPUT_METHOD_FILE\n}\n\nERROR_RE = re.compile(r'^(?P.*\\.java):(?P\\d+): (?Pwarning: )?(?:\\[\\w+\\] )?(?P.*)')\nMARK_RE = re.compile(r'^(?P\\s*)\\^$')\n\n\nclass Linter(BaseLinter):\n def parse_errors(self, view, errors, lines, errorUnderlines,\n violationUnderlines, warningUnderlines, errorMessages,\n violationMessages, warningMessages):\n it = iter(errors.splitlines())\n\n for line in it:\n match = re.match(ERROR_RE, line)\n\n if match:\n path = os.path.abspath(match.group('path'))\n\n if path != self.filename:\n continue\n\n lineNumber = int(match.group('line'))\n warning = match.group('warning')\n error = match.group('error')\n\n if warning:\n messages = warningMessages\n underlines = warningUnderlines\n else:\n messages = errorMessages\n underlines = errorUnderlines\n\n # Skip forward until we find the marker\n position = -1\n\n while True:\n line = it.next()\n match = re.match(MARK_RE, line)\n\n if match:\n position = len(match.group('mark'))\n break\n\n self.add_message(lineNumber, lines, error, messages)\n self.underline_range(view, lineNumber, position, underlines)\n" }, { "path": "sublimelinter/modules/javascript.py", "content": "import json\nimport re\nimport subprocess\n\nfrom base_linter import BaseLinter, INPUT_METHOD_TEMP_FILE\n\nCONFIG = {\n 'language': 'JavaScript'\n}\n\n\nclass Linter(BaseLinter):\n GJSLINT_RE = re.compile(r'Line (?P\\d+),\\s*E:(?P\\d+):\\s*(?P.+)')\n\n def __init__(self, config):\n super(Linter, self).__init__(config)\n self.linter = None\n\n def get_executable(self, view):\n self.linter = view.settings().get('javascript_linter', 'jshint')\n\n if (self.linter in ('jshint', 'jslint')):\n return self.get_javascript_engine(view)\n elif (self.linter == 'gjslint'):\n try:\n path = self.get_mapped_executable(view, 'gjslint')\n subprocess.call([path, u'--help'], startupinfo=self.get_startupinfo())\n self.input_method = INPUT_METHOD_TEMP_FILE\n return (True, path, 'using gjslint')\n except OSError:\n return (False, '', 'gjslint cannot be found')\n else:\n return (False, '', '\"{0}\" is not a valid javascript linter'.format(self.linter))\n\n def get_lint_args(self, view, code, filename):\n if (self.linter == 'gjslint'):\n args = []\n gjslint_options = view.settings().get(\"gjslint_options\", [])\n args.extend(gjslint_options)\n args.extend([u'--nobeep', filename])\n return args\n elif (self.linter in ('jshint', 'jslint')):\n return self.get_javascript_args(view, self.linter, code)\n else:\n return []\n\n def get_javascript_options(self, view):\n if self.linter == 'jshint':\n rc_options = self.find_file('.jshintrc', view)\n\n if rc_options is not None:\n rc_options = self.strip_json_comments(rc_options)\n return json.dumps(json.loads(rc_options))\n\n def parse_errors(self, view, errors, lines, errorUnderlines, violationUnderlines, warningUnderlines, errorMessages, violationMessages, warningMessages):\n if (self.linter == 'gjslint'):\n ignore = view.settings().get('gjslint_ignore', [])\n\n for line in errors.splitlines():\n match = self.GJSLINT_RE.match(line)\n\n if match:\n line, errnum, message = match.group('line'), match.group('errnum'), match.group('message')\n\n if (int(errnum) not in ignore):\n self.add_message(int(line), lines, message, errorMessages)\n\n elif (self.linter in ('jshint', 'jslint')):\n try:\n errors = json.loads(errors.strip() or '[]')\n except ValueError:\n raise ValueError(\"Error from {0}: {1}\".format(self.linter, errors))\n\n for error in errors:\n lineno = error['line']\n self.add_message(lineno, lines, error['reason'], errorMessages)\n self.underline_range(view, lineno, error['character'] - 1, errorUnderlines)\n" }, { "path": "sublimelinter/modules/libs/capp_lint.py", "content": "#!/usr/bin/env python\n#\n# capp_lint.py - Check Objective-J source code formatting,\n# according to Cappuccino standards:\n#\n# http://cappuccino.org/contribute/coding-style.php\n#\n# Copyright (C) 2011 Aparajita Fishman \n\n# Permission is hereby granted, free of charge, to any person\n# obtaining a copy of this software and associated documentation files\n# (the \"Software\"), to deal in the Software without restriction,\n# including without limitation the rights to use, copy, modify, merge,\n# publish, distribute, sublicense, and/or sell copies of the Software,\n# and to permit persons to whom the Software is furnished to do so,\n# subject to the following conditions:\n#\n# The above copyright notice and this permission notice shall be\n# included in all copies or substantial portions of the Software.\n#\n# THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\n# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF\n# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\n# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS\n# BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN\n# ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN\n# CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n# SOFTWARE.\n\nfrom __future__ import with_statement\nfrom optparse import OptionParser\nfrom string import Template\nimport cgi\nimport cStringIO\nimport os\nimport os.path\nimport re\nimport sys\nimport unittest\n\nEXIT_CODE_SHOW_HTML = 205\nEXIT_CODE_SHOW_TOOLTIP = 206\n\n\ndef exit_show_html(html):\n sys.stdout.write(html.encode('utf-8'))\n sys.exit(EXIT_CODE_SHOW_HTML)\n\n\ndef exit_show_tooltip(text):\n sys.stdout.write(text)\n sys.exit(EXIT_CODE_SHOW_TOOLTIP)\n\n\ndef within_textmate():\n return os.getenv('TM_APP_PATH') is not None\n\n\ndef tabs2spaces(text, positions=None):\n while True:\n index = text.find(u'\\t')\n\n if index < 0:\n return text\n\n spaces = u' ' * (4 - (index % 4))\n text = text[0:index] + spaces + text[index + 1:]\n\n if positions is not None:\n positions.append(index)\n\n\ndef relative_path(basedir, filename):\n if filename.find(basedir) == 0:\n filename = filename[len(basedir) + 1:]\n\n return filename\n\n\ndef string_replacer(line):\n \"\"\"Take string literals like 'hello' and replace them with empty string literals, while respecting escaping.\"\"\"\n\n r = []\n in_quote = None\n escapes = 0\n for i, c in enumerate(line):\n if in_quote:\n if not escapes and c == in_quote:\n in_quote = None\n r.append(c)\n continue\n\n # We're inside of a string literal. Ignore everything.\n else:\n if not escapes and (c == '\"' or c == \"'\"):\n in_quote = c\n r.append(c)\n continue\n\n # Outside of a string literal, preserve everything.\n r.append(c)\n\n if c == '\\\\':\n escapes = (escapes + 1) % 2\n else:\n escapes = 0\n\n if in_quote:\n # Unterminated string literal.\n pass\n return \"\".join(r)\n\n\nclass LintChecker(object):\n \"\"\"Examine Objective-J code statically and generate warnings for possible errors and deviations from the coding-style standard.\n\n >>> LintChecker().lint_text('var b = 5+5;')\n [{'positions': [9], 'filename': '', 'lineNum': 1, 'message': 'binary operator without surrounding spaces', 'type': 2, 'line': u'var b = 5+5;'}]\n\n >>> LintChecker().lint_text('''\n ... if( 1 ) {\n ... var b=7;\n ... c = 8;\n ... }\n ... ''')\n [{'positions': [2], 'filename': '', 'lineNum': 2, 'message': 'missing space between control statement and parentheses', 'type': 2, 'line': u'if( 1 ) {'}, {'positions': [8], 'filename': '', 'lineNum': 2, 'message': 'braces should be on their own line', 'type': 1, 'line': u'if( 1 ) {'}, {'positions': [3, 5], 'filename': '', 'lineNum': 2, 'message': 'space inside parentheses', 'type': 1, 'line': u'if( 1 ) {'}, {'positions': [7], 'filename': '', 'lineNum': 3, 'message': 'assignment operator without surrounding spaces', 'type': 2, 'line': u' var b=7;'}, {'lineNum': 4, 'message': 'accidental global variable', 'type': 1, 'line': u' c = 8;', 'filename': ''}]\n \"\"\"\n\n VAR_BLOCK_START_RE = re.compile(ur'''(?x)\n (?P\\s*) # indent before a var keyword\n (?Pvar\\s+) # var keyword and whitespace after\n (?P[a-zA-Z_$]\\w*)\\s*\n (?:\n (?P=)\\s*\n (?P.*)\n |\n (?P[,;+\\-/*%^&|=\\\\])\n )\n ''')\n\n SEPARATOR_RE = re.compile(ur'''(?x)\n (?P.*) # Everything up to the line separator\n (?P[,;+\\-/*%^&|=\\\\]) # The line separator\n \\s* # Optional whitespace after\n $ # End of expression\n ''')\n\n INDENTED_EXPRESSION_RE_TEMPLATE = ur'''(?x)\n [ ]{%d} # Placeholder for indent of first identifier that started block\n (?P.+) # Expression\n '''\n\n VAR_BLOCK_RE_TEMPLATE = ur'''(?x)\n [ ]{%d} # Placeholder for indent of first identifier that started block\n (?P\\s*) # Capture any further indent\n (?:\n (?P[\\[\\{].*)\n |\n (?P[a-zA-Z_$]\\w*)\\s*\n (?:\n (?P=)\\s*\n (?P.*)\n |\n (?P[,;+\\-/*%%^&|=\\\\])\n )\n |\n (?P.+)\n )\n '''\n\n STATEMENT_RE = re.compile(ur'''(?x)\n \\s*((continue|do|for|function|if|else|return|switch|while|with)\\b|\\[+\\s*[a-zA-Z_$]\\w*\\s+[a-zA-Z_$]\\w*\\s*[:\\]])\n ''')\n\n TRAILING_WHITESPACE_RE = re.compile(ur'^.*(\\s+)$')\n STRIP_LINE_COMMENT_RE = re.compile(ur'(.*)\\s*(?://.*|/\\*.*\\*/\\s*)$')\n LINE_COMMENT_RE = re.compile(ur'\\s*(?:/\\*.*\\*/\\s*|//.*)$')\n COMMENT_RE = re.compile(ur'/\\*.*?\\*/')\n BLOCK_COMMENT_START_RE = re.compile(ur'\\s*/\\*.*(?!\\*/\\s*)$')\n BLOCK_COMMENT_END_RE = re.compile(ur'.*?\\*/')\n METHOD_RE = ur'[-+]\\s*\\([a-zA-Z_$]\\w*\\)\\s*[a-zA-Z_$]\\w*'\n FUNCTION_RE = re.compile(ur'\\s*function\\s*(?P[a-zA-Z_$]\\w*)?\\(.*\\)\\s*\\{?')\n RE_RE = re.compile(ur'(?]*\\)\\s*\\w+|[a-zA-Z_$]\\w*(\\+\\+|--)|([ -+*/%^&|<>!]=?|&&|\\|\\||<<|>>>|={1,3}|!==?)\\s*[-+][\\w(\\[])'), 'pass': False},\n\n # Also convert literals like 1.5e+7 to 42 so that the - or + in there is ignored for purposes of this warning.\n 'preprocess': STD_IGNORES + EXPONENTIAL_TO_SIMPLE,\n 'regex': re.compile(ur'(?<=[\\w)\\]\"\\']|([ ]))([-+*/%^]|&&?|\\|\\|?|<<|>>>?)(?=[\\w({\\[\"\\']|(?(1)\\b\\b|[ ]))'),\n 'error': 'binary operator without surrounding spaces',\n 'showPositionForGroup': 2,\n 'type': ERROR_TYPE_WARNING\n },\n {\n # Filter out possible = within @accessors\n 'filter': {'regex': re.compile(ur'^\\s*(?:@outlet\\s+)?[a-zA-Z_$]\\w*\\s+[a-zA-Z_$]\\w*\\s+@accessors\\b'), 'pass': False},\n\n 'preprocess': STD_IGNORES,\n 'regex': re.compile(ur'(?<=[\\w)\\]\"\\']|([ ]))(=|[-+*/%^&|]=|<<=|>>>?=)(?=[\\w({\\[\"\\']|(?(1)\\b\\b|[ ]))'),\n 'error': 'assignment operator without surrounding spaces',\n 'showPositionForGroup': 2,\n 'type': ERROR_TYPE_WARNING\n },\n {\n # Filter out @import statements and @implementation/method declarations\n 'filter': {'regex': re.compile(ur'^(@import\\b|@implementation\\b|\\s*' + METHOD_RE + ')'), 'pass': False},\n\n 'preprocess': STD_IGNORES,\n 'regex': re.compile(ur'(?<=[\\w)\\]\"\\']|([ ]))(===?|!==?|[<>]=?)(?=[\\w({\\[\"\\']|(?(1)\\b\\b|[ ]))'),\n 'error': 'comparison operator without surrounding spaces',\n 'showPositionForGroup': 2,\n 'type': ERROR_TYPE_WARNING\n },\n {\n 'regex': re.compile(ur'^(\\s+)' + METHOD_RE + '|^\\s*[-+](\\()[a-zA-Z_$][\\w]*\\)\\s*[a-zA-Z_$]\\w*|^\\s*[-+]\\s*\\([a-zA-Z_$][\\w]*\\)(\\s+)[a-zA-Z_$]\\w*'),\n 'error': 'extra or missing space in a method declaration',\n 'showPositionForGroup': 0,\n 'type': ERROR_TYPE_WARNING\n },\n {\n # Check for brace following a class or method declaration\n 'regex': re.compile(ur'^(?:\\s*[-+]\\s*\\([a-zA-Z_$]\\w*\\)|@implementation)\\s*[a-zA-Z_$][\\w]*.*?\\s*(\\{)\\s*(?:$|//.*$)'),\n 'error': 'braces should be on their own line',\n 'showPositionForGroup': 0,\n 'type': ERROR_TYPE_ILLEGAL\n },\n {\n 'regex': re.compile(ur'^\\s*var\\s+[a-zA-Z_$]\\w*\\s*=\\s*function\\s+([a-zA-Z_$]\\w*)\\s*\\('),\n 'error': 'function name is ignored',\n 'showPositionForGroup': 1,\n 'skip': True,\n 'type': ERROR_TYPE_WARNING\n },\n )\n\n VAR_DECLARATIONS = ['none', 'single', 'strict']\n VAR_DECLARATIONS_NONE = 0\n VAR_DECLARATIONS_SINGLE = 1\n VAR_DECLARATIONS_STRICT = 2\n\n DIRS_TO_SKIP = ('.git', 'Frameworks', 'Build', 'Resources', 'CommonJS', 'Objective-J')\n\n ERROR_FORMATS = ('text', 'html')\n TEXT_ERROR_SINGLE_FILE_TEMPLATE = Template(u'$lineNum: $message.\\n+$line\\n')\n TEXT_ERROR_MULTI_FILE_TEMPLATE = Template(u'$filename:$lineNum: $message.\\n+$line\\n')\n\n def __init__(self, view=None, basedir='', var_declarations=VAR_DECLARATIONS_SINGLE, verbose=False):\n self.view = view\n self.basedir = unicode(basedir, 'utf-8')\n self.errors = []\n self.errorFiles = []\n self.filesToCheck = []\n self.varDeclarations = var_declarations\n self.verbose = verbose\n self.sourcefile = None\n self.filename = u''\n self.line = u''\n self.lineNum = 0\n self.varIndent = u''\n self.identifierIndent = u''\n\n self.fileChecklist = (\n {'title': 'Check variable blocks', 'action': self.check_var_blocks},\n )\n\n def run_line_checks(self):\n for check in self.LINE_CHECKLIST:\n option = check.get('option')\n\n if option:\n default = check.get('optionDefault', False)\n\n if self.view and not self.view.settings().get(option, default):\n continue\n\n line = self.line\n originalLine = line\n lineFilter = check.get('filter')\n\n if lineFilter:\n match = lineFilter['regex'].search(line)\n\n if (match and not lineFilter['pass']) or (not match and lineFilter['pass']):\n continue\n\n preprocess = check.get('preprocess')\n\n if preprocess:\n if not isinstance(preprocess, (list, tuple)):\n preprocess = (preprocess,)\n\n for processor in preprocess:\n regex = processor.get('regex')\n\n if regex:\n line = regex.sub(processor.get('replace', ''), line)\n\n fnct = processor.get('function')\n\n if fnct:\n line = fnct(line)\n\n regex = check.get('regex')\n\n if not regex:\n continue\n\n match = regex.search(line)\n\n if not match:\n continue\n\n positions = []\n groups = check.get('showPositionForGroup')\n\n if (check.get('id') == 'tabs'):\n line = tabs2spaces(line, positions=positions)\n elif groups is not None:\n line = tabs2spaces(line)\n\n if not isinstance(groups, (list, tuple)):\n groups = (groups,)\n\n for match in regex.finditer(line):\n for group in groups:\n if group > 0:\n start = match.start(group)\n\n if start >= 0:\n positions.append(start)\n else:\n # group 0 means show the first non-empty match\n for i in range(1, len(match.groups()) + 1):\n if match.start(i) >= 0:\n positions.append(match.start(i))\n break\n\n if positions:\n self.error(check['error'], line=originalLine, positions=positions, type=check['type'])\n\n def next_statement(self, expect_line=False, check_line=True):\n try:\n while True:\n raw_line = self.sourcefile.next()\n # strip EOL\n if raw_line[-1] == '\\n': # ... unless this is the last line which might not have a \\n.\n raw_line = raw_line[:-1]\n\n try:\n self.line = unicode(raw_line, 'utf-8', 'strict') # convert to Unicode\n self.lineNum += 1\n except UnicodeDecodeError:\n self.line = unicode(raw_line, 'utf-8', 'replace')\n self.lineNum += 1\n self.error('line contains invalid unicode character(s)', type=self.ERROR_TYPE_ILLEGAL)\n\n if self.verbose:\n print u'%d: %s' % (self.lineNum, tabs2spaces(self.line))\n\n if check_line:\n self.run_line_checks()\n\n if not self.is_statement():\n continue\n\n return True\n except StopIteration:\n if expect_line:\n self.error('unexpected EOF', type=self.ERROR_TYPE_ILLEGAL)\n raise\n\n def is_statement(self):\n # Skip empty lines\n if len(self.line.strip()) == 0:\n return False\n\n # See if we have a line comment, skip that\n match = self.LINE_COMMENT_RE.match(self.line)\n\n if match:\n return False\n\n # Match a block comment start next so we can find its end,\n # otherwise we might get false matches on the contents of the block comment.\n match = self.BLOCK_COMMENT_START_RE.match(self.line)\n\n if match:\n self.block_comment()\n return False\n\n return True\n\n def is_expression(self):\n match = self.STATEMENT_RE.match(self.line)\n return match is None\n\n def strip_comment(self):\n match = self.STRIP_LINE_COMMENT_RE.match(self.expression)\n\n if match:\n self.expression = match.group(1)\n\n def get_expression(self, lineMatch):\n groupdict = lineMatch.groupdict()\n\n self.expression = groupdict.get('expression')\n\n if self.expression is None:\n self.expression = groupdict.get('bracket')\n\n if self.expression is None:\n self.expression = groupdict.get('indented_expression')\n\n if self.expression is None:\n self.expression = ''\n return\n\n # Remove all quoted strings from the expression so that we don't\n # count unmatched pairs inside the strings.\n self.expression = string_replacer(self.expression)\n\n self.strip_comment()\n self.expression = self.expression.strip()\n\n def block_comment(self):\n 'Find the end of a block comment'\n\n commentOpenCount = self.line.count('/*')\n commentOpenCount -= self.line.count('*/')\n\n # If there is an open comment block, eat it\n if commentOpenCount:\n if self.verbose:\n print u'%d: BLOCK COMMENT START' % self.lineNum\n else:\n return\n\n match = None\n\n while not match and self.next_statement(expect_line=True, check_line=False):\n match = self.BLOCK_COMMENT_END_RE.match(self.line)\n\n if self.verbose:\n print u'%d: BLOCK COMMENT END' % self.lineNum\n\n def balance_pairs(self, squareOpenCount, curlyOpenCount, parenOpenCount):\n # The following lines have to be indented at least as much as the first identifier\n # after the var keyword at the start of the block.\n if self.verbose:\n print \"%d: BALANCE BRACKETS: '['=%d, '{'=%d, '('=%d\" % (self.lineNum, squareOpenCount, curlyOpenCount, parenOpenCount)\n\n lineRE = re.compile(self.INDENTED_EXPRESSION_RE_TEMPLATE % len(self.identifierIndent))\n\n while True:\n # If the expression has open brackets and is terminated, it's an error\n match = self.SEPARATOR_RE.match(self.expression)\n\n if match and match.group('separator') == ';':\n unterminated = []\n\n if squareOpenCount:\n unterminated.append('[')\n\n if curlyOpenCount:\n unterminated.append('{')\n\n if parenOpenCount:\n unterminated.append('(')\n\n self.error('unbalanced %s' % ' and '.join(unterminated), type=self.ERROR_TYPE_ILLEGAL)\n return False\n\n self.next_statement(expect_line=True)\n match = lineRE.match(self.line)\n\n if not match:\n # If it doesn't match, the indent is wrong check the whole line\n self.error('incorrect indentation')\n self.expression = self.line\n self.strip_comment()\n else:\n # It matches, extract the expression\n self.get_expression(match)\n\n # Update the bracket counts\n squareOpenCount += self.expression.count('[')\n squareOpenCount -= self.expression.count(']')\n curlyOpenCount += self.expression.count('{')\n curlyOpenCount -= self.expression.count('}')\n parenOpenCount += self.expression.count('(')\n parenOpenCount -= self.expression.count(')')\n\n if squareOpenCount == 0 and curlyOpenCount == 0 and parenOpenCount == 0:\n if self.verbose:\n print u'%d: BRACKETS BALANCED' % self.lineNum\n\n # The brackets are closed, this line must be separated\n match = self.SEPARATOR_RE.match(self.expression)\n\n if not match:\n self.error('missing statement separator', type=self.ERROR_TYPE_ILLEGAL)\n return False\n\n return True\n\n def pairs_balanced(self, lineMatchOrBlockMatch):\n\n groups = lineMatchOrBlockMatch.groupdict()\n\n if 'assignment' in groups or 'bracket' in groups:\n squareOpenCount = self.expression.count('[')\n squareOpenCount -= self.expression.count(']')\n\n curlyOpenCount = self.expression.count('{')\n curlyOpenCount -= self.expression.count('}')\n\n parenOpenCount = self.expression.count('(')\n parenOpenCount -= self.expression.count(')')\n\n if squareOpenCount or curlyOpenCount or parenOpenCount:\n # If the brackets were not properly closed or the statement was\n # missing a separator, skip the rest of the var block.\n if not self.balance_pairs(squareOpenCount, curlyOpenCount, parenOpenCount):\n return False\n\n return True\n\n def var_block(self, blockMatch):\n \"\"\"\n Parse a var block, return a tuple (haveLine, isSingleVar), where haveLine\n indicates whether self.line is the next line to be parsed.\n \"\"\"\n\n # Keep track of whether this var block has multiple declarations\n isSingleVar = True\n\n # Keep track of the indent of the var keyword to compare with following lines\n self.varIndent = blockMatch.group('indent')\n\n # Keep track of how far the first variable name is indented to make sure\n # following lines line up with that\n self.identifierIndent = self.varIndent + blockMatch.group('var')\n\n # Check the expression to see if we have any open [ or { or /*\n self.get_expression(blockMatch)\n\n if not self.pairs_balanced(blockMatch):\n return (False, False)\n\n separator = ''\n\n if self.expression:\n match = self.SEPARATOR_RE.match(self.expression)\n\n if not match:\n self.error('missing statement separator', type=self.ERROR_TYPE_ILLEGAL)\n else:\n separator = match.group('separator')\n elif blockMatch.group('separator'):\n separator = blockMatch.group('separator')\n\n # If the block has a semicolon, there should be no more lines in the block\n blockHasSemicolon = separator == ';'\n\n # We may not catch an error till after the line that is wrong, so keep\n # the most recent declaration and its line number.\n lastBlockLine = self.line\n lastBlockLineNum = self.lineNum\n\n # Now construct an RE that will match any lines indented at least as much\n # as the var keyword that started the block.\n blockRE = re.compile(self.VAR_BLOCK_RE_TEMPLATE % len(self.identifierIndent))\n\n while self.next_statement(expect_line=not blockHasSemicolon):\n\n if not self.is_statement():\n continue\n\n # Is the line indented at least as much as the var keyword that started the block?\n match = blockRE.match(self.line)\n\n if match:\n if self.is_expression():\n lastBlockLine = self.line\n lastBlockLineNum = self.lineNum\n\n # If the line is indented farther than the first identifier in the block,\n # it is considered a formatting error.\n if match.group('indent') and not match.group('indented_expression'):\n self.error('incorrect indentation')\n\n self.get_expression(match)\n\n if not self.pairs_balanced(match):\n return (False, isSingleVar)\n\n if self.expression:\n separatorMatch = self.SEPARATOR_RE.match(self.expression)\n\n if separatorMatch is None:\n # If the assignment does not have a separator, it's an error\n self.error('missing statement separator', type=self.ERROR_TYPE_ILLEGAL)\n else:\n separator = separatorMatch.group('separator')\n\n if blockHasSemicolon:\n # If the block already has a semicolon, we have an accidental global declaration\n self.error('accidental global variable', type=self.ERROR_TYPE_ILLEGAL)\n elif (separator == ';'):\n blockHasSemicolon = True\n elif match.group('separator'):\n separator = match.group('separator')\n\n isSingleVar = False\n else:\n # If the line is a control statement of some kind, then it should not be indented this far.\n self.error('statement should be outdented from preceding var block')\n return (True, False)\n\n else:\n # If the line does not match, it is not an assignment or is outdented from the block.\n # In either case, the block is considered closed. If the most recent separator was not ';',\n # the block was not properly terminated.\n if separator != ';':\n self.error('unterminated var block', lineNum=lastBlockLineNum, line=lastBlockLine, type=self.ERROR_TYPE_ILLEGAL)\n\n return (True, isSingleVar)\n\n def check_var_blocks(self):\n lastStatementWasVar = False\n lastVarWasSingle = False\n haveLine = True\n\n while True:\n if not haveLine:\n haveLine = self.next_statement()\n\n if not self.is_statement():\n haveLine = False\n continue\n\n match = self.VAR_BLOCK_START_RE.match(self.line)\n\n if match is None:\n lastStatementWasVar = False\n haveLine = False\n continue\n\n # It might be a function definition, in which case we continue\n expression = match.group('expression')\n\n if expression:\n functionMatch = self.FUNCTION_RE.match(expression)\n\n if functionMatch:\n lastStatementWasVar = False\n haveLine = False\n continue\n\n # Now we have the start of a variable block\n if self.verbose:\n print u'%d: VAR BLOCK' % self.lineNum\n\n varLineNum = self.lineNum\n varLine = self.line\n\n haveLine, isSingleVar = self.var_block(match)\n\n if self.verbose:\n print u'%d: END VAR BLOCK:' % self.lineNum,\n\n if isSingleVar:\n print u'SINGLE'\n else:\n print u'MULTIPLE'\n\n if lastStatementWasVar and self.varDeclarations != self.VAR_DECLARATIONS_NONE:\n if (self.varDeclarations == self.VAR_DECLARATIONS_SINGLE and lastVarWasSingle and isSingleVar) or \\\n (self.varDeclarations == self.VAR_DECLARATIONS_STRICT and (lastVarWasSingle or isSingleVar)):\n self.error('consecutive var declarations', lineNum=varLineNum, line=varLine)\n\n lastStatementWasVar = True\n lastVarWasSingle = isSingleVar\n\n def run_file_checks(self):\n for check in self.fileChecklist:\n self.sourcefile.seek(0)\n self.lineNum = 0\n\n if self.verbose:\n print u'%s: %s' % (check['title'], self.sourcefile.name)\n\n check['action']()\n\n def lint(self, filesToCheck):\n # Recursively walk any directories and eliminate duplicates\n self.filesToCheck = []\n\n for filename in filesToCheck:\n filename = unicode(filename, 'utf-8')\n fullpath = os.path.join(self.basedir, filename)\n\n if fullpath not in self.filesToCheck:\n if os.path.isdir(fullpath):\n for root, dirs, files in os.walk(fullpath):\n for skipDir in self.DIRS_TO_SKIP:\n if skipDir in dirs:\n dirs.remove(skipDir)\n\n for filename in files:\n if not filename.endswith('.j'):\n continue\n\n fullpath = os.path.join(root, filename)\n\n if fullpath not in self.filesToCheck:\n self.filesToCheck.append(fullpath)\n else:\n self.filesToCheck.append(fullpath)\n\n for filename in self.filesToCheck:\n try:\n with open(filename) as self.sourcefile:\n self.filename = relative_path(self.basedir, filename)\n self.run_file_checks()\n\n except IOError:\n self.lineNum = 0\n self.line = None\n self.error('file not found', type=self.ERROR_TYPE_ILLEGAL)\n\n except StopIteration:\n if self.verbose:\n print u'EOF\\n'\n pass\n\n def lint_text(self, text, filename=\"\"):\n self.filename = filename\n self.filesToCheck = []\n\n try:\n self.sourcefile = cStringIO.StringIO(text)\n self.run_file_checks()\n except StopIteration:\n if self.verbose:\n print u'EOF\\n'\n pass\n\n return self.errors\n\n def count_files_checked(self):\n return len(self.filesToCheck)\n\n def error(self, message, **kwargs):\n info = {\n 'filename': self.filename,\n 'message': message,\n 'type': kwargs.get('type', self.ERROR_TYPE_WARNING)\n }\n\n line = kwargs.get('line', self.line)\n lineNum = kwargs.get('lineNum', self.lineNum)\n\n if line and lineNum:\n info['line'] = tabs2spaces(line)\n info['lineNum'] = lineNum\n\n positions = kwargs.get('positions')\n\n if positions:\n info['positions'] = positions\n\n self.errors.append(info)\n\n if self.filename not in self.errorFiles:\n self.errorFiles.append(self.filename)\n\n def has_errors(self):\n return len(self.errors) != 0\n\n def print_errors(self, format='text'):\n if not self.errors:\n return\n\n if format == 'text':\n self.print_text_errors()\n elif format == 'html':\n self.print_textmate_html_errors()\n elif format == 'tooltip':\n self.print_tooltip_errors()\n\n def print_text_errors(self):\n sys.stdout.write('%d error' % len(self.errors))\n\n if len(self.errors) > 1:\n sys.stdout.write('s')\n\n if len(self.filesToCheck) == 1:\n template = self.TEXT_ERROR_SINGLE_FILE_TEMPLATE\n else:\n sys.stdout.write(' in %d files' % len(self.errorFiles))\n template = self.TEXT_ERROR_MULTI_FILE_TEMPLATE\n\n sys.stdout.write(':\\n\\n')\n\n for error in self.errors:\n if 'lineNum' in error and 'line' in error:\n sys.stdout.write(template.substitute(error).encode('utf-8'))\n\n if error.get('positions'):\n markers = ' ' * len(error['line'])\n\n for position in error['positions']:\n markers = markers[:position] + '^' + markers[position + 1:]\n\n # Add a space at the beginning of the markers to account for the '+' at the beginning\n # of the source line.\n sys.stdout.write(' %s\\n' % markers)\n else:\n sys.stdout.write('%s: %s.\\n' % (error['filename'], error['message']))\n\n sys.stdout.write('\\n')\n\n def print_textmate_html_errors(self):\n html = \"\"\"\n\n \n Cappuccino Lint Report\n \n \n \n \"\"\"\n\n html += '

Results: %d error' % len(self.errors)\n\n if len(self.errors) > 1:\n html += 's'\n\n if len(self.filesToCheck) > 1:\n html += ' in %d files' % len(self.errorFiles)\n\n html += '

'\n\n for error in self.errors:\n message = cgi.escape(error['message'])\n\n if len(self.filesToCheck) > 1:\n filename = cgi.escape(error['filename']) + ':'\n else:\n filename = ''\n\n html += '

'\n\n if 'line' in error and 'lineNum' in error:\n filepath = cgi.escape(os.path.join(self.basedir, error['filename']))\n lineNum = error['lineNum']\n line = error['line']\n positions = error.get('positions')\n firstPos = -1\n source = ''\n\n if positions:\n firstPos = positions[0] + 1\n lastPos = 0\n\n for pos in error.get('positions'):\n if pos < len(line):\n charToHighlight = line[pos]\n else:\n charToHighlight = ''\n\n source += '%s%s' % (cgi.escape(line[lastPos:pos]), cgi.escape(charToHighlight))\n lastPos = pos + 1\n\n if lastPos <= len(line):\n source += cgi.escape(line[lastPos:])\n else:\n source = line\n\n link = '' % (filepath, lineNum, firstPos)\n\n if len(self.filesToCheck) > 1:\n errorMsg = '%s%d: %s' % (filename, lineNum, message)\n else:\n errorMsg = '%d: %s' % (lineNum, message)\n\n html += '%(link)s%(errorMsg)s

\\n

%(link)s%(source)s

\\n' % {'link': link, 'errorMsg': errorMsg, 'source': source}\n else:\n html += '%s%s

\\n' % (filename, message)\n\n html += \"\"\"\n \n\n\"\"\"\n exit_show_html(html)\n\n\nclass MiscTest(unittest.TestCase):\n def test_string_replacer(self):\n self.assertEquals(string_replacer(\"x = 'hello';\"), \"x = '';\")\n self.assertEquals(string_replacer(\"x = '\\\\' hello';\"), \"x = '';\")\n self.assertEquals(string_replacer(\"x = '\\\\\\\\';\"), \"x = '';\")\n self.assertEquals(string_replacer(\"\"\"x = '\"string in string\"';\"\"\"), \"x = '';\")\n\n self.assertEquals(string_replacer('x = \"hello\";'), 'x = \"\";')\n self.assertEquals(string_replacer('x = \"\\\\\" hello\";'), 'x = \"\";')\n self.assertEquals(string_replacer('x = \"\\\\\\\\\";'), 'x = \"\";')\n self.assertEquals(string_replacer('''x = \"'\";'''), 'x = \"\";')\n\n\nclass LintCheckerTest(unittest.TestCase):\n def test_exponential_notation(self):\n \"\"\"Test that exponential notation such as 1.1e-6 doesn't cause a warning about missing whitespace.\"\"\"\n\n # This should not report \"binary operator without surrounding spaces\".\n self.assertEquals(LintChecker().lint_text(\"a = 2.1e-6;\"), [])\n self.assertEquals(LintChecker().lint_text(\"a = 2.1e+6;\"), [])\n self.assertEquals(LintChecker().lint_text(\"a = 2e-0;\"), [])\n self.assertEquals(LintChecker().lint_text(\"a = 2e+0;\"), [])\n\n # But this should.\n self.assertEquals(LintChecker().lint_text(\"a = 1.1e-6+2e2;\"), [{'positions': [6], 'filename': '', 'lineNum': 1, 'message': 'binary operator without surrounding spaces', 'type': 2, 'line': u'a = 1.1e-6+2e2;'}])\n\n def test_function_types(self):\n \"\"\"Test that function definitions like function(/*CPString*/key) don't cause warnings about surrounding spaces.\"\"\"\n\n # This should not report \"binary operator without surrounding spaces\".\n self.assertEquals(LintChecker().lint_text(\"var resolveMultipleValues = function(/*CPString*/key, /*CPDictionary*/bindings, /*GSBindingOperationKind*/operation)\"), [])\n\n def test_unary_plus(self):\n \"\"\"Test that = +, like in `x = +y;`, doesn't cause a warning.\"\"\"\n\n # + converts number in a string to a number.\n self.assertEquals(LintChecker().lint_text(\"var y = +x;\"), [])\n\n def test_string_escaping(self):\n \"\"\"Test that string literals are not parsed as syntax, even when they end with a double backslash.\"\"\"\n\n self.assertEquals(LintChecker().lint_text('var x = \"(\\\\\\\\\";'), [])\n\n\nif __name__ == '__main__':\n usage = 'usage: %prog [options] [file ... | -]'\n parser = OptionParser(usage=usage, version='1.02')\n parser.add_option('-f', '--format', action='store', type='string', dest='format', default='text', help='the format to use for the report: text (default) or html (HTML in which errors can be clicked on to view in TextMate)')\n parser.add_option('-b', '--basedir', action='store', type='string', dest='basedir', help='the base directory relative to which filenames are resolved, defaults to the current working directory')\n parser.add_option('-d', '--var-declarations', action='store', type='string', dest='var_declarations', default='single', help='set the policy for flagging consecutive var declarations (%s)' % ', '.join(LintChecker.VAR_DECLARATIONS))\n parser.add_option('-v', '--verbose', action='store_true', dest='verbose', default=False, help='show what lint is doing')\n parser.add_option('-q', '--quiet', action='store_true', dest='quiet', default=False, help='do not display errors, only return an exit code')\n\n (options, args) = parser.parse_args()\n\n if options.var_declarations not in LintChecker.VAR_DECLARATIONS:\n parser.error('--var-declarations must be one of [' + ', '.join(LintChecker.VAR_DECLARATIONS) + ']')\n\n if options.verbose and options.quiet:\n parser.error('options -v/--verbose and -q/--quiet are mutually exclusive')\n\n options.format = options.format.lower()\n\n if not options.format in LintChecker.ERROR_FORMATS:\n parser.error('format must be one of ' + '/'.join(LintChecker.ERROR_FORMATS))\n\n if options.format == 'html' and not within_textmate():\n parser.error('html format can only be used within TextMate.')\n\n if options.basedir:\n basedir = options.basedir\n\n if basedir[-1] == '/':\n basedir = basedir[:-1]\n else:\n basedir = os.getcwd()\n\n # We accept a list of filenames (relative to the cwd) either from the command line or from stdin\n filenames = args\n\n if args and args[0] == '-':\n filenames = [name.rstrip() for name in sys.stdin.readlines()]\n\n if not filenames:\n print usage.replace('%prog', os.path.basename(sys.argv[0]))\n sys.exit(0)\n\n checker = LintChecker(basedir=basedir, view=None, var_declarations=LintChecker.VAR_DECLARATIONS.index(options.var_declarations), verbose=options.verbose)\n pathsToCheck = []\n\n for filename in filenames:\n filename = filename.strip('\"\\'')\n path = os.path.join(basedir, filename)\n\n if (os.path.isdir(path) and not path.endswith('Frameworks')) or filename.endswith('.j'):\n pathsToCheck.append(relative_path(basedir, filename))\n\n if len(pathsToCheck) == 0:\n if within_textmate():\n exit_show_tooltip('No Objective-J files found.')\n\n sys.exit(0)\n\n checker.lint(pathsToCheck)\n\n if checker.has_errors():\n if not options.quiet:\n checker.print_errors(options.format)\n\n sys.exit(1)\n else:\n if within_textmate():\n exit_show_tooltip('Everything looks clean.')\n\n sys.exit(0)\n" }, { "path": "sublimelinter/modules/libs/csslint/csslint-node.js", "content": "/*!\nCSSLint\nCopyright (c) 2011 Nicole Sullivan and Nicholas C. Zakas. All rights reserved.\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in\nall copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\nTHE SOFTWARE.\n\n*/\n/* Build time: 17-January-2013 10:55:01 */\n/*!\nParser-Lib\nCopyright (c) 2009-2011 Nicholas C. Zakas. All rights reserved.\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in\nall copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\nTHE SOFTWARE.\n\n*/\n/* Version v0.2.2, Build time: 17-January-2013 10:26:34 */\nvar parserlib = {};\n(function(){\n\n\n/**\n * A generic base to inherit from for any object\n * that needs event handling.\n * @class EventTarget\n * @constructor\n */\nfunction EventTarget(){\n\n /**\n * The array of listeners for various events.\n * @type Object\n * @property _listeners\n * @private\n */\n this._listeners = {};\n}\n\nEventTarget.prototype = {\n\n //restore constructor\n constructor: EventTarget,\n\n /**\n * Adds a listener for a given event type.\n * @param {String} type The type of event to add a listener for.\n * @param {Function} listener The function to call when the event occurs.\n * @return {void}\n * @method addListener\n */\n addListener: function(type, listener){\n if (!this._listeners[type]){\n this._listeners[type] = [];\n }\n\n this._listeners[type].push(listener);\n },\n\n /**\n * Fires an event based on the passed-in object.\n * @param {Object|String} event An object with at least a 'type' attribute\n * or a string indicating the event name.\n * @return {void}\n * @method fire\n */\n fire: function(event){\n if (typeof event == \"string\"){\n event = { type: event };\n }\n if (typeof event.target != \"undefined\"){\n event.target = this;\n }\n\n if (typeof event.type == \"undefined\"){\n throw new Error(\"Event object missing 'type' property.\");\n }\n\n if (this._listeners[event.type]){\n\n //create a copy of the array and use that so listeners can't chane\n var listeners = this._listeners[event.type].concat();\n for (var i=0, len=listeners.length; i < len; i++){\n listeners[i].call(this, event);\n }\n }\n },\n\n /**\n * Removes a listener for a given event type.\n * @param {String} type The type of event to remove a listener from.\n * @param {Function} listener The function to remove from the event.\n * @return {void}\n * @method removeListener\n */\n removeListener: function(type, listener){\n if (this._listeners[type]){\n var listeners = this._listeners[type];\n for (var i=0, len=listeners.length; i < len; i++){\n if (listeners[i] === listener){\n listeners.splice(i, 1);\n break;\n }\n }\n\n\n }\n }\n};\n/**\n * Convenient way to read through strings.\n * @namespace parserlib.util\n * @class StringReader\n * @constructor\n * @param {String} text The text to read.\n */\nfunction StringReader(text){\n\n /**\n * The input text with line endings normalized.\n * @property _input\n * @type String\n * @private\n */\n this._input = text.replace(/\\n\\r?/g, \"\\n\");\n\n\n /**\n * The row for the character to be read next.\n * @property _line\n * @type int\n * @private\n */\n this._line = 1;\n\n\n /**\n * The column for the character to be read next.\n * @property _col\n * @type int\n * @private\n */\n this._col = 1;\n\n /**\n * The index of the character in the input to be read next.\n * @property _cursor\n * @type int\n * @private\n */\n this._cursor = 0;\n}\n\nStringReader.prototype = {\n\n //restore constructor\n constructor: StringReader,\n\n //-------------------------------------------------------------------------\n // Position info\n //-------------------------------------------------------------------------\n\n /**\n * Returns the column of the character to be read next.\n * @return {int} The column of the character to be read next.\n * @method getCol\n */\n getCol: function(){\n return this._col;\n },\n\n /**\n * Returns the row of the character to be read next.\n * @return {int} The row of the character to be read next.\n * @method getLine\n */\n getLine: function(){\n return this._line ;\n },\n\n /**\n * Determines if you're at the end of the input.\n * @return {Boolean} True if there's no more input, false otherwise.\n * @method eof\n */\n eof: function(){\n return (this._cursor == this._input.length);\n },\n\n //-------------------------------------------------------------------------\n // Basic reading\n //-------------------------------------------------------------------------\n\n /**\n * Reads the next character without advancing the cursor.\n * @param {int} count How many characters to look ahead (default is 1).\n * @return {String} The next character or null if there is no next character.\n * @method peek\n */\n peek: function(count){\n var c = null;\n count = (typeof count == \"undefined\" ? 1 : count);\n\n //if we're not at the end of the input...\n if (this._cursor < this._input.length){\n\n //get character and increment cursor and column\n c = this._input.charAt(this._cursor + count - 1);\n }\n\n return c;\n },\n\n /**\n * Reads the next character from the input and adjusts the row and column\n * accordingly.\n * @return {String} The next character or null if there is no next character.\n * @method read\n */\n read: function(){\n var c = null;\n\n //if we're not at the end of the input...\n if (this._cursor < this._input.length){\n\n //if the last character was a newline, increment row count\n //and reset column count\n if (this._input.charAt(this._cursor) == \"\\n\"){\n this._line++;\n this._col=1;\n } else {\n this._col++;\n }\n\n //get character and increment cursor and column\n c = this._input.charAt(this._cursor++);\n }\n\n return c;\n },\n\n //-------------------------------------------------------------------------\n // Misc\n //-------------------------------------------------------------------------\n\n /**\n * Saves the current location so it can be returned to later.\n * @method mark\n * @return {void}\n */\n mark: function(){\n this._bookmark = {\n cursor: this._cursor,\n line: this._line,\n col: this._col\n };\n },\n\n reset: function(){\n if (this._bookmark){\n this._cursor = this._bookmark.cursor;\n this._line = this._bookmark.line;\n this._col = this._bookmark.col;\n delete this._bookmark;\n }\n },\n\n //-------------------------------------------------------------------------\n // Advanced reading\n //-------------------------------------------------------------------------\n\n /**\n * Reads up to and including the given string. Throws an error if that\n * string is not found.\n * @param {String} pattern The string to read.\n * @return {String} The string when it is found.\n * @throws Error when the string pattern is not found.\n * @method readTo\n */\n readTo: function(pattern){\n\n var buffer = \"\",\n c;\n\n /*\n * First, buffer must be the same length as the pattern.\n * Then, buffer must end with the pattern or else reach the\n * end of the input.\n */\n while (buffer.length < pattern.length || buffer.lastIndexOf(pattern) != buffer.length - pattern.length){\n c = this.read();\n if (c){\n buffer += c;\n } else {\n throw new Error(\"Expected \\\"\" + pattern + \"\\\" at line \" + this._line + \", col \" + this._col + \".\");\n }\n }\n\n return buffer;\n\n },\n\n /**\n * Reads characters while each character causes the given\n * filter function to return true. The function is passed\n * in each character and either returns true to continue\n * reading or false to stop.\n * @param {Function} filter The function to read on each character.\n * @return {String} The string made up of all characters that passed the\n * filter check.\n * @method readWhile\n */\n readWhile: function(filter){\n\n var buffer = \"\",\n c = this.read();\n\n while(c !== null && filter(c)){\n buffer += c;\n c = this.read();\n }\n\n return buffer;\n\n },\n\n /**\n * Reads characters that match either text or a regular expression and\n * returns those characters. If a match is found, the row and column\n * are adjusted; if no match is found, the reader's state is unchanged.\n * reading or false to stop.\n * @param {String|RegExp} matchter If a string, then the literal string\n * value is searched for. If a regular expression, then any string\n * matching the pattern is search for.\n * @return {String} The string made up of all characters that matched or\n * null if there was no match.\n * @method readMatch\n */\n readMatch: function(matcher){\n\n var source = this._input.substring(this._cursor),\n value = null;\n\n //if it's a string, just do a straight match\n if (typeof matcher == \"string\"){\n if (source.indexOf(matcher) === 0){\n value = this.readCount(matcher.length);\n }\n } else if (matcher instanceof RegExp){\n if (matcher.test(source)){\n value = this.readCount(RegExp.lastMatch.length);\n }\n }\n\n return value;\n },\n\n\n /**\n * Reads a given number of characters. If the end of the input is reached,\n * it reads only the remaining characters and does not throw an error.\n * @param {int} count The number of characters to read.\n * @return {String} The string made up the read characters.\n * @method readCount\n */\n readCount: function(count){\n var buffer = \"\";\n\n while(count--){\n buffer += this.read();\n }\n\n return buffer;\n }\n\n};\n/**\n * Type to use when a syntax error occurs.\n * @class SyntaxError\n * @namespace parserlib.util\n * @constructor\n * @param {String} message The error message.\n * @param {int} line The line at which the error occurred.\n * @param {int} col The column at which the error occurred.\n */\nfunction SyntaxError(message, line, col){\n\n /**\n * The column at which the error occurred.\n * @type int\n * @property col\n */\n this.col = col;\n\n /**\n * The line at which the error occurred.\n * @type int\n * @property line\n */\n this.line = line;\n\n /**\n * The text representation of the unit.\n * @type String\n * @property text\n */\n this.message = message;\n\n}\n\n//inherit from Error\nSyntaxError.prototype = new Error();\n/**\n * Base type to represent a single syntactic unit.\n * @class SyntaxUnit\n * @namespace parserlib.util\n * @constructor\n * @param {String} text The text of the unit.\n * @param {int} line The line of text on which the unit resides.\n * @param {int} col The column of text on which the unit resides.\n */\nfunction SyntaxUnit(text, line, col, type){\n\n\n /**\n * The column of text on which the unit resides.\n * @type int\n * @property col\n */\n this.col = col;\n\n /**\n * The line of text on which the unit resides.\n * @type int\n * @property line\n */\n this.line = line;\n\n /**\n * The text representation of the unit.\n * @type String\n * @property text\n */\n this.text = text;\n\n /**\n * The type of syntax unit.\n * @type int\n * @property type\n */\n this.type = type;\n}\n\n/**\n * Create a new syntax unit based solely on the given token.\n * Convenience method for creating a new syntax unit when\n * it represents a single token instead of multiple.\n * @param {Object} token The token object to represent.\n * @return {parserlib.util.SyntaxUnit} The object representing the token.\n * @static\n * @method fromToken\n */\nSyntaxUnit.fromToken = function(token){\n return new SyntaxUnit(token.value, token.startLine, token.startCol);\n};\n\nSyntaxUnit.prototype = {\n\n //restore constructor\n constructor: SyntaxUnit,\n\n /**\n * Returns the text representation of the unit.\n * @return {String} The text representation of the unit.\n * @method valueOf\n */\n valueOf: function(){\n return this.toString();\n },\n\n /**\n * Returns the text representation of the unit.\n * @return {String} The text representation of the unit.\n * @method toString\n */\n toString: function(){\n return this.text;\n }\n\n};\n/*global StringReader, SyntaxError*/\n\n/**\n * Generic TokenStream providing base functionality.\n * @class TokenStreamBase\n * @namespace parserlib.util\n * @constructor\n * @param {String|StringReader} input The text to tokenize or a reader from\n * which to read the input.\n */\nfunction TokenStreamBase(input, tokenData){\n\n /**\n * The string reader for easy access to the text.\n * @type StringReader\n * @property _reader\n * @private\n */\n this._reader = input ? new StringReader(input.toString()) : null;\n\n /**\n * Token object for the last consumed token.\n * @type Token\n * @property _token\n * @private\n */\n this._token = null;\n\n /**\n * The array of token information.\n * @type Array\n * @property _tokenData\n * @private\n */\n this._tokenData = tokenData;\n\n /**\n * Lookahead token buffer.\n * @type Array\n * @property _lt\n * @private\n */\n this._lt = [];\n\n /**\n * Lookahead token buffer index.\n * @type int\n * @property _ltIndex\n * @private\n */\n this._ltIndex = 0;\n\n this._ltIndexCache = [];\n}\n\n/**\n * Accepts an array of token information and outputs\n * an array of token data containing key-value mappings\n * and matching functions that the TokenStream needs.\n * @param {Array} tokens An array of token descriptors.\n * @return {Array} An array of processed token data.\n * @method createTokenData\n * @static\n */\nTokenStreamBase.createTokenData = function(tokens){\n\n var nameMap = [],\n typeMap = {},\n tokenData = tokens.concat([]),\n i = 0,\n len = tokenData.length+1;\n\n tokenData.UNKNOWN = -1;\n tokenData.unshift({name:\"EOF\"});\n\n for (; i < len; i++){\n nameMap.push(tokenData[i].name);\n tokenData[tokenData[i].name] = i;\n if (tokenData[i].text){\n typeMap[tokenData[i].text] = i;\n }\n }\n\n tokenData.name = function(tt){\n return nameMap[tt];\n };\n\n tokenData.type = function(c){\n return typeMap[c];\n };\n\n return tokenData;\n};\n\nTokenStreamBase.prototype = {\n\n //restore constructor\n constructor: TokenStreamBase,\n\n //-------------------------------------------------------------------------\n // Matching methods\n //-------------------------------------------------------------------------\n\n /**\n * Determines if the next token matches the given token type.\n * If so, that token is consumed; if not, the token is placed\n * back onto the token stream. You can pass in any number of\n * token types and this will return true if any of the token\n * types is found.\n * @param {int|int[]} tokenTypes Either a single token type or an array of\n * token types that the next token might be. If an array is passed,\n * it's assumed that the token can be any of these.\n * @param {variant} channel (Optional) The channel to read from. If not\n * provided, reads from the default (unnamed) channel.\n * @return {Boolean} True if the token type matches, false if not.\n * @method match\n */\n match: function(tokenTypes, channel){\n\n //always convert to an array, makes things easier\n if (!(tokenTypes instanceof Array)){\n tokenTypes = [tokenTypes];\n }\n\n var tt = this.get(channel),\n i = 0,\n len = tokenTypes.length;\n\n while(i < len){\n if (tt == tokenTypes[i++]){\n return true;\n }\n }\n\n //no match found, put the token back\n this.unget();\n return false;\n },\n\n /**\n * Determines if the next token matches the given token type.\n * If so, that token is consumed; if not, an error is thrown.\n * @param {int|int[]} tokenTypes Either a single token type or an array of\n * token types that the next token should be. If an array is passed,\n * it's assumed that the token must be one of these.\n * @param {variant} channel (Optional) The channel to read from. If not\n * provided, reads from the default (unnamed) channel.\n * @return {void}\n * @method mustMatch\n */\n mustMatch: function(tokenTypes, channel){\n\n var token;\n\n //always convert to an array, makes things easier\n if (!(tokenTypes instanceof Array)){\n tokenTypes = [tokenTypes];\n }\n\n if (!this.match.apply(this, arguments)){\n token = this.LT(1);\n throw new SyntaxError(\"Expected \" + this._tokenData[tokenTypes[0]].name +\n \" at line \" + token.startLine + \", col \" + token.startCol + \".\", token.startLine, token.startCol);\n }\n },\n\n //-------------------------------------------------------------------------\n // Consuming methods\n //-------------------------------------------------------------------------\n\n /**\n * Keeps reading from the token stream until either one of the specified\n * token types is found or until the end of the input is reached.\n * @param {int|int[]} tokenTypes Either a single token type or an array of\n * token types that the next token should be. If an array is passed,\n * it's assumed that the token must be one of these.\n * @param {variant} channel (Optional) The channel to read from. If not\n * provided, reads from the default (unnamed) channel.\n * @return {void}\n * @method advance\n */\n advance: function(tokenTypes, channel){\n\n while(this.LA(0) !== 0 && !this.match(tokenTypes, channel)){\n this.get();\n }\n\n return this.LA(0);\n },\n\n /**\n * Consumes the next token from the token stream.\n * @return {int} The token type of the token that was just consumed.\n * @method get\n */\n get: function(channel){\n\n var tokenInfo = this._tokenData,\n reader = this._reader,\n value,\n i =0,\n len = tokenInfo.length,\n found = false,\n token,\n info;\n\n //check the lookahead buffer first\n if (this._lt.length && this._ltIndex >= 0 && this._ltIndex < this._lt.length){\n\n i++;\n this._token = this._lt[this._ltIndex++];\n info = tokenInfo[this._token.type];\n\n //obey channels logic\n while((info.channel !== undefined && channel !== info.channel) &&\n this._ltIndex < this._lt.length){\n this._token = this._lt[this._ltIndex++];\n info = tokenInfo[this._token.type];\n i++;\n }\n\n //here be dragons\n if ((info.channel === undefined || channel === info.channel) &&\n this._ltIndex <= this._lt.length){\n this._ltIndexCache.push(i);\n return this._token.type;\n }\n }\n\n //call token retriever method\n token = this._getToken();\n\n //if it should be hidden, don't save a token\n if (token.type > -1 && !tokenInfo[token.type].hide){\n\n //apply token channel\n token.channel = tokenInfo[token.type].channel;\n\n //save for later\n this._token = token;\n this._lt.push(token);\n\n //save space that will be moved (must be done before array is truncated)\n this._ltIndexCache.push(this._lt.length - this._ltIndex + i);\n\n //keep the buffer under 5 items\n if (this._lt.length > 5){\n this._lt.shift();\n }\n\n //also keep the shift buffer under 5 items\n if (this._ltIndexCache.length > 5){\n this._ltIndexCache.shift();\n }\n\n //update lookahead index\n this._ltIndex = this._lt.length;\n }\n\n /*\n * Skip to the next token if:\n * 1. The token type is marked as hidden.\n * 2. The token type has a channel specified and it isn't the current channel.\n */\n info = tokenInfo[token.type];\n if (info &&\n (info.hide ||\n (info.channel !== undefined && channel !== info.channel))){\n return this.get(channel);\n } else {\n //return just the type\n return token.type;\n }\n },\n\n /**\n * Looks ahead a certain number of tokens and returns the token type at\n * that position. This will throw an error if you lookahead past the\n * end of input, past the size of the lookahead buffer, or back past\n * the first token in the lookahead buffer.\n * @param {int} The index of the token type to retrieve. 0 for the\n * current token, 1 for the next, -1 for the previous, etc.\n * @return {int} The token type of the token in the given position.\n * @method LA\n */\n LA: function(index){\n var total = index,\n tt;\n if (index > 0){\n //TODO: Store 5 somewhere\n if (index > 5){\n throw new Error(\"Too much lookahead.\");\n }\n\n //get all those tokens\n while(total){\n tt = this.get();\n total--;\n }\n\n //unget all those tokens\n while(total < index){\n this.unget();\n total++;\n }\n } else if (index < 0){\n\n if(this._lt[this._ltIndex+index]){\n tt = this._lt[this._ltIndex+index].type;\n } else {\n throw new Error(\"Too much lookbehind.\");\n }\n\n } else {\n tt = this._token.type;\n }\n\n return tt;\n\n },\n\n /**\n * Looks ahead a certain number of tokens and returns the token at\n * that position. This will throw an error if you lookahead past the\n * end of input, past the size of the lookahead buffer, or back past\n * the first token in the lookahead buffer.\n * @param {int} The index of the token type to retrieve. 0 for the\n * current token, 1 for the next, -1 for the previous, etc.\n * @return {Object} The token of the token in the given position.\n * @method LA\n */\n LT: function(index){\n\n //lookahead first to prime the token buffer\n this.LA(index);\n\n //now find the token, subtract one because _ltIndex is already at the next index\n return this._lt[this._ltIndex+index-1];\n },\n\n /**\n * Returns the token type for the next token in the stream without\n * consuming it.\n * @return {int} The token type of the next token in the stream.\n * @method peek\n */\n peek: function(){\n return this.LA(1);\n },\n\n /**\n * Returns the actual token object for the last consumed token.\n * @return {Token} The token object for the last consumed token.\n * @method token\n */\n token: function(){\n return this._token;\n },\n\n /**\n * Returns the name of the token for the given token type.\n * @param {int} tokenType The type of token to get the name of.\n * @return {String} The name of the token or \"UNKNOWN_TOKEN\" for any\n * invalid token type.\n * @method tokenName\n */\n tokenName: function(tokenType){\n if (tokenType < 0 || tokenType > this._tokenData.length){\n return \"UNKNOWN_TOKEN\";\n } else {\n return this._tokenData[tokenType].name;\n }\n },\n\n /**\n * Returns the token type value for the given token name.\n * @param {String} tokenName The name of the token whose value should be returned.\n * @return {int} The token type value for the given token name or -1\n * for an unknown token.\n * @method tokenName\n */\n tokenType: function(tokenName){\n return this._tokenData[tokenName] || -1;\n },\n\n /**\n * Returns the last consumed token to the token stream.\n * @method unget\n */\n unget: function(){\n //if (this._ltIndex > -1){\n if (this._ltIndexCache.length){\n this._ltIndex -= this._ltIndexCache.pop();//--;\n this._token = this._lt[this._ltIndex - 1];\n } else {\n throw new Error(\"Too much lookahead.\");\n }\n }\n\n};\n\n\n\n\nparserlib.util = {\nStringReader: StringReader,\nSyntaxError : SyntaxError,\nSyntaxUnit : SyntaxUnit,\nEventTarget : EventTarget,\nTokenStreamBase : TokenStreamBase\n};\n})();\n\n\n/*\nParser-Lib\nCopyright (c) 2009-2011 Nicholas C. Zakas. All rights reserved.\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in\nall copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\nTHE SOFTWARE.\n\n*/\n/* Version v0.2.2, Build time: 17-January-2013 10:26:34 */\n(function(){\nvar EventTarget = parserlib.util.EventTarget,\nTokenStreamBase = parserlib.util.TokenStreamBase,\nStringReader = parserlib.util.StringReader,\nSyntaxError = parserlib.util.SyntaxError,\nSyntaxUnit = parserlib.util.SyntaxUnit;\n\n\nvar Colors = {\n aliceblue :\"#f0f8ff\",\n antiquewhite :\"#faebd7\",\n aqua :\"#00ffff\",\n aquamarine :\"#7fffd4\",\n azure :\"#f0ffff\",\n beige :\"#f5f5dc\",\n bisque :\"#ffe4c4\",\n black :\"#000000\",\n blanchedalmond :\"#ffebcd\",\n blue :\"#0000ff\",\n blueviolet :\"#8a2be2\",\n brown :\"#a52a2a\",\n burlywood :\"#deb887\",\n cadetblue :\"#5f9ea0\",\n chartreuse :\"#7fff00\",\n chocolate :\"#d2691e\",\n coral :\"#ff7f50\",\n cornflowerblue :\"#6495ed\",\n cornsilk :\"#fff8dc\",\n crimson :\"#dc143c\",\n cyan :\"#00ffff\",\n darkblue :\"#00008b\",\n darkcyan :\"#008b8b\",\n darkgoldenrod :\"#b8860b\",\n darkgray :\"#a9a9a9\",\n darkgreen :\"#006400\",\n darkkhaki :\"#bdb76b\",\n darkmagenta :\"#8b008b\",\n darkolivegreen :\"#556b2f\",\n darkorange :\"#ff8c00\",\n darkorchid :\"#9932cc\",\n darkred :\"#8b0000\",\n darksalmon :\"#e9967a\",\n darkseagreen :\"#8fbc8f\",\n darkslateblue :\"#483d8b\",\n darkslategray :\"#2f4f4f\",\n darkturquoise :\"#00ced1\",\n darkviolet :\"#9400d3\",\n deeppink :\"#ff1493\",\n deepskyblue :\"#00bfff\",\n dimgray :\"#696969\",\n dodgerblue :\"#1e90ff\",\n firebrick :\"#b22222\",\n floralwhite :\"#fffaf0\",\n forestgreen :\"#228b22\",\n fuchsia :\"#ff00ff\",\n gainsboro :\"#dcdcdc\",\n ghostwhite :\"#f8f8ff\",\n gold :\"#ffd700\",\n goldenrod :\"#daa520\",\n gray :\"#808080\",\n green :\"#008000\",\n greenyellow :\"#adff2f\",\n honeydew :\"#f0fff0\",\n hotpink :\"#ff69b4\",\n indianred :\"#cd5c5c\",\n indigo :\"#4b0082\",\n ivory :\"#fffff0\",\n khaki :\"#f0e68c\",\n lavender :\"#e6e6fa\",\n lavenderblush :\"#fff0f5\",\n lawngreen :\"#7cfc00\",\n lemonchiffon :\"#fffacd\",\n lightblue :\"#add8e6\",\n lightcoral :\"#f08080\",\n lightcyan :\"#e0ffff\",\n lightgoldenrodyellow :\"#fafad2\",\n lightgray :\"#d3d3d3\",\n lightgreen :\"#90ee90\",\n lightpink :\"#ffb6c1\",\n lightsalmon :\"#ffa07a\",\n lightseagreen :\"#20b2aa\",\n lightskyblue :\"#87cefa\",\n lightslategray :\"#778899\",\n lightsteelblue :\"#b0c4de\",\n lightyellow :\"#ffffe0\",\n lime :\"#00ff00\",\n limegreen :\"#32cd32\",\n linen :\"#faf0e6\",\n magenta :\"#ff00ff\",\n maroon :\"#800000\",\n mediumaquamarine:\"#66cdaa\",\n mediumblue :\"#0000cd\",\n mediumorchid :\"#ba55d3\",\n mediumpurple :\"#9370d8\",\n mediumseagreen :\"#3cb371\",\n mediumslateblue :\"#7b68ee\",\n mediumspringgreen :\"#00fa9a\",\n mediumturquoise :\"#48d1cc\",\n mediumvioletred :\"#c71585\",\n midnightblue :\"#191970\",\n mintcream :\"#f5fffa\",\n mistyrose :\"#ffe4e1\",\n moccasin :\"#ffe4b5\",\n navajowhite :\"#ffdead\",\n navy :\"#000080\",\n oldlace :\"#fdf5e6\",\n olive :\"#808000\",\n olivedrab :\"#6b8e23\",\n orange :\"#ffa500\",\n orangered :\"#ff4500\",\n orchid :\"#da70d6\",\n palegoldenrod :\"#eee8aa\",\n palegreen :\"#98fb98\",\n paleturquoise :\"#afeeee\",\n palevioletred :\"#d87093\",\n papayawhip :\"#ffefd5\",\n peachpuff :\"#ffdab9\",\n peru :\"#cd853f\",\n pink :\"#ffc0cb\",\n plum :\"#dda0dd\",\n powderblue :\"#b0e0e6\",\n purple :\"#800080\",\n red :\"#ff0000\",\n rosybrown :\"#bc8f8f\",\n royalblue :\"#4169e1\",\n saddlebrown :\"#8b4513\",\n salmon :\"#fa8072\",\n sandybrown :\"#f4a460\",\n seagreen :\"#2e8b57\",\n seashell :\"#fff5ee\",\n sienna :\"#a0522d\",\n silver :\"#c0c0c0\",\n skyblue :\"#87ceeb\",\n slateblue :\"#6a5acd\",\n slategray :\"#708090\",\n snow :\"#fffafa\",\n springgreen :\"#00ff7f\",\n steelblue :\"#4682b4\",\n tan :\"#d2b48c\",\n teal :\"#008080\",\n thistle :\"#d8bfd8\",\n tomato :\"#ff6347\",\n turquoise :\"#40e0d0\",\n violet :\"#ee82ee\",\n wheat :\"#f5deb3\",\n white :\"#ffffff\",\n whitesmoke :\"#f5f5f5\",\n yellow :\"#ffff00\",\n yellowgreen :\"#9acd32\",\n //CSS2 system colors http://www.w3.org/TR/css3-color/#css2-system\n activeBorder :\"Active window border.\",\n activecaption :\"Active window caption.\",\n appworkspace :\"Background color of multiple document interface.\",\n background :\"Desktop background.\",\n buttonface :\"The face background color for 3-D elements that appear 3-D due to one layer of surrounding border.\",\n buttonhighlight :\"The color of the border facing the light source for 3-D elements that appear 3-D due to one layer of surrounding border.\",\n buttonshadow :\"The color of the border away from the light source for 3-D elements that appear 3-D due to one layer of surrounding border.\",\n buttontext :\"Text on push buttons.\",\n captiontext :\"Text in caption, size box, and scrollbar arrow box.\",\n graytext :\"Grayed (disabled) text. This color is set to #000 if the current display driver does not support a solid gray color.\",\n highlight :\"Item(s) selected in a control.\",\n highlighttext :\"Text of item(s) selected in a control.\",\n inactiveborder :\"Inactive window border.\",\n inactivecaption :\"Inactive window caption.\",\n inactivecaptiontext :\"Color of text in an inactive caption.\",\n infobackground :\"Background color for tooltip controls.\",\n infotext :\"Text color for tooltip controls.\",\n menu :\"Menu background.\",\n menutext :\"Text in menus.\",\n scrollbar :\"Scroll bar gray area.\",\n threeddarkshadow :\"The color of the darker (generally outer) of the two borders away from the light source for 3-D elements that appear 3-D due to two concentric layers of surrounding border.\",\n threedface :\"The face background color for 3-D elements that appear 3-D due to two concentric layers of surrounding border.\",\n threedhighlight :\"The color of the lighter (generally outer) of the two borders facing the light source for 3-D elements that appear 3-D due to two concentric layers of surrounding border.\",\n threedlightshadow :\"The color of the darker (generally inner) of the two borders facing the light source for 3-D elements that appear 3-D due to two concentric layers of surrounding border.\",\n threedshadow :\"The color of the lighter (generally inner) of the two borders away from the light source for 3-D elements that appear 3-D due to two concentric layers of surrounding border.\",\n window :\"Window background.\",\n windowframe :\"Window frame.\",\n windowtext :\"Text in windows.\"\n};\n/*global SyntaxUnit, Parser*/\n/**\n * Represents a selector combinator (whitespace, +, >).\n * @namespace parserlib.css\n * @class Combinator\n * @extends parserlib.util.SyntaxUnit\n * @constructor\n * @param {String} text The text representation of the unit.\n * @param {int} line The line of text on which the unit resides.\n * @param {int} col The column of text on which the unit resides.\n */\nfunction Combinator(text, line, col){\n\n SyntaxUnit.call(this, text, line, col, Parser.COMBINATOR_TYPE);\n\n /**\n * The type of modifier.\n * @type String\n * @property type\n */\n this.type = \"unknown\";\n\n //pretty simple\n if (/^\\s+$/.test(text)){\n this.type = \"descendant\";\n } else if (text == \">\"){\n this.type = \"child\";\n } else if (text == \"+\"){\n this.type = \"adjacent-sibling\";\n } else if (text == \"~\"){\n this.type = \"sibling\";\n }\n\n}\n\nCombinator.prototype = new SyntaxUnit();\nCombinator.prototype.constructor = Combinator;\n\n\n/*global SyntaxUnit, Parser*/\n/**\n * Represents a media feature, such as max-width:500.\n * @namespace parserlib.css\n * @class MediaFeature\n * @extends parserlib.util.SyntaxUnit\n * @constructor\n * @param {SyntaxUnit} name The name of the feature.\n * @param {SyntaxUnit} value The value of the feature or null if none.\n */\nfunction MediaFeature(name, value){\n\n SyntaxUnit.call(this, \"(\" + name + (value !== null ? \":\" + value : \"\") + \")\", name.startLine, name.startCol, Parser.MEDIA_FEATURE_TYPE);\n\n /**\n * The name of the media feature\n * @type String\n * @property name\n */\n this.name = name;\n\n /**\n * The value for the feature or null if there is none.\n * @type SyntaxUnit\n * @property value\n */\n this.value = value;\n}\n\nMediaFeature.prototype = new SyntaxUnit();\nMediaFeature.prototype.constructor = MediaFeature;\n\n\n/*global SyntaxUnit, Parser*/\n/**\n * Represents an individual media query.\n * @namespace parserlib.css\n * @class MediaQuery\n * @extends parserlib.util.SyntaxUnit\n * @constructor\n * @param {String} modifier The modifier \"not\" or \"only\" (or null).\n * @param {String} mediaType The type of media (i.e., \"print\").\n * @param {Array} parts Array of selectors parts making up this selector.\n * @param {int} line The line of text on which the unit resides.\n * @param {int} col The column of text on which the unit resides.\n */\nfunction MediaQuery(modifier, mediaType, features, line, col){\n\n SyntaxUnit.call(this, (modifier ? modifier + \" \": \"\") + (mediaType ? mediaType : \"\") + (mediaType && features.length > 0 ? \" and \" : \"\") + features.join(\" and \"), line, col, Parser.MEDIA_QUERY_TYPE);\n\n /**\n * The media modifier (\"not\" or \"only\")\n * @type String\n * @property modifier\n */\n this.modifier = modifier;\n\n /**\n * The mediaType (i.e., \"print\")\n * @type String\n * @property mediaType\n */\n this.mediaType = mediaType;\n\n /**\n * The parts that make up the selector.\n * @type Array\n * @property features\n */\n this.features = features;\n\n}\n\nMediaQuery.prototype = new SyntaxUnit();\nMediaQuery.prototype.constructor = MediaQuery;\n\n\n/*global Tokens, TokenStream, SyntaxError, Properties, Validation, ValidationError, SyntaxUnit,\n PropertyValue, PropertyValuePart, SelectorPart, SelectorSubPart, Selector,\n PropertyName, Combinator, MediaFeature, MediaQuery, EventTarget */\n\n/**\n * A CSS3 parser.\n * @namespace parserlib.css\n * @class Parser\n * @constructor\n * @param {Object} options (Optional) Various options for the parser:\n * starHack (true|false) to allow IE6 star hack as valid,\n * underscoreHack (true|false) to interpret leading underscores\n * as IE6-7 targeting for known properties, ieFilters (true|false)\n * to indicate that IE < 8 filters should be accepted and not throw\n * syntax errors.\n */\nfunction Parser(options){\n\n //inherit event functionality\n EventTarget.call(this);\n\n\n this.options = options || {};\n\n this._tokenStream = null;\n}\n\n//Static constants\nParser.DEFAULT_TYPE = 0;\nParser.COMBINATOR_TYPE = 1;\nParser.MEDIA_FEATURE_TYPE = 2;\nParser.MEDIA_QUERY_TYPE = 3;\nParser.PROPERTY_NAME_TYPE = 4;\nParser.PROPERTY_VALUE_TYPE = 5;\nParser.PROPERTY_VALUE_PART_TYPE = 6;\nParser.SELECTOR_TYPE = 7;\nParser.SELECTOR_PART_TYPE = 8;\nParser.SELECTOR_SUB_PART_TYPE = 9;\n\nParser.prototype = function(){\n\n var proto = new EventTarget(), //new prototype\n prop,\n additions = {\n\n //restore constructor\n constructor: Parser,\n\n //instance constants - yuck\n DEFAULT_TYPE : 0,\n COMBINATOR_TYPE : 1,\n MEDIA_FEATURE_TYPE : 2,\n MEDIA_QUERY_TYPE : 3,\n PROPERTY_NAME_TYPE : 4,\n PROPERTY_VALUE_TYPE : 5,\n PROPERTY_VALUE_PART_TYPE : 6,\n SELECTOR_TYPE : 7,\n SELECTOR_PART_TYPE : 8,\n SELECTOR_SUB_PART_TYPE : 9,\n\n //-----------------------------------------------------------------\n // Grammar\n //-----------------------------------------------------------------\n\n _stylesheet: function(){\n\n /*\n * stylesheet\n * : [ CHARSET_SYM S* STRING S* ';' ]?\n * [S|CDO|CDC]* [ import [S|CDO|CDC]* ]*\n * [ namespace [S|CDO|CDC]* ]*\n * [ [ ruleset | media | page | font_face | keyframes ] [S|CDO|CDC]* ]*\n * ;\n */\n\n var tokenStream = this._tokenStream,\n charset = null,\n count,\n token,\n tt;\n\n this.fire(\"startstylesheet\");\n\n //try to read character set\n this._charset();\n\n this._skipCruft();\n\n //try to read imports - may be more than one\n while (tokenStream.peek() == Tokens.IMPORT_SYM){\n this._import();\n this._skipCruft();\n }\n\n //try to read namespaces - may be more than one\n while (tokenStream.peek() == Tokens.NAMESPACE_SYM){\n this._namespace();\n this._skipCruft();\n }\n\n //get the next token\n tt = tokenStream.peek();\n\n //try to read the rest\n while(tt > Tokens.EOF){\n\n try {\n\n switch(tt){\n case Tokens.MEDIA_SYM:\n this._media();\n this._skipCruft();\n break;\n case Tokens.PAGE_SYM:\n this._page();\n this._skipCruft();\n break;\n case Tokens.FONT_FACE_SYM:\n this._font_face();\n this._skipCruft();\n break;\n case Tokens.KEYFRAMES_SYM:\n this._keyframes();\n this._skipCruft();\n break;\n case Tokens.UNKNOWN_SYM: //unknown @ rule\n tokenStream.get();\n if (!this.options.strict){\n\n //fire error event\n this.fire({\n type: \"error\",\n error: null,\n message: \"Unknown @ rule: \" + tokenStream.LT(0).value + \".\",\n line: tokenStream.LT(0).startLine,\n col: tokenStream.LT(0).startCol\n });\n\n //skip braces\n count=0;\n while (tokenStream.advance([Tokens.LBRACE, Tokens.RBRACE]) == Tokens.LBRACE){\n count++; //keep track of nesting depth\n }\n\n while(count){\n tokenStream.advance([Tokens.RBRACE]);\n count--;\n }\n\n } else {\n //not a syntax error, rethrow it\n throw new SyntaxError(\"Unknown @ rule.\", tokenStream.LT(0).startLine, tokenStream.LT(0).startCol);\n }\n break;\n case Tokens.S:\n this._readWhitespace();\n break;\n default:\n if(!this._ruleset()){\n\n //error handling for known issues\n switch(tt){\n case Tokens.CHARSET_SYM:\n token = tokenStream.LT(1);\n this._charset(false);\n throw new SyntaxError(\"@charset not allowed here.\", token.startLine, token.startCol);\n case Tokens.IMPORT_SYM:\n token = tokenStream.LT(1);\n this._import(false);\n throw new SyntaxError(\"@import not allowed here.\", token.startLine, token.startCol);\n case Tokens.NAMESPACE_SYM:\n token = tokenStream.LT(1);\n this._namespace(false);\n throw new SyntaxError(\"@namespace not allowed here.\", token.startLine, token.startCol);\n default:\n tokenStream.get(); //get the last token\n this._unexpectedToken(tokenStream.token());\n }\n\n }\n }\n } catch(ex) {\n if (ex instanceof SyntaxError && !this.options.strict){\n this.fire({\n type: \"error\",\n error: ex,\n message: ex.message,\n line: ex.line,\n col: ex.col\n });\n } else {\n throw ex;\n }\n }\n\n tt = tokenStream.peek();\n }\n\n if (tt != Tokens.EOF){\n this._unexpectedToken(tokenStream.token());\n }\n\n this.fire(\"endstylesheet\");\n },\n\n _charset: function(emit){\n var tokenStream = this._tokenStream,\n charset,\n token,\n line,\n col;\n\n if (tokenStream.match(Tokens.CHARSET_SYM)){\n line = tokenStream.token().startLine;\n col = tokenStream.token().startCol;\n\n this._readWhitespace();\n tokenStream.mustMatch(Tokens.STRING);\n\n token = tokenStream.token();\n charset = token.value;\n\n this._readWhitespace();\n tokenStream.mustMatch(Tokens.SEMICOLON);\n\n if (emit !== false){\n this.fire({\n type: \"charset\",\n charset:charset,\n line: line,\n col: col\n });\n }\n }\n },\n\n _import: function(emit){\n /*\n * import\n * : IMPORT_SYM S*\n * [STRING|URI] S* media_query_list? ';' S*\n */\n\n var tokenStream = this._tokenStream,\n tt,\n uri,\n importToken,\n mediaList = [];\n\n //read import symbol\n tokenStream.mustMatch(Tokens.IMPORT_SYM);\n importToken = tokenStream.token();\n this._readWhitespace();\n\n tokenStream.mustMatch([Tokens.STRING, Tokens.URI]);\n\n //grab the URI value\n uri = tokenStream.token().value.replace(/(?:url\\()?[\"']([^\"']+)[\"']\\)?/, \"$1\");\n\n this._readWhitespace();\n\n mediaList = this._media_query_list();\n\n //must end with a semicolon\n tokenStream.mustMatch(Tokens.SEMICOLON);\n this._readWhitespace();\n\n if (emit !== false){\n this.fire({\n type: \"import\",\n uri: uri,\n media: mediaList,\n line: importToken.startLine,\n col: importToken.startCol\n });\n }\n\n },\n\n _namespace: function(emit){\n /*\n * namespace\n * : NAMESPACE_SYM S* [namespace_prefix S*]? [STRING|URI] S* ';' S*\n */\n\n var tokenStream = this._tokenStream,\n line,\n col,\n prefix,\n uri;\n\n //read import symbol\n tokenStream.mustMatch(Tokens.NAMESPACE_SYM);\n line = tokenStream.token().startLine;\n col = tokenStream.token().startCol;\n this._readWhitespace();\n\n //it's a namespace prefix - no _namespace_prefix() method because it's just an IDENT\n if (tokenStream.match(Tokens.IDENT)){\n prefix = tokenStream.token().value;\n this._readWhitespace();\n }\n\n tokenStream.mustMatch([Tokens.STRING, Tokens.URI]);\n /*if (!tokenStream.match(Tokens.STRING)){\n tokenStream.mustMatch(Tokens.URI);\n }*/\n\n //grab the URI value\n uri = tokenStream.token().value.replace(/(?:url\\()?[\"']([^\"']+)[\"']\\)?/, \"$1\");\n\n this._readWhitespace();\n\n //must end with a semicolon\n tokenStream.mustMatch(Tokens.SEMICOLON);\n this._readWhitespace();\n\n if (emit !== false){\n this.fire({\n type: \"namespace\",\n prefix: prefix,\n uri: uri,\n line: line,\n col: col\n });\n }\n\n },\n\n _media: function(){\n /*\n * media\n * : MEDIA_SYM S* media_query_list S* '{' S* ruleset* '}' S*\n * ;\n */\n var tokenStream = this._tokenStream,\n line,\n col,\n mediaList;// = [];\n\n //look for @media\n tokenStream.mustMatch(Tokens.MEDIA_SYM);\n line = tokenStream.token().startLine;\n col = tokenStream.token().startCol;\n\n this._readWhitespace();\n\n mediaList = this._media_query_list();\n\n tokenStream.mustMatch(Tokens.LBRACE);\n this._readWhitespace();\n\n this.fire({\n type: \"startmedia\",\n media: mediaList,\n line: line,\n col: col\n });\n\n while(true) {\n if (tokenStream.peek() == Tokens.PAGE_SYM){\n this._page();\n } else if (!this._ruleset()){\n break;\n }\n }\n\n tokenStream.mustMatch(Tokens.RBRACE);\n this._readWhitespace();\n\n this.fire({\n type: \"endmedia\",\n media: mediaList,\n line: line,\n col: col\n });\n },\n\n\n //CSS3 Media Queries\n _media_query_list: function(){\n /*\n * media_query_list\n * : S* [media_query [ ',' S* media_query ]* ]?\n * ;\n */\n var tokenStream = this._tokenStream,\n mediaList = [];\n\n\n this._readWhitespace();\n\n if (tokenStream.peek() == Tokens.IDENT || tokenStream.peek() == Tokens.LPAREN){\n mediaList.push(this._media_query());\n }\n\n while(tokenStream.match(Tokens.COMMA)){\n this._readWhitespace();\n mediaList.push(this._media_query());\n }\n\n return mediaList;\n },\n\n /*\n * Note: \"expression\" in the grammar maps to the _media_expression\n * method.\n\n */\n _media_query: function(){\n /*\n * media_query\n * : [ONLY | NOT]? S* media_type S* [ AND S* expression ]*\n * | expression [ AND S* expression ]*\n * ;\n */\n var tokenStream = this._tokenStream,\n type = null,\n ident = null,\n token = null,\n expressions = [];\n\n if (tokenStream.match(Tokens.IDENT)){\n ident = tokenStream.token().value.toLowerCase();\n\n //since there's no custom tokens for these, need to manually check\n if (ident != \"only\" && ident != \"not\"){\n tokenStream.unget();\n ident = null;\n } else {\n token = tokenStream.token();\n }\n }\n\n this._readWhitespace();\n\n if (tokenStream.peek() == Tokens.IDENT){\n type = this._media_type();\n if (token === null){\n token = tokenStream.token();\n }\n } else if (tokenStream.peek() == Tokens.LPAREN){\n if (token === null){\n token = tokenStream.LT(1);\n }\n expressions.push(this._media_expression());\n }\n\n if (type === null && expressions.length === 0){\n return null;\n } else {\n this._readWhitespace();\n while (tokenStream.match(Tokens.IDENT)){\n if (tokenStream.token().value.toLowerCase() != \"and\"){\n this._unexpectedToken(tokenStream.token());\n }\n\n this._readWhitespace();\n expressions.push(this._media_expression());\n }\n }\n\n return new MediaQuery(ident, type, expressions, token.startLine, token.startCol);\n },\n\n //CSS3 Media Queries\n _media_type: function(){\n /*\n * media_type\n * : IDENT\n * ;\n */\n return this._media_feature();\n },\n\n /**\n * Note: in CSS3 Media Queries, this is called \"expression\".\n * Renamed here to avoid conflict with CSS3 Selectors\n * definition of \"expression\". Also note that \"expr\" in the\n * grammar now maps to \"expression\" from CSS3 selectors.\n * @method _media_expression\n * @private\n */\n _media_expression: function(){\n /*\n * expression\n * : '(' S* media_feature S* [ ':' S* expr ]? ')' S*\n * ;\n */\n var tokenStream = this._tokenStream,\n feature = null,\n token,\n expression = null;\n\n tokenStream.mustMatch(Tokens.LPAREN);\n\n feature = this._media_feature();\n this._readWhitespace();\n\n if (tokenStream.match(Tokens.COLON)){\n this._readWhitespace();\n token = tokenStream.LT(1);\n expression = this._expression();\n }\n\n tokenStream.mustMatch(Tokens.RPAREN);\n this._readWhitespace();\n\n return new MediaFeature(feature, (expression ? new SyntaxUnit(expression, token.startLine, token.startCol) : null));\n },\n\n //CSS3 Media Queries\n _media_feature: function(){\n /*\n * media_feature\n * : IDENT\n * ;\n */\n var tokenStream = this._tokenStream;\n\n tokenStream.mustMatch(Tokens.IDENT);\n\n return SyntaxUnit.fromToken(tokenStream.token());\n },\n\n //CSS3 Paged Media\n _page: function(){\n /*\n * page:\n * PAGE_SYM S* IDENT? pseudo_page? S*\n * '{' S* [ declaration | margin ]? [ ';' S* [ declaration | margin ]? ]* '}' S*\n * ;\n */\n var tokenStream = this._tokenStream,\n line,\n col,\n identifier = null,\n pseudoPage = null;\n\n //look for @page\n tokenStream.mustMatch(Tokens.PAGE_SYM);\n line = tokenStream.token().startLine;\n col = tokenStream.token().startCol;\n\n this._readWhitespace();\n\n if (tokenStream.match(Tokens.IDENT)){\n identifier = tokenStream.token().value;\n\n //The value 'auto' may not be used as a page name and MUST be treated as a syntax error.\n if (identifier.toLowerCase() === \"auto\"){\n this._unexpectedToken(tokenStream.token());\n }\n }\n\n //see if there's a colon upcoming\n if (tokenStream.peek() == Tokens.COLON){\n pseudoPage = this._pseudo_page();\n }\n\n this._readWhitespace();\n\n this.fire({\n type: \"startpage\",\n id: identifier,\n pseudo: pseudoPage,\n line: line,\n col: col\n });\n\n this._readDeclarations(true, true);\n\n this.fire({\n type: \"endpage\",\n id: identifier,\n pseudo: pseudoPage,\n line: line,\n col: col\n });\n\n },\n\n //CSS3 Paged Media\n _margin: function(){\n /*\n * margin :\n * margin_sym S* '{' declaration [ ';' S* declaration? ]* '}' S*\n * ;\n */\n var tokenStream = this._tokenStream,\n line,\n col,\n marginSym = this._margin_sym();\n\n if (marginSym){\n line = tokenStream.token().startLine;\n col = tokenStream.token().startCol;\n\n this.fire({\n type: \"startpagemargin\",\n margin: marginSym,\n line: line,\n col: col\n });\n\n this._readDeclarations(true);\n\n this.fire({\n type: \"endpagemargin\",\n margin: marginSym,\n line: line,\n col: col\n });\n return true;\n } else {\n return false;\n }\n },\n\n //CSS3 Paged Media\n _margin_sym: function(){\n\n /*\n * margin_sym :\n * TOPLEFTCORNER_SYM |\n * TOPLEFT_SYM |\n * TOPCENTER_SYM |\n * TOPRIGHT_SYM |\n * TOPRIGHTCORNER_SYM |\n * BOTTOMLEFTCORNER_SYM |\n * BOTTOMLEFT_SYM |\n * BOTTOMCENTER_SYM |\n * BOTTOMRIGHT_SYM |\n * BOTTOMRIGHTCORNER_SYM |\n * LEFTTOP_SYM |\n * LEFTMIDDLE_SYM |\n * LEFTBOTTOM_SYM |\n * RIGHTTOP_SYM |\n * RIGHTMIDDLE_SYM |\n * RIGHTBOTTOM_SYM\n * ;\n */\n\n var tokenStream = this._tokenStream;\n\n if(tokenStream.match([Tokens.TOPLEFTCORNER_SYM, Tokens.TOPLEFT_SYM,\n Tokens.TOPCENTER_SYM, Tokens.TOPRIGHT_SYM, Tokens.TOPRIGHTCORNER_SYM,\n Tokens.BOTTOMLEFTCORNER_SYM, Tokens.BOTTOMLEFT_SYM,\n Tokens.BOTTOMCENTER_SYM, Tokens.BOTTOMRIGHT_SYM,\n Tokens.BOTTOMRIGHTCORNER_SYM, Tokens.LEFTTOP_SYM,\n Tokens.LEFTMIDDLE_SYM, Tokens.LEFTBOTTOM_SYM, Tokens.RIGHTTOP_SYM,\n Tokens.RIGHTMIDDLE_SYM, Tokens.RIGHTBOTTOM_SYM]))\n {\n return SyntaxUnit.fromToken(tokenStream.token());\n } else {\n return null;\n }\n\n },\n\n _pseudo_page: function(){\n /*\n * pseudo_page\n * : ':' IDENT\n * ;\n */\n\n var tokenStream = this._tokenStream;\n\n tokenStream.mustMatch(Tokens.COLON);\n tokenStream.mustMatch(Tokens.IDENT);\n\n //TODO: CSS3 Paged Media says only \"left\", \"center\", and \"right\" are allowed\n\n return tokenStream.token().value;\n },\n\n _font_face: function(){\n /*\n * font_face\n * : FONT_FACE_SYM S*\n * '{' S* declaration [ ';' S* declaration ]* '}' S*\n * ;\n */\n var tokenStream = this._tokenStream,\n line,\n col;\n\n //look for @page\n tokenStream.mustMatch(Tokens.FONT_FACE_SYM);\n line = tokenStream.token().startLine;\n col = tokenStream.token().startCol;\n\n this._readWhitespace();\n\n this.fire({\n type: \"startfontface\",\n line: line,\n col: col\n });\n\n this._readDeclarations(true);\n\n this.fire({\n type: \"endfontface\",\n line: line,\n col: col\n });\n },\n\n _operator: function(inFunction){\n\n /*\n * operator (outside function)\n * : '/' S* | ',' S* | /( empty )/\n * operator (inside function)\n * : '/' S* | '+' S* | '*' S* | '-' S* /( empty )/\n * ;\n */\n\n var tokenStream = this._tokenStream,\n token = null;\n\n if (tokenStream.match([Tokens.SLASH, Tokens.COMMA]) ||\n (inFunction && tokenStream.match([Tokens.PLUS, Tokens.STAR, Tokens.MINUS]))){\n token = tokenStream.token();\n this._readWhitespace();\n }\n return token ? PropertyValuePart.fromToken(token) : null;\n\n },\n\n _combinator: function(){\n\n /*\n * combinator\n * : PLUS S* | GREATER S* | TILDE S* | S+\n * ;\n */\n\n var tokenStream = this._tokenStream,\n value = null,\n token;\n\n if(tokenStream.match([Tokens.PLUS, Tokens.GREATER, Tokens.TILDE])){\n token = tokenStream.token();\n value = new Combinator(token.value, token.startLine, token.startCol);\n this._readWhitespace();\n }\n\n return value;\n },\n\n _unary_operator: function(){\n\n /*\n * unary_operator\n * : '-' | '+'\n * ;\n */\n\n var tokenStream = this._tokenStream;\n\n if (tokenStream.match([Tokens.MINUS, Tokens.PLUS])){\n return tokenStream.token().value;\n } else {\n return null;\n }\n },\n\n _property: function(){\n\n /*\n * property\n * : IDENT S*\n * ;\n */\n\n var tokenStream = this._tokenStream,\n value = null,\n hack = null,\n tokenValue,\n token,\n line,\n col;\n\n //check for star hack - throws error if not allowed\n if (tokenStream.peek() == Tokens.STAR && this.options.starHack){\n tokenStream.get();\n token = tokenStream.token();\n hack = token.value;\n line = token.startLine;\n col = token.startCol;\n }\n\n if(tokenStream.match(Tokens.IDENT)){\n token = tokenStream.token();\n tokenValue = token.value;\n\n //check for underscore hack - no error if not allowed because it's valid CSS syntax\n if (tokenValue.charAt(0) == \"_\" && this.options.underscoreHack){\n hack = \"_\";\n tokenValue = tokenValue.substring(1);\n }\n\n value = new PropertyName(tokenValue, hack, (line||token.startLine), (col||token.startCol));\n this._readWhitespace();\n }\n\n return value;\n },\n\n //Augmented with CSS3 Selectors\n _ruleset: function(){\n /*\n * ruleset\n * : selectors_group\n * '{' S* declaration? [ ';' S* declaration? ]* '}' S*\n * ;\n */\n\n var tokenStream = this._tokenStream,\n tt,\n selectors;\n\n\n /*\n * Error Recovery: If even a single selector fails to parse,\n * then the entire ruleset should be thrown away.\n */\n try {\n selectors = this._selectors_group();\n } catch (ex){\n if (ex instanceof SyntaxError && !this.options.strict){\n\n //fire error event\n this.fire({\n type: \"error\",\n error: ex,\n message: ex.message,\n line: ex.line,\n col: ex.col\n });\n\n //skip over everything until closing brace\n tt = tokenStream.advance([Tokens.RBRACE]);\n if (tt == Tokens.RBRACE){\n //if there's a right brace, the rule is finished so don't do anything\n } else {\n //otherwise, rethrow the error because it wasn't handled properly\n throw ex;\n }\n\n } else {\n //not a syntax error, rethrow it\n throw ex;\n }\n\n //trigger parser to continue\n return true;\n }\n\n //if it got here, all selectors parsed\n if (selectors){\n\n this.fire({\n type: \"startrule\",\n selectors: selectors,\n line: selectors[0].line,\n col: selectors[0].col\n });\n\n this._readDeclarations(true);\n\n this.fire({\n type: \"endrule\",\n selectors: selectors,\n line: selectors[0].line,\n col: selectors[0].col\n });\n\n }\n\n return selectors;\n\n },\n\n //CSS3 Selectors\n _selectors_group: function(){\n\n /*\n * selectors_group\n * : selector [ COMMA S* selector ]*\n * ;\n */\n var tokenStream = this._tokenStream,\n selectors = [],\n selector;\n\n selector = this._selector();\n if (selector !== null){\n\n selectors.push(selector);\n while(tokenStream.match(Tokens.COMMA)){\n this._readWhitespace();\n selector = this._selector();\n if (selector !== null){\n selectors.push(selector);\n } else {\n this._unexpectedToken(tokenStream.LT(1));\n }\n }\n }\n\n return selectors.length ? selectors : null;\n },\n\n //CSS3 Selectors\n _selector: function(){\n /*\n * selector\n * : simple_selector_sequence [ combinator simple_selector_sequence ]*\n * ;\n */\n\n var tokenStream = this._tokenStream,\n selector = [],\n nextSelector = null,\n combinator = null,\n ws = null;\n\n //if there's no simple selector, then there's no selector\n nextSelector = this._simple_selector_sequence();\n if (nextSelector === null){\n return null;\n }\n\n selector.push(nextSelector);\n\n do {\n\n //look for a combinator\n combinator = this._combinator();\n\n if (combinator !== null){\n selector.push(combinator);\n nextSelector = this._simple_selector_sequence();\n\n //there must be a next selector\n if (nextSelector === null){\n this._unexpectedToken(tokenStream.LT(1));\n } else {\n\n //nextSelector is an instance of SelectorPart\n selector.push(nextSelector);\n }\n } else {\n\n //if there's not whitespace, we're done\n if (this._readWhitespace()){\n\n //add whitespace separator\n ws = new Combinator(tokenStream.token().value, tokenStream.token().startLine, tokenStream.token().startCol);\n\n //combinator is not required\n combinator = this._combinator();\n\n //selector is required if there's a combinator\n nextSelector = this._simple_selector_sequence();\n if (nextSelector === null){\n if (combinator !== null){\n this._unexpectedToken(tokenStream.LT(1));\n }\n } else {\n\n if (combinator !== null){\n selector.push(combinator);\n } else {\n selector.push(ws);\n }\n\n selector.push(nextSelector);\n }\n } else {\n break;\n }\n\n }\n } while(true);\n\n return new Selector(selector, selector[0].line, selector[0].col);\n },\n\n //CSS3 Selectors\n _simple_selector_sequence: function(){\n /*\n * simple_selector_sequence\n * : [ type_selector | universal ]\n * [ HASH | class | attrib | pseudo | negation ]*\n * | [ HASH | class | attrib | pseudo | negation ]+\n * ;\n */\n\n var tokenStream = this._tokenStream,\n\n //parts of a simple selector\n elementName = null,\n modifiers = [],\n\n //complete selector text\n selectorText= \"\",\n\n //the different parts after the element name to search for\n components = [\n //HASH\n function(){\n return tokenStream.match(Tokens.HASH) ?\n new SelectorSubPart(tokenStream.token().value, \"id\", tokenStream.token().startLine, tokenStream.token().startCol) :\n null;\n },\n this._class,\n this._attrib,\n this._pseudo,\n this._negation\n ],\n i = 0,\n len = components.length,\n component = null,\n found = false,\n line,\n col;\n\n\n //get starting line and column for the selector\n line = tokenStream.LT(1).startLine;\n col = tokenStream.LT(1).startCol;\n\n elementName = this._type_selector();\n if (!elementName){\n elementName = this._universal();\n }\n\n if (elementName !== null){\n selectorText += elementName;\n }\n\n while(true){\n\n //whitespace means we're done\n if (tokenStream.peek() === Tokens.S){\n break;\n }\n\n //check for each component\n while(i < len && component === null){\n component = components[i++].call(this);\n }\n\n if (component === null){\n\n //we don't have a selector\n if (selectorText === \"\"){\n return null;\n } else {\n break;\n }\n } else {\n i = 0;\n modifiers.push(component);\n selectorText += component.toString();\n component = null;\n }\n }\n\n\n return selectorText !== \"\" ?\n new SelectorPart(elementName, modifiers, selectorText, line, col) :\n null;\n },\n\n //CSS3 Selectors\n _type_selector: function(){\n /*\n * type_selector\n * : [ namespace_prefix ]? element_name\n * ;\n */\n\n var tokenStream = this._tokenStream,\n ns = this._namespace_prefix(),\n elementName = this._element_name();\n\n if (!elementName){\n /*\n * Need to back out the namespace that was read due to both\n * type_selector and universal reading namespace_prefix\n * first. Kind of hacky, but only way I can figure out\n * right now how to not change the grammar.\n */\n if (ns){\n tokenStream.unget();\n if (ns.length > 1){\n tokenStream.unget();\n }\n }\n\n return null;\n } else {\n if (ns){\n elementName.text = ns + elementName.text;\n elementName.col -= ns.length;\n }\n return elementName;\n }\n },\n\n //CSS3 Selectors\n _class: function(){\n /*\n * class\n * : '.' IDENT\n * ;\n */\n\n var tokenStream = this._tokenStream,\n token;\n\n if (tokenStream.match(Tokens.DOT)){\n tokenStream.mustMatch(Tokens.IDENT);\n token = tokenStream.token();\n return new SelectorSubPart(\".\" + token.value, \"class\", token.startLine, token.startCol - 1);\n } else {\n return null;\n }\n\n },\n\n //CSS3 Selectors\n _element_name: function(){\n /*\n * element_name\n * : IDENT\n * ;\n */\n\n var tokenStream = this._tokenStream,\n token;\n\n if (tokenStream.match(Tokens.IDENT)){\n token = tokenStream.token();\n return new SelectorSubPart(token.value, \"elementName\", token.startLine, token.startCol);\n\n } else {\n return null;\n }\n },\n\n //CSS3 Selectors\n _namespace_prefix: function(){\n /*\n * namespace_prefix\n * : [ IDENT | '*' ]? '|'\n * ;\n */\n var tokenStream = this._tokenStream,\n value = \"\";\n\n //verify that this is a namespace prefix\n if (tokenStream.LA(1) === Tokens.PIPE || tokenStream.LA(2) === Tokens.PIPE){\n\n if(tokenStream.match([Tokens.IDENT, Tokens.STAR])){\n value += tokenStream.token().value;\n }\n\n tokenStream.mustMatch(Tokens.PIPE);\n value += \"|\";\n\n }\n\n return value.length ? value : null;\n },\n\n //CSS3 Selectors\n _universal: function(){\n /*\n * universal\n * : [ namespace_prefix ]? '*'\n * ;\n */\n var tokenStream = this._tokenStream,\n value = \"\",\n ns;\n\n ns = this._namespace_prefix();\n if(ns){\n value += ns;\n }\n\n if(tokenStream.match(Tokens.STAR)){\n value += \"*\";\n }\n\n return value.length ? value : null;\n\n },\n\n //CSS3 Selectors\n _attrib: function(){\n /*\n * attrib\n * : '[' S* [ namespace_prefix ]? IDENT S*\n * [ [ PREFIXMATCH |\n * SUFFIXMATCH |\n * SUBSTRINGMATCH |\n * '=' |\n * INCLUDES |\n * DASHMATCH ] S* [ IDENT | STRING ] S*\n * ]? ']'\n * ;\n */\n\n var tokenStream = this._tokenStream,\n value = null,\n ns,\n token;\n\n if (tokenStream.match(Tokens.LBRACKET)){\n token = tokenStream.token();\n value = token.value;\n value += this._readWhitespace();\n\n ns = this._namespace_prefix();\n\n if (ns){\n value += ns;\n }\n\n tokenStream.mustMatch(Tokens.IDENT);\n value += tokenStream.token().value;\n value += this._readWhitespace();\n\n if(tokenStream.match([Tokens.PREFIXMATCH, Tokens.SUFFIXMATCH, Tokens.SUBSTRINGMATCH,\n Tokens.EQUALS, Tokens.INCLUDES, Tokens.DASHMATCH])){\n\n value += tokenStream.token().value;\n value += this._readWhitespace();\n\n tokenStream.mustMatch([Tokens.IDENT, Tokens.STRING]);\n value += tokenStream.token().value;\n value += this._readWhitespace();\n }\n\n tokenStream.mustMatch(Tokens.RBRACKET);\n\n return new SelectorSubPart(value + \"]\", \"attribute\", token.startLine, token.startCol);\n } else {\n return null;\n }\n },\n\n //CSS3 Selectors\n _pseudo: function(){\n\n /*\n * pseudo\n * : ':' ':'? [ IDENT | functional_pseudo ]\n * ;\n */\n\n var tokenStream = this._tokenStream,\n pseudo = null,\n colons = \":\",\n line,\n col;\n\n if (tokenStream.match(Tokens.COLON)){\n\n if (tokenStream.match(Tokens.COLON)){\n colons += \":\";\n }\n\n if (tokenStream.match(Tokens.IDENT)){\n pseudo = tokenStream.token().value;\n line = tokenStream.token().startLine;\n col = tokenStream.token().startCol - colons.length;\n } else if (tokenStream.peek() == Tokens.FUNCTION){\n line = tokenStream.LT(1).startLine;\n col = tokenStream.LT(1).startCol - colons.length;\n pseudo = this._functional_pseudo();\n }\n\n if (pseudo){\n pseudo = new SelectorSubPart(colons + pseudo, \"pseudo\", line, col);\n }\n }\n\n return pseudo;\n },\n\n //CSS3 Selectors\n _functional_pseudo: function(){\n /*\n * functional_pseudo\n * : FUNCTION S* expression ')'\n * ;\n */\n\n var tokenStream = this._tokenStream,\n value = null;\n\n if(tokenStream.match(Tokens.FUNCTION)){\n value = tokenStream.token().value;\n value += this._readWhitespace();\n value += this._expression();\n tokenStream.mustMatch(Tokens.RPAREN);\n value += \")\";\n }\n\n return value;\n },\n\n //CSS3 Selectors\n _expression: function(){\n /*\n * expression\n * : [ [ PLUS | '-' | DIMENSION | NUMBER | STRING | IDENT ] S* ]+\n * ;\n */\n\n var tokenStream = this._tokenStream,\n value = \"\";\n\n while(tokenStream.match([Tokens.PLUS, Tokens.MINUS, Tokens.DIMENSION,\n Tokens.NUMBER, Tokens.STRING, Tokens.IDENT, Tokens.LENGTH,\n Tokens.FREQ, Tokens.ANGLE, Tokens.TIME,\n Tokens.RESOLUTION, Tokens.SLASH])){\n\n value += tokenStream.token().value;\n value += this._readWhitespace();\n }\n\n return value.length ? value : null;\n\n },\n\n //CSS3 Selectors\n _negation: function(){\n /*\n * negation\n * : NOT S* negation_arg S* ')'\n * ;\n */\n\n var tokenStream = this._tokenStream,\n line,\n col,\n value = \"\",\n arg,\n subpart = null;\n\n if (tokenStream.match(Tokens.NOT)){\n value = tokenStream.token().value;\n line = tokenStream.token().startLine;\n col = tokenStream.token().startCol;\n value += this._readWhitespace();\n arg = this._negation_arg();\n value += arg;\n value += this._readWhitespace();\n tokenStream.match(Tokens.RPAREN);\n value += tokenStream.token().value;\n\n subpart = new SelectorSubPart(value, \"not\", line, col);\n subpart.args.push(arg);\n }\n\n return subpart;\n },\n\n //CSS3 Selectors\n _negation_arg: function(){\n /*\n * negation_arg\n * : type_selector | universal | HASH | class | attrib | pseudo\n * ;\n */\n\n var tokenStream = this._tokenStream,\n args = [\n this._type_selector,\n this._universal,\n function(){\n return tokenStream.match(Tokens.HASH) ?\n new SelectorSubPart(tokenStream.token().value, \"id\", tokenStream.token().startLine, tokenStream.token().startCol) :\n null;\n },\n this._class,\n this._attrib,\n this._pseudo\n ],\n arg = null,\n i = 0,\n len = args.length,\n elementName,\n line,\n col,\n part;\n\n line = tokenStream.LT(1).startLine;\n col = tokenStream.LT(1).startCol;\n\n while(i < len && arg === null){\n\n arg = args[i].call(this);\n i++;\n }\n\n //must be a negation arg\n if (arg === null){\n this._unexpectedToken(tokenStream.LT(1));\n }\n\n //it's an element name\n if (arg.type == \"elementName\"){\n part = new SelectorPart(arg, [], arg.toString(), line, col);\n } else {\n part = new SelectorPart(null, [arg], arg.toString(), line, col);\n }\n\n return part;\n },\n\n _declaration: function(){\n\n /*\n * declaration\n * : property ':' S* expr prio?\n * | /( empty )/\n * ;\n */\n\n var tokenStream = this._tokenStream,\n property = null,\n expr = null,\n prio = null,\n error = null,\n invalid = null,\n propertyName= \"\";\n\n property = this._property();\n if (property !== null){\n\n tokenStream.mustMatch(Tokens.COLON);\n this._readWhitespace();\n\n expr = this._expr();\n\n //if there's no parts for the value, it's an error\n if (!expr || expr.length === 0){\n this._unexpectedToken(tokenStream.LT(1));\n }\n\n prio = this._prio();\n\n /*\n * If hacks should be allowed, then only check the root\n * property. If hacks should not be allowed, treat\n * _property or *property as invalid properties.\n */\n propertyName = property.toString();\n if (this.options.starHack && property.hack == \"*\" ||\n this.options.underscoreHack && property.hack == \"_\") {\n\n propertyName = property.text;\n }\n\n try {\n this._validateProperty(propertyName, expr);\n } catch (ex) {\n invalid = ex;\n }\n\n this.fire({\n type: \"property\",\n property: property,\n value: expr,\n important: prio,\n line: property.line,\n col: property.col,\n invalid: invalid\n });\n\n return true;\n } else {\n return false;\n }\n },\n\n _prio: function(){\n /*\n * prio\n * : IMPORTANT_SYM S*\n * ;\n */\n\n var tokenStream = this._tokenStream,\n result = tokenStream.match(Tokens.IMPORTANT_SYM);\n\n this._readWhitespace();\n return result;\n },\n\n _expr: function(inFunction){\n /*\n * expr\n * : term [ operator term ]*\n * ;\n */\n\n var tokenStream = this._tokenStream,\n values = [],\n //valueParts = [],\n value = null,\n operator = null;\n\n value = this._term();\n if (value !== null){\n\n values.push(value);\n\n do {\n operator = this._operator(inFunction);\n\n //if there's an operator, keep building up the value parts\n if (operator){\n values.push(operator);\n } /*else {\n //if there's not an operator, you have a full value\n values.push(new PropertyValue(valueParts, valueParts[0].line, valueParts[0].col));\n valueParts = [];\n }*/\n\n value = this._term();\n\n if (value === null){\n break;\n } else {\n values.push(value);\n }\n } while(true);\n }\n\n //cleanup\n /*if (valueParts.length){\n values.push(new PropertyValue(valueParts, valueParts[0].line, valueParts[0].col));\n }*/\n\n return values.length > 0 ? new PropertyValue(values, values[0].line, values[0].col) : null;\n },\n\n _term: function(){\n\n /*\n * term\n * : unary_operator?\n * [ NUMBER S* | PERCENTAGE S* | LENGTH S* | ANGLE S* |\n * TIME S* | FREQ S* | function | ie_function ]\n * | STRING S* | IDENT S* | URI S* | UNICODERANGE S* | hexcolor\n * ;\n */\n\n var tokenStream = this._tokenStream,\n unary = null,\n value = null,\n token,\n line,\n col;\n\n //returns the operator or null\n unary = this._unary_operator();\n if (unary !== null){\n line = tokenStream.token().startLine;\n col = tokenStream.token().startCol;\n }\n\n //exception for IE filters\n if (tokenStream.peek() == Tokens.IE_FUNCTION && this.options.ieFilters){\n\n value = this._ie_function();\n if (unary === null){\n line = tokenStream.token().startLine;\n col = tokenStream.token().startCol;\n }\n\n //see if there's a simple match\n } else if (tokenStream.match([Tokens.NUMBER, Tokens.PERCENTAGE, Tokens.LENGTH,\n Tokens.ANGLE, Tokens.TIME,\n Tokens.FREQ, Tokens.STRING, Tokens.IDENT, Tokens.URI, Tokens.UNICODE_RANGE])){\n\n value = tokenStream.token().value;\n if (unary === null){\n line = tokenStream.token().startLine;\n col = tokenStream.token().startCol;\n }\n this._readWhitespace();\n } else {\n\n //see if it's a color\n token = this._hexcolor();\n if (token === null){\n\n //if there's no unary, get the start of the next token for line/col info\n if (unary === null){\n line = tokenStream.LT(1).startLine;\n col = tokenStream.LT(1).startCol;\n }\n\n //has to be a function\n if (value === null){\n\n /*\n * This checks for alpha(opacity=0) style of IE\n * functions. IE_FUNCTION only presents progid: style.\n */\n if (tokenStream.LA(3) == Tokens.EQUALS && this.options.ieFilters){\n value = this._ie_function();\n } else {\n value = this._function();\n }\n }\n\n /*if (value === null){\n return null;\n //throw new Error(\"Expected identifier at line \" + tokenStream.token().startLine + \", character \" + tokenStream.token().startCol + \".\");\n }*/\n\n } else {\n value = token.value;\n if (unary === null){\n line = token.startLine;\n col = token.startCol;\n }\n }\n\n }\n\n return value !== null ?\n new PropertyValuePart(unary !== null ? unary + value : value, line, col) :\n null;\n\n },\n\n _function: function(){\n\n /*\n * function\n * : FUNCTION S* expr ')' S*\n * ;\n */\n\n var tokenStream = this._tokenStream,\n functionText = null,\n expr = null,\n lt;\n\n if (tokenStream.match(Tokens.FUNCTION)){\n functionText = tokenStream.token().value;\n this._readWhitespace();\n expr = this._expr(true);\n functionText += expr;\n\n //START: Horrible hack in case it's an IE filter\n if (this.options.ieFilters && tokenStream.peek() == Tokens.EQUALS){\n do {\n\n if (this._readWhitespace()){\n functionText += tokenStream.token().value;\n }\n\n //might be second time in the loop\n if (tokenStream.LA(0) == Tokens.COMMA){\n functionText += tokenStream.token().value;\n }\n\n tokenStream.match(Tokens.IDENT);\n functionText += tokenStream.token().value;\n\n tokenStream.match(Tokens.EQUALS);\n functionText += tokenStream.token().value;\n\n //functionText += this._term();\n lt = tokenStream.peek();\n while(lt != Tokens.COMMA && lt != Tokens.S && lt != Tokens.RPAREN){\n tokenStream.get();\n functionText += tokenStream.token().value;\n lt = tokenStream.peek();\n }\n } while(tokenStream.match([Tokens.COMMA, Tokens.S]));\n }\n\n //END: Horrible Hack\n\n tokenStream.match(Tokens.RPAREN);\n functionText += \")\";\n this._readWhitespace();\n }\n\n return functionText;\n },\n\n _ie_function: function(){\n\n /* (My own extension)\n * ie_function\n * : IE_FUNCTION S* IDENT '=' term [S* ','? IDENT '=' term]+ ')' S*\n * ;\n */\n\n var tokenStream = this._tokenStream,\n functionText = null,\n expr = null,\n lt;\n\n //IE function can begin like a regular function, too\n if (tokenStream.match([Tokens.IE_FUNCTION, Tokens.FUNCTION])){\n functionText = tokenStream.token().value;\n\n do {\n\n if (this._readWhitespace()){\n functionText += tokenStream.token().value;\n }\n\n //might be second time in the loop\n if (tokenStream.LA(0) == Tokens.COMMA){\n functionText += tokenStream.token().value;\n }\n\n tokenStream.match(Tokens.IDENT);\n functionText += tokenStream.token().value;\n\n tokenStream.match(Tokens.EQUALS);\n functionText += tokenStream.token().value;\n\n //functionText += this._term();\n lt = tokenStream.peek();\n while(lt != Tokens.COMMA && lt != Tokens.S && lt != Tokens.RPAREN){\n tokenStream.get();\n functionText += tokenStream.token().value;\n lt = tokenStream.peek();\n }\n } while(tokenStream.match([Tokens.COMMA, Tokens.S]));\n\n tokenStream.match(Tokens.RPAREN);\n functionText += \")\";\n this._readWhitespace();\n }\n\n return functionText;\n },\n\n _hexcolor: function(){\n /*\n * There is a constraint on the color that it must\n * have either 3 or 6 hex-digits (i.e., [0-9a-fA-F])\n * after the \"#\"; e.g., \"#000\" is OK, but \"#abcd\" is not.\n *\n * hexcolor\n * : HASH S*\n * ;\n */\n\n var tokenStream = this._tokenStream,\n token = null,\n color;\n\n if(tokenStream.match(Tokens.HASH)){\n\n //need to do some validation here\n\n token = tokenStream.token();\n color = token.value;\n if (!/#[a-f0-9]{3,6}/i.test(color)){\n throw new SyntaxError(\"Expected a hex color but found '\" + color + \"' at line \" + token.startLine + \", col \" + token.startCol + \".\", token.startLine, token.startCol);\n }\n this._readWhitespace();\n }\n\n return token;\n },\n\n //-----------------------------------------------------------------\n // Animations methods\n //-----------------------------------------------------------------\n\n _keyframes: function(){\n\n /*\n * keyframes:\n * : KEYFRAMES_SYM S* keyframe_name S* '{' S* keyframe_rule* '}' {\n * ;\n */\n var tokenStream = this._tokenStream,\n token,\n tt,\n name,\n prefix = \"\";\n\n tokenStream.mustMatch(Tokens.KEYFRAMES_SYM);\n token = tokenStream.token();\n if (/^@\\-([^\\-]+)\\-/.test(token.value)) {\n prefix = RegExp.$1;\n }\n\n this._readWhitespace();\n name = this._keyframe_name();\n\n this._readWhitespace();\n tokenStream.mustMatch(Tokens.LBRACE);\n\n this.fire({\n type: \"startkeyframes\",\n name: name,\n prefix: prefix,\n line: token.startLine,\n col: token.startCol\n });\n\n this._readWhitespace();\n tt = tokenStream.peek();\n\n //check for key\n while(tt == Tokens.IDENT || tt == Tokens.PERCENTAGE) {\n this._keyframe_rule();\n this._readWhitespace();\n tt = tokenStream.peek();\n }\n\n this.fire({\n type: \"endkeyframes\",\n name: name,\n prefix: prefix,\n line: token.startLine,\n col: token.startCol\n });\n\n this._readWhitespace();\n tokenStream.mustMatch(Tokens.RBRACE);\n\n },\n\n _keyframe_name: function(){\n\n /*\n * keyframe_name:\n * : IDENT\n * | STRING\n * ;\n */\n var tokenStream = this._tokenStream,\n token;\n\n tokenStream.mustMatch([Tokens.IDENT, Tokens.STRING]);\n return SyntaxUnit.fromToken(tokenStream.token());\n },\n\n _keyframe_rule: function(){\n\n /*\n * keyframe_rule:\n * : key_list S*\n * '{' S* declaration [ ';' S* declaration ]* '}' S*\n * ;\n */\n var tokenStream = this._tokenStream,\n token,\n keyList = this._key_list();\n\n this.fire({\n type: \"startkeyframerule\",\n keys: keyList,\n line: keyList[0].line,\n col: keyList[0].col\n });\n\n this._readDeclarations(true);\n\n this.fire({\n type: \"endkeyframerule\",\n keys: keyList,\n line: keyList[0].line,\n col: keyList[0].col\n });\n\n },\n\n _key_list: function(){\n\n /*\n * key_list:\n * : key [ S* ',' S* key]*\n * ;\n */\n var tokenStream = this._tokenStream,\n token,\n key,\n keyList = [];\n\n //must be least one key\n keyList.push(this._key());\n\n this._readWhitespace();\n\n while(tokenStream.match(Tokens.COMMA)){\n this._readWhitespace();\n keyList.push(this._key());\n this._readWhitespace();\n }\n\n return keyList;\n },\n\n _key: function(){\n /*\n * There is a restriction that IDENT can be only \"from\" or \"to\".\n *\n * key\n * : PERCENTAGE\n * | IDENT\n * ;\n */\n\n var tokenStream = this._tokenStream,\n token;\n\n if (tokenStream.match(Tokens.PERCENTAGE)){\n return SyntaxUnit.fromToken(tokenStream.token());\n } else if (tokenStream.match(Tokens.IDENT)){\n token = tokenStream.token();\n\n if (/from|to/i.test(token.value)){\n return SyntaxUnit.fromToken(token);\n }\n\n tokenStream.unget();\n }\n\n //if it gets here, there wasn't a valid token, so time to explode\n this._unexpectedToken(tokenStream.LT(1));\n },\n\n //-----------------------------------------------------------------\n // Helper methods\n //-----------------------------------------------------------------\n\n /**\n * Not part of CSS grammar, but useful for skipping over\n * combination of white space and HTML-style comments.\n * @return {void}\n * @method _skipCruft\n * @private\n */\n _skipCruft: function(){\n while(this._tokenStream.match([Tokens.S, Tokens.CDO, Tokens.CDC])){\n //noop\n }\n },\n\n /**\n * Not part of CSS grammar, but this pattern occurs frequently\n * in the official CSS grammar. Split out here to eliminate\n * duplicate code.\n * @param {Boolean} checkStart Indicates if the rule should check\n * for the left brace at the beginning.\n * @param {Boolean} readMargins Indicates if the rule should check\n * for margin patterns.\n * @return {void}\n * @method _readDeclarations\n * @private\n */\n _readDeclarations: function(checkStart, readMargins){\n /*\n * Reads the pattern\n * S* '{' S* declaration [ ';' S* declaration ]* '}' S*\n * or\n * S* '{' S* [ declaration | margin ]? [ ';' S* [ declaration | margin ]? ]* '}' S*\n * Note that this is how it is described in CSS3 Paged Media, but is actually incorrect.\n * A semicolon is only necessary following a delcaration is there's another declaration\n * or margin afterwards.\n */\n var tokenStream = this._tokenStream,\n tt;\n\n\n this._readWhitespace();\n\n if (checkStart){\n tokenStream.mustMatch(Tokens.LBRACE);\n }\n\n this._readWhitespace();\n\n try {\n\n while(true){\n\n if (tokenStream.match(Tokens.SEMICOLON) || (readMargins && this._margin())){\n //noop\n } else if (this._declaration()){\n if (!tokenStream.match(Tokens.SEMICOLON)){\n break;\n }\n } else {\n break;\n }\n\n //if ((!this._margin() && !this._declaration()) || !tokenStream.match(Tokens.SEMICOLON)){\n // break;\n //}\n this._readWhitespace();\n }\n\n tokenStream.mustMatch(Tokens.RBRACE);\n this._readWhitespace();\n\n } catch (ex) {\n if (ex instanceof SyntaxError && !this.options.strict){\n\n //fire error event\n this.fire({\n type: \"error\",\n error: ex,\n message: ex.message,\n line: ex.line,\n col: ex.col\n });\n\n //see if there's another declaration\n tt = tokenStream.advance([Tokens.SEMICOLON, Tokens.RBRACE]);\n if (tt == Tokens.SEMICOLON){\n //if there's a semicolon, then there might be another declaration\n this._readDeclarations(false, readMargins);\n } else if (tt != Tokens.RBRACE){\n //if there's a right brace, the rule is finished so don't do anything\n //otherwise, rethrow the error because it wasn't handled properly\n throw ex;\n }\n\n } else {\n //not a syntax error, rethrow it\n throw ex;\n }\n }\n\n },\n\n /**\n * In some cases, you can end up with two white space tokens in a\n * row. Instead of making a change in every function that looks for\n * white space, this function is used to match as much white space\n * as necessary.\n * @method _readWhitespace\n * @return {String} The white space if found, empty string if not.\n * @private\n */\n _readWhitespace: function(){\n\n var tokenStream = this._tokenStream,\n ws = \"\";\n\n while(tokenStream.match(Tokens.S)){\n ws += tokenStream.token().value;\n }\n\n return ws;\n },\n\n\n /**\n * Throws an error when an unexpected token is found.\n * @param {Object} token The token that was found.\n * @method _unexpectedToken\n * @return {void}\n * @private\n */\n _unexpectedToken: function(token){\n throw new SyntaxError(\"Unexpected token '\" + token.value + \"' at line \" + token.startLine + \", col \" + token.startCol + \".\", token.startLine, token.startCol);\n },\n\n /**\n * Helper method used for parsing subparts of a style sheet.\n * @return {void}\n * @method _verifyEnd\n * @private\n */\n _verifyEnd: function(){\n if (this._tokenStream.LA(1) != Tokens.EOF){\n this._unexpectedToken(this._tokenStream.LT(1));\n }\n },\n\n //-----------------------------------------------------------------\n // Validation methods\n //-----------------------------------------------------------------\n _validateProperty: function(property, value){\n Validation.validate(property, value);\n },\n\n //-----------------------------------------------------------------\n // Parsing methods\n //-----------------------------------------------------------------\n\n parse: function(input){\n this._tokenStream = new TokenStream(input, Tokens);\n this._stylesheet();\n },\n\n parseStyleSheet: function(input){\n //just passthrough\n return this.parse(input);\n },\n\n parseMediaQuery: function(input){\n this._tokenStream = new TokenStream(input, Tokens);\n var result = this._media_query();\n\n //if there's anything more, then it's an invalid selector\n this._verifyEnd();\n\n //otherwise return result\n return result;\n },\n\n /**\n * Parses a property value (everything after the semicolon).\n * @return {parserlib.css.PropertyValue} The property value.\n * @throws parserlib.util.SyntaxError If an unexpected token is found.\n * @method parserPropertyValue\n */\n parsePropertyValue: function(input){\n\n this._tokenStream = new TokenStream(input, Tokens);\n this._readWhitespace();\n\n var result = this._expr();\n\n //okay to have a trailing white space\n this._readWhitespace();\n\n //if there's anything more, then it's an invalid selector\n this._verifyEnd();\n\n //otherwise return result\n return result;\n },\n\n /**\n * Parses a complete CSS rule, including selectors and\n * properties.\n * @param {String} input The text to parser.\n * @return {Boolean} True if the parse completed successfully, false if not.\n * @method parseRule\n */\n parseRule: function(input){\n this._tokenStream = new TokenStream(input, Tokens);\n\n //skip any leading white space\n this._readWhitespace();\n\n var result = this._ruleset();\n\n //skip any trailing white space\n this._readWhitespace();\n\n //if there's anything more, then it's an invalid selector\n this._verifyEnd();\n\n //otherwise return result\n return result;\n },\n\n /**\n * Parses a single CSS selector (no comma)\n * @param {String} input The text to parse as a CSS selector.\n * @return {Selector} An object representing the selector.\n * @throws parserlib.util.SyntaxError If an unexpected token is found.\n * @method parseSelector\n */\n parseSelector: function(input){\n\n this._tokenStream = new TokenStream(input, Tokens);\n\n //skip any leading white space\n this._readWhitespace();\n\n var result = this._selector();\n\n //skip any trailing white space\n this._readWhitespace();\n\n //if there's anything more, then it's an invalid selector\n this._verifyEnd();\n\n //otherwise return result\n return result;\n },\n\n /**\n * Parses an HTML style attribute: a set of CSS declarations\n * separated by semicolons.\n * @param {String} input The text to parse as a style attribute\n * @return {void}\n * @method parseStyleAttribute\n */\n parseStyleAttribute: function(input){\n input += \"}\"; // for error recovery in _readDeclarations()\n this._tokenStream = new TokenStream(input, Tokens);\n this._readDeclarations();\n }\n };\n\n //copy over onto prototype\n for (prop in additions){\n if (additions.hasOwnProperty(prop)){\n proto[prop] = additions[prop];\n }\n }\n\n return proto;\n}();\n\n\n/*\nnth\n : S* [ ['-'|'+']? INTEGER? {N} [ S* ['-'|'+'] S* INTEGER ]? |\n ['-'|'+']? INTEGER | {O}{D}{D} | {E}{V}{E}{N} ] S*\n ;\n*/\n/*global Validation, ValidationTypes, ValidationError*/\nvar Properties = {\n\n //A\n \"alignment-adjust\" : \"auto | baseline | before-edge | text-before-edge | middle | central | after-edge | text-after-edge | ideographic | alphabetic | hanging | mathematical | | \",\n \"alignment-baseline\" : \"baseline | use-script | before-edge | text-before-edge | after-edge | text-after-edge | central | middle | ideographic | alphabetic | hanging | mathematical\",\n \"animation\" : 1,\n \"animation-delay\" : { multi: \"