FileSystem AutoCompletion

Authors:

• Luke Hudson [email protected]
• Filip Krikava [email protected]

Enable auto-completion of paths from the file system à la VIM.

File completion can be explicitly triggered by Ctrl+Alt+/ (on OSX, Cmd instead of Ctrl) shortcut.

This combination can be always rebound to a different key combination in usual SublimeText manner, by opening the User keybindings file (see menu: Preferences/Package Settings/FileSystem Autocompletion).

For example, you should also be able to use the Vim shortcut Ctrl+X,Ctrl+F by adding the following to your Keybindings - User file:

   { "keys": ["ctrl+x","ctrl+f"], "command": "file_system_comp_trigger"}

This plugin handles spaces in file names and find the correct file path beginning. If you find any problem, please open an issue.

Current directory

The directory containing the project file is used by default. Unsaved files in windows without a project fall back to the first folder in the window. A path starting with . uses the current view's directory instead. The path search order can be configured via the usual settings file:

"path_search_order": ["project", "view", "window"]

Unknown values are ignored. If no configured source has a directory, relative paths do not produce filesystem completions.

Installation

Either use Package Control or clone/download the repository into Sublime Text's Packages directory as sublime-fscompletion.

Spaces

This plugin should handle file paths that contains spaces including escaped spaces with \.

For example if there are three files:

quick test
quick test 1
quick test 2

Then quick test followed by our shortcut will display all three options and when selecting the second one for instance it will get expanded to quick test 1. On the other hand quick\ test followed by our shortcut with the same selection will be expanded to quick\ test\ 1. If the path is detected to be escaped it will continue to escape all the followed spaces.

File path beginning

The problem is that a file name can be contain many special characters. For example \input{some file} is a valid file. However, it is also a way how to include a file in LaTeX document and more likely we want to have a completion of the path some file rather than path \input{some file}. This plugin, therefore, tries to determine the beginning of a path from which it should look for the completion by finding the longest possible path that exists. For the example above, with the cursor positioned at the end of some file, it will try:

/Users/user/\input{some file
Users/user/\input{some file
krikava/\input{some file
\input{some file
input{some file
some file
file

and it will stop as soon as any of these path exists (a glob pattern with appended * returns something).

License

All parts of this plugin are licensed under GPL v3 (see LICENSE.txt).