ctrl+shift+p filters: :st2 :st3 :win :osx :linux
Browse

Sesame

by gerardroche ST3

Open, add, switch, and remove projects.

Details

Installs

  • Total 590
  • Win 254
  • Mac 213
  • Linux 123
May 31 May 30 May 29 May 28 May 27 May 26 May 25 May 24 May 23 May 22 May 21 May 20 May 19 May 18 May 17 May 16 May 15 May 14 May 13 May 12 May 11 May 10 May 9 May 8 May 7 May 6 May 5 May 4 May 3 May 2 May 1 Apr 30 Apr 29 Apr 28 Apr 27 Apr 26 Apr 25 Apr 24 Apr 23 Apr 22 Apr 21 Apr 20 Apr 19 Apr 18 Apr 17
Windows 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 3 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1
Mac 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
Linux 1 1 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0

Readme

Source
raw.​githubusercontent.​com

Sesame

Downloads

Ali Baba overhearing one of the thieves saying "Open Sesame"

Sesame is quick way to open, add, switch, and remove projects or folders. “Sesame” is play on the phrase “Open Sesame”. A magical phrase in the story of “Ali Baba and the Forty Thieves” from Antoine Galland's version of One Thousand and One Nights. It opens the mouth of a cave in which forty thieves have hidden a treasure.

Read Sesame - A Sublime Text plugin for a quick introduction of usage.

Installation

You can install via Package Control.

Setup

Set the location of your projects and add your preferred key bindings.

Menu → Preferences → Settings

"sesame.path": "~/projects",

Menu → Preferences → Key Bindings

{ "keys": ["ctrl+alt+o"], "command": "sesame_open" },
{ "keys": ["ctrl+alt+a"], "command": "sesame_add" },
{ "keys": ["ctrl+alt+r"], "command": "sesame_remove" },
{ "keys": ["ctrl+alt+s"], "command": "sesame_switch" },

Commands

Command Description
Sesame: Open Open a project in a new window
Sesame: Add Add a project to the current window
Sesame: Remove Remove a project from the current window
Sesame: Switch Switch to a project in the current window

Settings

Menu → Preferences → Settings

Setting Description Type Default
sesame.path Location of projects. string or list[str, dict] The value found in the environment variable PROJECTS_PATH (if it exists).
sesame.depth Number of levels deep to look for projects within path. int 1 or 2 2
sesame.keymaps Enable default key bindings. boolean true
sesame.vcs Include/exclude version controlled projects e.g. Git, Mercurial, Subversion: true means include only version controlled projects, false means exclude them, and null (default), means version controlled and non-version controlled projects are included. boolean or null null

sesame.path

"sesame.path": "~/projects"

Multiple paths can be set using a PATH separator (':' for POSIX or ';' for Windows):

"sesame.path": "~/projects:~/work:~/src"

Or as a list:

"sesame.path": ["~/projects", "~/work", "~/src"]

A PROJECTS_PATH environment variable can be used to set a default projects path (instead of using the setting sesame.path described above) e.g. on Linux edit ~/.profile (may require a system restart):

export PROJECTS_PATH=~/projects

sesame.depth

Projects are located using the pattern */* e.g. vendor/name.

If you prefer to organise your projects on a single directory level, set the depth to 1:

The default depth is 2

"sesame.depth": 2

Multiple project paths

If you have multiple projects paths configured, you can configure the depth and other settings on a path-by-path basis in the following way. A path with no specific setting will fallback to the root setting.

"sesame.path": [
    {"path": "~/projects/a", "depth": 1}
    {"path": "~/projects/b", "vcs": true}
],
"sesame.depth": 2

Custom commands

Adding sesame commands Key Bindings.

{ "keys": ["ctrl+alt+v"], "command": "sesame_open", "args": { "path": "~/vendor" } }

Adding sesame commands to the Command Palette. Create User/Default.sublime-commands

{ "caption": "Sesame: Open Vendor", "command": "sesame_open", "args": { "path": "~/vendor" } },

Changelog

See CHANGELOG.md.

License

Released under the GPL-3.0-or-later License.