Sourcegraph for Sublime Text 3

The Sourcegraph plugin for Sublime Text 3 enables you to quickly open and search code on Sourcegraph.com easily and efficiently.

Installation

1. Install Package Control, if you haven't already.
2. Open the command palette Cmd+Shift+P (Ctrl+Shift+P on Windows/Linux).
3. Search for Package Control: Install Package and press enter.
4. Search for Sourcegraph and press enter to install the plugin.

Usage

In the command palette (Cmd+Shift+P or Ctrl+Shift+P), search for Sourcegraph: to see available actions.

Keyboard Shortcuts:

Description	Mac	Linux / Windows
Open file in Sourcegraph	Option+A	Alt+A
Search selection in Sourcegraph	Option+S	Alt+S

Settings

Open the user package settings (Sublime Text -> Package Settings -> Sourcegraph -> Settings - User), then modify this example configuration:

{
	// The Sourcegraph instance to use. Specify your on-premises Sourcegraph
	// instance here, if applicable.
	"SOURCEGRAPH_URL": "https://sourcegraph.com",
}

Questions & Feedback

Please file an issue: https://github.com/sourcegraph/sourcegraph-sublime/issues/new

Logs

Logs show up in the Sublime console, which is accessible via Ctrl+`

Uninstallation

1. Open the command palette Cmd+Shift+P (Ctrl+Shift+P on Windows/Linux).
2. Search for Package Control: Remove Package and press enter.
3. Search for sourcegraph and press enter to uninstall the plugin.

Development

To develop the plugin:

• git clone the repository into ~/Library/Application Support/Sublime Text 3/Packages/sourcegraph-sublime
• Open the console with Ctrl+`
• Make changes to the Python code and watch as Sublime reloads.
• To release a new version, you MUST update the following files:
  1. messages.json (add a new version entry)
  2. README.md (describe ALL changes)
  3. messages/welcome.txt (copy from README.md change above)
  4. sourcegraph.py (VERSION constant)
  • Then git commit -m "all: release v<THE VERSION>" and git push and git tag v<THE VERSION> and git push --tags.
  • Note: it sometimes takes a few hours for it to show up on https://packagecontrol.io/packages/Sourcegraph

Version History

• v1.0.7 - Correctly open the default browser on Mac OS.

  • Added a workaround for a Mac OS bug that causes Python to incorrectly open the second (non-default) browser. https://bugs.python.org/issue30392

• v1.0.6 - Fixed search shortcut.

  • Updated the search URL to reflect a recent Sourcegraph.com change.

• v1.0.5 - Minor fixes to configuration.

  • Fix opening README, LICENSE, etc through "Package Settings" menu.
  • Update README to describe how to use with on-premises Sourcegraph instances.

• v1.0.4 - Improved support for on-premises Sourcegraph instances

  • Now using the sourcegraph.com/-/editor endpoint.

• v1.0.3 - Added usage metrics

  • Added minimal and non-obtrusive usage metrics, which lets us at Sourcegraph better improve our editor extensions.

• v1.0.2 - Usability improvements

  • Adjusted the global search URL to the correct one, so that the search shortcut will work.
  • Added support for non-default git branches (brings you to the checked out branch on Sourcegraph.com)
  • Changed the keyboard shortcuts to Option+S (search selection) and Option+A (open selection) (Alt instead of Option for Windows and Linux).

• v1.0.1 - Minor bug fixes

  • Fixed a bug where https etc. GitHub repo remote URLs would incorrectly build the Sourcegraph.com URL.
  • Windows: Fixed a bug where git commands would create Command Prompt pop-up windows.

• v1.0.0 - Initial Release; basic Open File & Search functionality.