Lensort

Lensort is a Sublime Text plugin for sorting lines by length, with options to preserve or remove leading whitespace. This plugin is designed for developers who are meticulous about the appearance of their code and want an easy way to organize lines in a visually pleasing manner.

Features

• Sort lines by length.
• Preserve or remove leading whitespace.
• Option to include whitespace in the sorting calculation or ignore it.
• Support for replacing spaces with tabs based on your Sublime Text tab_size setting.
• Easily accessible from the menu and via keyboard shortcuts.

Installation

Via Package Control

1. Open Sublime Text.
2. Press Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (Mac) to open the Command Palette.
3. Type Install Package and select Package Control: Install Package.
4. Search for Lensort and press Enter.

Manual Installation

1. Download or clone this repository.
2. Copy the Lensort folder to your Sublime Text Packages directory:
   • On Windows: C:\Users\<Your Name>\AppData\Roaming\Sublime Text\Packages
   • On macOS: ~/Library/Application Support/Sublime Text/Packages
   • On Linux: ~/.config/sublime-text-3/Packages

Usage

Key Bindings

Lensort doesn't include default key bindings to avoid conflicts with other plugins. However, you can easily set up custom key bindings if you'd like by opening the included keymap files included with this package, and either copy the contents over to your keymap file and removing the comments, or by editing the comments in place and saving the changes to the packaged folder.

Suggested Key Bindings

You can use the suggested key bindings by uncommenting them in the provided keymap file specific to your OS:

Default (Windows).sublime-keymap Default (Linux).sublime-keymap Default (OSX).sublime-keymap

They are in this zipped directory: 'Lensort.sublime-package', either open the file for your OS and save its contents to keymap file found in your ..\Packages\User directory located in your Sublime Text's installation directory, or uncomment the section inplace and commit the changes directly to the Lensort package.

Just in case you get lost, here's a map:

../Sublime Text/Installed Packages/Lensort.sublime-package <-- where this plugin is installed, (i.e. you are here) |-other stuff |-Packages/User/Default ().sublime-keymap <-- where the keybinding file gets saved =)

[
    // Suggested Key Bindings for Lensort
    // Uncomment to use these bindings by adding an astrick '*' where indicated below.

    // Sort lines by length
    /* <-- put a 2nd '/' in front of the '/*' to enable the lines below
    { "keys": ["ctrl+f10"], "command": "sort_lines_by_length" },

    // Sort lines by length in reverse order
    { "keys": ["ctrl+shift+f10"], "command": "sort_lines_by_length", "args": {"reverse": true} }
    //*/
]

Save the lines to your keymap file, and your custom key bindings will be active.

If you have enabled the suggested keybindings, you can invoke this packages functionality with the following

Keyboard Shortcuts

• Sort Lines by Length: Ctrl+F10
• Sort Lines by Length (Reverse): Ctrl+Shift+F10

Menu

You can access the plugin via the Edit menu:

• Edit -> Sort by Length
• Edit -> Sort by Length (Reverse)

Settings

You can customize the plugin's behavior by editing the settings file:

• Default Settings: Preferences -> Package Settings -> Lensort -> Settings - Default
• User Settings: Preferences -> Package Settings -> Lensort -> Settings - User

Available Settings

• preserve_preceding_whitespace: Options are "leave_in_place", "move_with_line", or "no".
• whitespace_counted_in_sort: true or false. If true, whitespace is counted in the sorting calculation.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

Johhannas Reyn
Email: [email protected]

Contributing

Feel free to submit issues or pull requests if you find any bugs or have suggestions for new features.

Acknowledgments

Thanks to the Sublime Text community for providing such a powerful and flexible editor.