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

Py​Tags

by qfel ST2

Python source code indexing and completion

Details

  • 2012.12.15.22.34.57
  • github.​com
  • github.​com
  • 7 years ago
  • 3 hours ago
  • 7 years ago

Installs

  • Total 5K
  • Win 3K
  • Mac 887
  • Linux 1K
Feb 29 Feb 28 Feb 27 Feb 26 Feb 25 Feb 24 Feb 23 Feb 22 Feb 21 Feb 20 Feb 19 Feb 18 Feb 17 Feb 16 Feb 15 Feb 14 Feb 13 Feb 12 Feb 11 Feb 10 Feb 9 Feb 8 Feb 7 Feb 6 Feb 5 Feb 4 Feb 3 Feb 2 Feb 1 Jan 31 Jan 30 Jan 29 Jan 28 Jan 27 Jan 26 Jan 25 Jan 24 Jan 23 Jan 22 Jan 21 Jan 20 Jan 19 Jan 18 Jan 17 Jan 16
Windows 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
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 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

Readme

Source
raw.​githubusercontent.​com

PyTags

This package provides Python source code indexing and navigation in Sublime Text 2. You can also enable import completions.

Quick Start

Install the package and add to your settings:

"pytags_index_on_load": true,
"pytags_index_on_save": true,
"pytags_databases":
    [
        {
            "include_project_folders": true,
            "path": "$HOME/.pytags.db"
        }
    ]

Now all Python files that you open or that are in your project folders will get indexed.

Requirements

Since SQLite is used to store indexed data, external python interpreter is used (Sublime's embedded interpreter doesn't ship with sqlite module). Just make sure that “shell python -u some_script.py

works. I tested it with Python 2.7, but I expect it to work with Python >= 2.6,
3.x included.

Command Palette
---------------

 - **Update Index** - Indexes files that have changed since last scan.
 - **Rebuild Index** - Indexes all files.
 - **Find Definition** - Skips to specified symbol definition.

Key Bindings
-------------
Ctrl+T, Ctrl+R updates the index. Ctrl+T, Ctrl+T skips to definition of symbol
under cursor.

Settings
--------

 - **pytags\_index\_on\_save** - Whether to index saved files.
 - **pytags\_index\_on\_load** - Whether to index opened files.
 - **pytags\_complete\_imports** - Whether to enable import completions.
 - **pytags\_exclusive\_completions** - Whether regular completions should be
                                        hidden when import completions are
                                        available.
 - **pytags\_databases** - List of databases to search/update, see next section.

Database Definitions
--------------------
You can use multiple databases at a time. This allows indexing of project
related stuff in one place and site packages in another, sharing some databases
among different projects. Each database definition requires "path" field (path
to the SQLite database file), and may include any of the following fields:

 - **include\_project\_folders** - Whether this database should index files
                                   found in project folders.
 - **roots** - List of directories containing files that should be indexed.
 - **pattern** - Regular expression that each indexed file should match.

All file paths can contain environment variables expandable with Python's
_os.path.expandvars_.


Import Completions
------------------
With import completions on, typing **from** _\<ctrl+space\>_ will pop up a list
of indexed modules, and typing **from foo.bar import** _\<ctrl+space\>_ will
bring up a list of indexed _foo.bar_'s members.


Compatibility Issues
--------------------
For completions to work, a little extended "Python (PyTags)" syntax is required.
If you enable import completions, it will be automatically used instead of
default Python syntax. "Python (PyTags)" top-level scope is
_source.python.pytags_. Plugins that incorrectly check scopes, like
```python
"some_string" in scope.split()

may have compatibility issues. Also, the syntax file name is "Python.tmLanguage”, which makes View->Syntax menu incorrectly mark both Python and Python (PyTags) as currently used. Using this name makes Sublime Linter work though.