Sublime Text package developers may find themselves have to close and re-open ST multiple times when developing a package since ST doesn't reload all the submodules of a package when the files are edited. This tiny package helps in reloading the package without the need of reopening ST. The reloading order of the modules is in the exact same order as if they are loaded by Sublime Text.
- Download & Install
Sublime Text 3
(https://www.sublimetext.com/3) - Go to the menu
Tools -> Install Package Control
, then, wait few seconds until the installation finishes up - Now,
Go to the menu
Preferences -> Package Control
- Type
Add Channel
on the opened quick panel and press Enter - Then,
input the following address and press Enter
https://raw.githubusercontent.com/evandrocoan/StudioChannel/master/channel.json
- Go to the menu
Tools -> Command Palette... (Ctrl+Shift+P)
- Type
Preferences: Package Control Settings – User
on the opened quick panel and press Enter - Then,
find the following setting on your
Package Control.sublime-settings
file:"channels": [ "https://packagecontrol.io/channel_v3.json", "https://raw.githubusercontent.com/evandrocoan/StudioChannel/master/channel.json", ],
- And,
change it to the following, i.e.,
put the
https://raw.githubusercontent...
line as first:"channels": [ "https://raw.githubusercontent.com/evandrocoan/StudioChannel/master/channel.json", "https://packagecontrol.io/channel_v3.json", ],
- The
https://raw.githubusercontent...
line must to be added before thehttps://packagecontrol.io...
one, otherwise, you will not install this forked version of the package, but the original available on the Package Control default channelhttps://packagecontrol.io...
- The
- Now,
go to the menu
Preferences -> Package Control
- Type
Install Package
on the opened quick panel and press Enter - Then,
search for
AutomaticPackageReloader
and press Enter
See also:
- ITE - Integrated Toolset Environment
- Package control docs for details.
To reload the package in the current window, use Automatic Package Reloader: Reload Current Project
.
To activate reload on saving a *py
file, use Automatic Package Reloader: Toggle Reload On Save
.
Package Reloader will guess the package name from the file path in order to reload the submodules
and to reload the package.
The console panel will be shown when reloading fails, this behavior can be modified by the settings.
It is recommended to add the following in your .sublime-project
file so that c+b would invoke the reload action.
"build_systems":
[
{
"name": "Reload Current Package",
"target": "package_reloader_reload",
}
]
APR would try its best to guess the dependent modules of the package. Sometimes, it may fail to detect all the dependencies. In those cases, developers could specify extra modules to be reloaded in the .package_reloader.json
file.
{
"dependencies" : ["<module1>", "<module2>"]
}
This is derived from the code of Eldar Abusalimov.