PyDOC

A Sublime Text 3 plugin that supports Python documentation search from selections in the editor.

About

PyDOC is a plugin for Sublime Text 3 that allows you to open current project documentation for:

• Python 2
• Python 3
• Numpy
• SciPy
• Matplotlib
• TensorFlow

using source selections in your text editor. The selected text is used as the query for the official documentation provided on docs.python.org and the respective package websites. The documentation is opened in your default web browser.

Install PyDOC

Using Sublime Package Control

PyDOC can be installed using Sublime Package Control. Open the command palette with:

Mac OSX

Cmd + Shift + P

Linux & Windows

Ctrl + Shift + P

Type install and select the menu item, Package Control: Install Package.

Type PyDOC and select the PyDOC package that is displayed. This will install the package in your editor.

Using Git

Use the Sublime Text menu items Preferences -> Browse Packages to locate your Packages directory.

Navigate to the directory in your terminal and clone the PyDOC source repository inside the Packages directory using the command:

$ git clone https://github.com/chrissimpkins/PyDOC.git

Manual Install

Download the zip compressed archive from GitHub.

Decompress the zip archive and rename the directory PyDOC.

Open your Sublime Text Packages directory using the Preferences -> Browse Packages menu items.

Move the entire PyDOC directory into your Sublime Text Packages directory.

Use PyDOC

Search with Right Click Menu

Select a built-in Python object in your editor text, then use the Python 2 Doc Search, Python 3 Doc Search, Numpy Doc Search, SciPy Doc Search, Matplotlib Doc Search, or TensorFlow Doc Search menu item in the right click menu.

Search with Keybinding

Select a built-in Python object in your editor text, then use one of the following keybindings to perform the search:

Python 2 Documentation Search Keybinding

Ctrl-2

Python 3 Documentation Search Keybinding

Ctrl-3

Numpy Documentation Search Keybinding

Ctrl-4

SciPy Documentation Search Keybinding

Ctrl-5

Matplotlib Documentation Search Keybinding

Ctrl-6

TensorFlow Documentation Search Keybinding

Ctrl-7

Search with the Command Palette

Select a built-in Python object in your editor text then enter the key binding to open the command palette (see description above in the Sublime Package Control section). Type 'pydoc' and then select either Python 2 Doc Search (PyDOC), Python 3 Doc Search (PyDOC),Numpy Doc Search (PyDOC), SciPy Doc Search (PyDOC), Matplotlib Doc Search (PyDOC), or TensorFlow Doc Search (PyDOC).

Issues

Having a problem? Let's fix it. Here are a few steps that will lead to the most rapid fix:

1. Make sure that you selected text in the editor before attempting to use PyDOC. It's not that good (yet...).

2. Open the Sublime Text console with Ctrl-` or View -> Show Console, then run PyDOC again. It generally provides helpful hints for problems and any exceptions that are raised will be displayed.

3. Submit the issue on the GitHub repository with as much detail as you can provide. Please paste the console ouptut for any exceptions that are raised.

Changes

See CHANGELOG.md

License

MIT License