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 306
  • Win 138
  • OS X 102
  • Linux 66
Aug 15 Aug 14 Aug 13 Aug 12 Aug 11 Aug 10 Aug 9 Aug 8 Aug 7 Aug 6 Aug 5 Aug 4 Aug 3 Aug 2 Aug 1 Jul 31 Jul 30 Jul 29 Jul 28 Jul 27 Jul 26 Jul 25 Jul 24 Jul 23 Jul 22 Jul 21 Jul 20 Jul 19 Jul 18 Jul 17 Jul 16 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
Windows 0 0 3 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 0 0 0 0 0 0 0 0 0 0 0 0 0 0
OS X 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 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
Linux 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0 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

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