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

Code​Map

by oleg-shilo ST3

CodeMap - is a ST3 plugin for showing the code tree representing the code structure of the active view/document

Details

Installs

  • Total 1K
  • Win 701
  • OS X 314
  • Linux 265
Jul 15 Jul 14 Jul 13 Jul 12 Jul 11 Jul 10 Jul 9 Jul 8 Jul 7 Jul 6 Jul 5 Jul 4 Jul 3 Jul 2 Jul 1 Jun 30 Jun 29 Jun 28 Jun 27 Jun 26 Jun 25 Jun 24 Jun 23 Jun 22 Jun 21 Jun 20 Jun 19 Jun 18 Jun 17 Jun 16 Jun 15 Jun 14 Jun 13 Jun 12 Jun 11 Jun 10 Jun 9 Jun 8 Jun 7 Jun 6 Jun 5 Jun 4 Jun 3 Jun 2 Jun 1 May 31
Windows 1 0 0 1 3 2 2 2 1 1 1 1 3 4 0 1 2 5 0 2 2 0 2 5 1 3 4 0 0 1 1 8 1 3 4 0 1 3 1 3 4 1 4 1 2 1
OS X 0 1 1 0 0 0 0 0 1 1 0 0 3 0 0 0 1 1 1 1 0 0 0 0 2 1 0 0 2 1 1 2 2 2 0 0 0 2 1 1 0 1 1 1 1 1
Linux 0 0 0 0 2 1 1 0 0 1 0 0 0 0 0 0 0 0 1 1 0 1 0 0 0 0 0 1 0 0 2 0 0 1 1 0 1 1 0 2 2 0 0 1 0 1

Readme

Source
raw.​githubusercontent.​com

Sublime CodeMap

A plugin for displaying the code map (code structure tree) in the Sublime Text 3 editor.

This plugin is a port of PyMap Visual Studio extension.

Plugin currently supports building the code tree for Python. Support for C# is in the pipeline. The design of plugin allows integration of the user defined tree building algorithm for other languages. The custom syntax integration infrastructure and and samples will be available in the next release.

Installation

Note the plugin was developed and tested against ST3 but not ST2.

Package Control

You can install the pluging Package Control.

Manual

  • Remove the package, if installed, using Package Control.
  • Add a repository: https://github.com/oleg-shilo/sublime-codemap.git
  • Install sublime-codemap with Package Control.
  • Restart Sublime editor if required

You can also install the plugin by cloning sublime-codemap repository into your Packages folder or manually placing the download package there.

Usage

The plugin uses a dedicated view group Code - Map (on right side) to mimic a “side bar” with the content (code tree) that represents code structure of the active view content in the primary view group.

The code tree automatically refreshes on saving the active document or switching the tabs. The usage is quite simple. You can double-click a node in the code tree and this will trigger navigation to the corresponding area in the code (in active document). Alternatively you can synchronize code tree node selection with the current caret position in the document by triggering sync_code_map command either from Command Palette or by the configured shortcut.

To start working with CodeMap just make the map view visible (e.g. [alt+m, alt+m]) and set the focus to the code view.

Command Palette

Press cmd+shift+p. Type codemap to see the available commands:

  • Toggle Visibility - Show/Hide CodeMap view. The CodeMap view is always placed in the most right column (group) of the active window. If show_in_new_group is set to true, a new group will be created.
    Default keybinding is Alt+m Alt+m

  • Reveal in CodeMap - Select code tree node that corresponds the caret position in the code (active view).
    Default keybinding is Alt+m Alt+.

  • Render From View - Attempt to render CodeMap from a view that isn't bound to a phisycal file.
    Default keybinding is Alt+m Alt+,

Custom mapping

Custom mapper

You can extend the built-in functionality with custom mappers. A Custom Mapper is a Python script, which defines a mandatory def generate(file) routine that analyses a given file content and produces a 'code map' representing the content structure.

You can find the md.py sample in the source code. This mapper builds the list of markdown sections in the given text file. In order to activate the mapper its script needs to be properly named and placed in the special folder: <Packages>\User\CodeMap\custom_mappers. The name of the mapper file must follow a special naming convention: "<extension>.py"

Example: "%APPDATA%\Sublime Text 3\Packages\User\CodeMap\custom_mappers\md.py"

You can associate a syntax with the custom mapper, so that the CodeMap will use it for rendering the map content. Custom syntaxes can also be put in Packages\User\CodeMap\custom_languages. The syntax association must be specified in the custom mapper itself:

map_syntax = 'Packages/Python/Python.tmLanguage'

Python syntax seems to be a good highlighting schema for majority of mapping scenarios.

Universal Mapper

The universal mapper is a generic Regex based mapper that can be used as an alternative for dedicated custom mappers. The mapping algorithm(s) of the universal mapper is defined in the plugin settings, and is extension-dependent.

The plugin will always try to use universal mapper mapping algorithm first, and only if it's not available the plugin will try to locate a dedicated custom mapper based on the active document file extension. Full instructions on how to make a custom mapper using the universal mapper are included in the settings file.

Note that if you use a custom mapper for an extension that is already defined in the universal mapper settings, the latter will have precedence. Comment out the extension in the universal mapper section to use your custom mapper in its place.

The advantage of using the universal mapper (and define new rules for it when needed) is that it supports by default the map depth system, with which you can alter the depth of the displayed map. Custom mappers need to support this system internally.

Below is a simple example of adding universal mapper support for TypeScript:

Add file extension (e.g. 'ts') and name of the algorithm section to the syntaxes section:

"syntaxes":     [
                        ["universal",   ""],
                        ["text",        "txt"],
                        ["typescript",  "ts"],
                        ["python",      "py"]
                ],

Create a new typescript section an fill it with the the following content:

"typescript": {
                "regex":
                [
                    [
                        "^(class |function |export class |interface ).*$",
                        "[(:{].*$",
                        "",
                        false
                    ]
                ],
                "indent": 4,
                "obligatory indent": false,
                "empty line in map before": "class",
                "line numbers before": false,
                "prefix": "",
                "suffix": "()",
                "syntax": "Packages/TypeScript/TypeScript.tmLanguage"
             },

Map depth

If using the universal mapper or a dedicated mapper that supports it, you can change the depth of the displayed map. Default hotkeys are:

{ "keys": ["alt+m", "alt+left"], "command": "code_map_decrease_depth" },
{ "keys": ["alt+m", "alt+right"],"command": "code_map_increase_depth" },

Navigation with Keyboard

You can start keyboard navigation with Al+m, Alt+n. Then use the following keys:

up / down                   move by definition
alt+up / alt+down           move by class
enter/escape/left/right     focus back on edited view

Settings

You can also configure plugin to: 1. Hide the group on closing the CodeMap view when it is the only view in the group. 2. Always place CodeMap view in the individual most-right column. 3. CodeMap group width. 4. Assign a custom font size/font face/margin for the CodeMap.

code_map.sublime-settings

{
    "close_empty_group_on_closing_map": true,
    "show_in_new_group": true
    "codemap_width": 0.17,
    "codemap_font_size": 8,
    "codemap_font_face": "Verily Serif Mono",
    "codemap_margin": 8,
}