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

Wrap​Statement

by shagabutdinov ST2/ST3

Attempt to make nice statements wrapping that hits first ruler (80 symbols by default) length

Details

Installs

  • Total 259
  • Win 112
  • OS X 90
  • Linux 57
Oct 19 Oct 18 Oct 17 Oct 16 Oct 15 Oct 14 Oct 13 Oct 12 Oct 11 Oct 10 Oct 9 Oct 8 Oct 7 Oct 6 Oct 5 Oct 4 Oct 3 Oct 2 Oct 1 Sep 30 Sep 29 Sep 28 Sep 27 Sep 26 Sep 25 Sep 24 Sep 23 Sep 22 Sep 21 Sep 20 Sep 19 Sep 18 Sep 17 Sep 16 Sep 15 Sep 14 Sep 13 Sep 12 Sep 11 Sep 10 Sep 9 Sep 8 Sep 7 Sep 6 Sep 5
Windows 0 0 0 0 0 0 2 0 0 0 0 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
OS X 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 1 0 1 1 0 0 2 0 0 0 1 0 0 0 0 0 0
Linux 0 0 0 0 0 0 0 0 0 1 0 1 0 0 0 0 1 0 0 1 0 0 1 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0

Readme

Source
raw.​githubusercontent.​com

Sublime WrapStatement plugin (beta)

Attempt to make statements wrapping that hits first ruler (80 symbols by default) length.

Demo

Demo

Reason

It is crusial to keep source code clean and well-wrapped to keep it readability. Even if you have 30"-display it is hardly recommended to keep code wrapped at number of symbols before 120 because the problem not with the size of screen but with how humans perceive written text (any text, not only source code).

Most of books, magazines and newspapers have 120 symbols and less text wrapping. I don't think that they do it without reason. They are professionals and know that it is easier to read if text is well-wrapped.

If you wrap your code before 120 symbols you'll make the life of developers that use laptops and small screens a bit easier. You'll probably will make your own life easier if one day you'd like to work from your home or hotel using only laptop.

Note that many software companies defined maximum line length as 80 (hey, google) so I highly advise you to keep 80-symbols wrapping.

I know that there can be many arguing around this advise. I did this plugin because I personally keep this rule in mind when I program and I needed an instrument that helps me to execute this rule faster.

Installation

This plugin is part of sublime-enhanced plugin set. You can install sublime-enhanced and this plugin will be installed automatically.

If you would like to install this package separately check “Installing packages separately” section of sublime-enhanced package.

WARNING

This plugin is in beta. This plugin can corrupt source code and get it to uniterpreted state. Use this plugin with care.

Features

Inserts new lines at positions that calculated by plugin. Also could split quoted strings to avoid code to be too long.

Example:

# before
  matches = expression.find_matches(view, 0, '(.{' + str(ruler - 1) + '}).{2}', {'nesting': True, 'scope': 'source(?!.*json)(?!.*source)'})

  # after
  matches = expression.find_matches(view, 0, '(.{' + str(ruler - 1) + '}).{2}',
    {'nesting': True, 'scope': 'source(?!.*json)(?!.*source)'})

Also can unwrap statements (remove new lines from statement).

Usage

Hit keyboard shortcut to wrap/unwrap/rewrap statement.

Commands

Description Keyboard shortcuts Command palette
Wrap statement ctrl+m, ctrl+e WrapStatement: wrap
Unwrap statement ctrl+m, e WrapStatement: unwrap
Rewrap statement ctrl+alt+w WrapStatement: rewrap

Dependencies