Text Pastry

Text Pastry is a free plugin for Sublime Text, designed to reduce repetetive work by extending the multiple selections feature of Sublime Text.

Features include:

Incremental numbers/sequences (1, 2, 3 or 100, 80, 60)
Repeatable number ranges (1, 2, 3, 4, 1, 2, 3, 4 or 2, 1, 2, 1, 2, 1)
Generate UUIDS (ba18f7fc-c387-46da-9544-ed32e49ce6f8 or D306E86C-918F-4551-95A9-CB9865A4DD2F)
Extendable list of presets (Monday, Tuesday, Wednesday or alpha, beta, gamma)
Extendable list of commands
Create and modify selections
Improved paste (paste the first three lines of the clipboard data to the three selected locations)
Generate date ranges

What's new

1.4.9: Bugfix release for uuid x10 #31 - Thanks @miusuncle
1.4.8: Added support for repeating increments #29 - Thanks @mkruselj
1.4.7: Fixed range command (stop condition was ignored)
1.4.6: Bugfix release for paste by row - Thanks @Nieralyte
1.4.5: Added the paste by row command (use pr or pbr in the command line) #28
1.4.4: Bugfix for command \i #27 - Thanks @kcko
1.4.3: New commands! Generate date ranges command, repeat argument (x-arg), and the Auto Step command
1.4.2: Fix range / negative steps #24 - Thanks @TheClams
1.4.1: Hotfix for #23 - Thanks @dufferzafar
1.4.0: New Features!

Release Notes 1.4.3

Three new commands were added in 1.4.3!

Generate date ranges

New settings:

"parse_date_formats": [
    "%d.%m.%Y"
],

parse_date_formats is used to parse the date from the Text Pastry command line. For supported date formats, please check out http://strftime.org/

"date_format": "%d.%m.%Y",

used to generate the date range. For supported date formats, please check out http://strftime.org/. For our convenience, we can set the date format-setting by calling the date-format command:

date-format %Y-%m-%d

date range commands

Command:

days x5

Result:

Command:

weeks

Result:

Command:

months

Result:

Command:

end-of-month

Result:

Command:

years

Result:

We can add a start date to date range commands:

weeks 14.03.2015

Result:

The date range command supports the newly introduced x-arg! Lets create 30 dates:

days x30

14.12.2014
15.12.2014
16.12.2014
...
10.01.2015
11.01.2015
12.01.2015

Repeat argument (x-arg)

Before this release, we had to create empty lines and do a multiselect to create a number sequence. With 1.4.3, we can use this command to create new lines on the fly:

    1 x5

We will give us this result:

Text Pastry will duplicate the line and add the number sequence to it, so the line doesn't have to be empty:

    <div id="row-|"></div>

Using 1 x3 will give us this:

    <div id="row-1"></div>
    <div id="row-2"></div>
    <div id="row-3"></div>

The x-arg is supported by the UUID/uuid command, the N M P command, the range command and the date range command.

Note:: Please note that the x-argument will be ignored if we have multiple selections. If we have 5 selections, Text Pastry will behave the same way as before and will fill all selections with a sequence number.

Auto step (aka. Text with sequence #20)

Inspired by @passalini's request, I've added the auto step feature. Use this command:

Command: as <text> [step] [x-arg]

    as row-1

For each selection we've made, Text Pastry will insert the text and increment the number by [step] (default is 1). As example, if we had 4 selections, we will get this:

Source:

    <div id="|"></div>
    <div id="|"></div>
    <div id="|"></div>
    <div id="|"></div>

Result:

    <div id="row-1"></div>
    <div id="row-2"></div>
    <div id="row-3"></div>
    <div id="row-4"></div>

Auto step supports a step size argument:

    as row-0 2

Result:

    <div id="row-0"></div>
    <div id="row-2"></div>
    <div id="row-4"></div>
    <div id="row-6"></div>

Auto Step supports the x-arg:

Source:

    <div id="|"></div>

Command:

    as row-10 10 x10

will expand to this:

    <div id="row-10"></div>
    <div id="row-20"></div>
    <div id="row-30"></div>
    <div id="row-40"></div>
    <div id="row-50"></div>
    <div id="row-60"></div>
    <div id="row-70"></div>
    <div id="row-80"></div>
    <div id="row-90"></div>
    <div id="row-100"></div>

Generate a bunch of UUIDs

The UUID/uuid command supports the newly introduced x-arg. Use this command to create 100 UUIDs:

    UUID x100

Release Notes 1.4.0

I'm very excited to announce v1.4.0! The Code was actually released a few months ago, but I need the extra time to check the new features and update the wiki.

As alwys, please feel free to report any bugs and/or feature request here.

New Features

Command-line

The Text Pastry text field ( CTRL/CMD + ALT + N ) supports an extendable list of commands.

Text Pastry Commands work like keybindings; you can map a keyword to any command available to Sublime Text. We can add new commands by modifying the Text Pastry User-Settings file (Preferences -> Package Settings -> Text Pastry -> Settings - Default).

For more information, please visit the wiki

Presets

Presets are a list of pre-defined values:

A start/range operator is supported, as well as reverse and case modifiers.

We can extend this list as we like by modifying the text pastry user settings file (Preferences -> Package Settings -> Text Pastry -> Settings - Default)

Selection Modifiers

I've added four commands to create, add and modify the current selection:

Command	Alias	Action
find	search	Create new selections
add		Add to the current selection
remove	reduce, subtract	Remove from the current selections
filter		search in selection

find

Clears the current selection, looks for the search term and marks them as new selections. The special thing about this command is how regex groups are handled: if the search term contains a regex-group, the group will be used for selection. As a nice side effect, this will give us the option to place the cursor anywhere we want to.

This Example will select all values inside of the attribute name, the cursor will be placed at the end of the selection. We can place the cursor at the start of the selection by using the reverse option:

find name="(.*?)" -> name="this value is selected|"

In this example, we will place the cursor at the beginning of the value, without a text selection:

find name="().*?" -> name="|this value is not selected"

As we can see, we are now able to place the cursor anywhere we want aswell as creating multiple selections with one regex.

add

Adds the matches to the current selection. This example will add all words to the current selection.

add \w+

remove

Removes the matches form the current selection. This example will remove all non-words from the current selection:

remove \s+

There are some additional shortcuts for remove:

Comamnd	Action
remove lines	Removes empty lines (lines containing only spaces will be count as empty).
remove leading	Removes leading spaces.
remove trailing	Removes trailing spaces.
remove space	Removes empty lines, leading spaces and trailing spaces.

filter

The filter command acts as "find in selection". Only matched terms in the curren selection will be selected afterwards.

This example will only keep selections inside of parentheses:

filter \((.*?)\)

Yet Another Focus Mode

This mode lets us hide the side bar, tabs and/or status bar. We can configure what to hide in Packages/User/TextPastryAddons.sublime-settings. By default, Focus mode will toggle the side bar, status bar and the tabs:

{
    "focus": ["toggle_side_bar", "toggle_status_bar", "toggle_tabs"]
}

In addition, we can toggle the minimap by adding "toggle_minimap" to the list.

Shell (experimental)

We can pass our selections to a CLI (node, python or ruby) and process them by inline code or a script. Text Pastry will paste the result into the selection.

The script/code will get some basic information like selected text, index, etc. We probably need some context information for additional processing (like whats my scope, surrounding text, etc.)

Note: This is highly experimental. The code is prepped for additional CLI's.

Releases

1.4.2: Fix range / negative steps #24 - Thanks @TheClams
1.4.1: Hotfix for #23 - Thanks @dufferzafar
1.4.0: New Features: command-line, presets and selection modifiers, focus mode
1.3.7: Bugfix release #17
1.3.6: Bugfix release #14
1.3.5: History navigation, command shortcuts - Thanks @JAStanton
1.3.4: Fixed for Sublime Text 3 - Thanks @forcey
1.3.3: New commands: \r(regexp) and \r regex
1.3.2: Bugfix release

Installation

Thanks for using the excelent Package Control to install Text Pastry.

We can do a manuall installation by cloning this repository into our Packages folder. Sublime Text -> Preferences -> Browse Packages...

git clone git@github.com:duydao/Text-Pastry.git

How-To

To use Text Pastry, we need to open a Document in Sublime Text and use Multiple Selection to mark the insert locations (in this document also referred to as selections).

Let's keep in mind that the selected text will be replaced when we run the Text Pastry command. To avoid that, we can alway place the cursor between letters by using CTRL/CMD + Click or even select a whole column by using ALT + Click

All we need to do now is to press CTRL/CMD + ALT + N to open the Text Pastry command line. The input panel will show up at the bottom of Sublime Text.

Now its time to run our first command. Let's enter first second third and hit enter to run the command. Text Pastry will add first to our first selection, second to the next selection and so on.

Text Pastry will only replace as many words as we type into the command line. So if we have more selections then words, the rest of our selection will remain intact.

Key Bindings

The default key bindings are stored at /Text Pastry/Default.sublime-keymap. As always, you can use your user keymap file to setup your own key bindings.

Linux / Windows	Mac	Action
`CTRL` + `ALT` + `T`	`CMD` + `ALT` + `T`	Show _Text Pastry_ Menu
`CTRL` + `ALT` + `N`	`CMD` + `ALT` + `N`	Open _Text Pastry_ Command Line

Note: The commands from the Text Pastry menu are also available through the Command Palette (CTRL/CMD + SHIFT + P)

Command Reference

Regular Text

Replaces the first selection with Lorem, the second selection with Ipsum, etc.:

Lorem Ipsum Dolor

Note: Since version 1.3.5, there must be at least three words before this command will be executed. This change will make it possible to define commands without escape character.

We can still use a list of any size by prepeinding the words command:

words Lorem Ipsum

Incremental Numbers, Numeric Sequence

Inserts a sequence, starting at 1:

Inserts a sequence, starting at 0:

i0

Inserts a sequence by defining start index and step size:

i(N,M)

N the start index
M the step size

The step size defines the value to add to the index each time a value was inserted. Start index and step size may be negative.

Note: The Number Sequence command uses the syntax from TextPad.

To make it even easier, we can use this style if we want to:

start number increment by

With this example, the first number will be 1000 and it will be incremented by 250 for each selction:

1000 250

Clipboard

Inserts the content of the clipboard into our selections by splitting the words:

Same as above with a specified string separator:

p sep

sep the string separator used to split the clipboad data.

Note: The Clipboard command uses syntax from TextPad.

UUID

Text Pastry will generate a UUID for each selection we have made:

uuid

This command will generate a random UUID by using pythons uuid.uuid4() method:

dbf8326e-5243-406e-abd9-bd0425d3e842

We can this command to generate a random UUID in UPPERCASE:

UUID

Regular Expression as separators

We're able to define regex separators for the data that we are pasting, which should give us some new possibilities.

We can split the clipboard data by regex, and paste the resulting items into the selected locations:

regex expression

expression the regular expression used to split the clipboard data.

Note: If you managed to get python-pcre up and running, the library will be preferred over the default python re library.

Insert Nums

Text Pastry has a build in support for the Insert Nums syntax by providing three numbers separated by one space:

N M P

N: the start index.
M represents the step size which will be added to the index for each selection.
P must be > 0 and will be used to pad the index with leading zeroes.

Examples

Check out the wiki for examples!

Todo

formatters
wrappers #20
smart case: determine case-sensitivity by search term

Wishlist

Webservice "Shell": use a custom (web-)service to process our selections
yankring

Done

~~date ranges~~ (1.5.0)
~~incremental search: add search terms to selection by shortcut (work-in-progress)~~ (1.4.0, use add)
~~Alphabetical sequence (upper/lower case)~~ (1.4.0)
~~Random numbers, strings and sequences~~ (use Random Everything in combination with commands)
~~Command List Overlay~~
~~Command History~~
~~UUID generation~~
~~Settings for word manipulation~~
~~Paste as Block~~

Great plugins that I love to use with Text Pastry

in alphabetical order

autoselect - https://github.com/SublimeText/AutoSelect
Case Conversion - https://github.com/jdc0589/CaseConversion
Hasher - https://github.com/dangelov/hasher/
Insert Date - https://github.com/FichteFoll/sublimetext-insertdate

License

The MIT License (MIT)

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Neospiro/Text-Pastry

Text Pastry

Features include:

What's new

Release Notes 1.4.3

Generate date ranges

Repeat argument (x-arg)

Auto step (aka. Text with sequence #20)

Generate a bunch of UUIDs

Release Notes 1.4.0

New Features

Command-line

Presets

Selection Modifiers

find

add

remove

filter

Yet Another Focus Mode

Shell (experimental)

Releases

Installation

How-To

Key Bindings

Command Reference

Regular Text

Incremental Numbers, Numeric Sequence

Clipboard

UUID

Regular Expression as separators

Insert Nums

Examples

Todo

Wishlist

Done

Great plugins that I love to use with Text Pastry

License

See Also