Snippet (programming)

From HandWiki
Short description: Small region of re-usable source code, machine code, or text
Example of a code snippet.

Snippet is a programming term for a small region of re-usable source code, machine code, or text. Ordinarily, these are formally defined operative units to incorporate into larger programming modules. Snippet management is a feature of some text editors, program source code editors, IDEs, and related software. It allows the user to avoid repetitive typing in the course of routine edit operations.[1]

Definition

In programming practice, "snippet" refers narrowly to a portion of source code that is literally included by an editor program into a file, and is a form of copy and paste programming.[2] This concrete inclusion is in contrast to abstraction methods, such as functions or macros, which are abstraction within the language. Snippets are thus primarily used when these abstractions are not available or not desired, such as in languages that lack abstraction, or for clarity and absence of overhead.

Snippets are similar to having static preprocessing included in the editor, and do not require support by a compiler. On the flip side, this means that snippets cannot be invariably modified after the fact, and thus is vulnerable to all of the problems of copy and paste programming. For this reason snippets are primarily used for simple sections of code (with little logic), or for boilerplate, such as copyright notices, function prototypes, common control structures, or standard library imports.

Overview

Snippet management is a text editor feature popular among software developers or others who routinely require content from a catalogue of repeatedly entered text (such as with source code or boilerplate). Often this feature is justified because the content varies only slightly (or not at all) each time it is entered.

Snippets in text editors

Text editors that include this feature ordinarily provide a mechanism to manage the catalogue, and separate "snippets" in the same manner that the text editor and operating system allow management of separate files. These basic management abilities include operations such as viewing, adding, editing, deleting, sorting, filtering, grouping, renaming, and storing snippets in a repository, catalogue, or database. Some editors provide a macro ability to snippets allowing function prototypes and variable control structures to be generated based on a standard template.

Snippets in IDEs

Some programmer's applications such as Eclipse, NetBeans, and Microsoft's Visual Studio (uses TextMate-inspired snippets underhood) and other IDEs include built-in parts of structure for ease of coding.

Other applications such as Macromedia Dreamweaver make use of these code snippets as well for Web development.

Snippets in JIT compilers

Just-in-time (JIT) compilers can "splice together" pre-compiled sections of code as longer object code/machine code segments. This reduces interpret time significantly and simultaneously speeds execution.

Animated example demonstrating use of snippet in PowerShell ISE

Snippets in shells

Snippets may be used inside commandline interfaces like bash, zsh (GNU Linux/Unix-like) or powershell (MS Windows). Features like completion and placeholders substitution may or may not be supported.

Example

Consider the process of swapping the values of two variables, x and y. Assuming weak typing and not being concerned about name collision, this is represented by the code:

temp = x
x = y
y = temp

When the snippet is inserted, the programmer is prompted for the values of the two parameters. Assuming they are type foo and bar, which are the actual names of the variables they wish to swap, this will yield the code:

temp = foo
foo = bar
bar = temp

If the snippet is subsequently changed, say to use __temp instead of temp, it will not change the code that has already been inserted, but will be used in subsequent insertions of the snippet.

A snippet for this might be represented as:

temp = $1
$1 = $2
$2 = temp

Conventions

In addition to the basic management abilities described previously, snippet management features can be classified according to the scope of interactivity between snippets and the text editor or application that hosts them.

These snippet feature groups include:

  • plain-text or "static" snippets
  • interactive or "dynamic" snippets
  • scriptable snippets
Static
Snippets of this type consist primarily of fixed text that the user can choose to insert into the current document. The user is not able to specify anything else, except perhaps the cursor position relative to the newly inserted text. Static snippets are similar to simple macros, excepting that macro are often evaluated (or inserted) by a command-line program instead of IDE.
Dynamic
Snippets consist of fixed text combined with dynamic elements (placeholders) which are allowed to be modified either by editor or by user. The user may specify both the content of the dynamic elements, as well as their position relative to the fixed text, as part of choosing what to insert into the current document. Examples of dynamic elements could be variables such as the current date or system time, or input from the user that is supplied via a GUI, or input from another application. (see also: programmable macro).
Scriptable
Snippets consist of runnable segments of code in either a macro language or a scripting language. Scriptable snippets provide the greatest degree of flexibility to the user, although that depends somewhat on the programming languages supported by the text editor, and whether or not the programming language is well-known, or particular and unique to that specific editor.

The type of scripting support varies, but may include features such as running shell commands, providing a GUI dialog or other methods of user interaction with the operating system; other applications; or other sub-components of the hosting application itself.


Snippet placeholders

Placeholders are elements within a snippet that are left to be supplied by the user or other external process. The values for placeholders are not determined until the text of the snippet is inserted during an editing session.

Placeholders may have special markup syntax that allows the editor to identify the boundaries of placeholders relative to the other text in the current edit buffer.

Other applications employ graphical user interfaces and modal dialog boxes that allow the user to enter one or more values to be supplied for the placeholders.

Placeholder identifiers

Placeholders are usually indicated by some special character or sequence of characters to distinguish them from the rest of the snippet text. Some systems allow snippet placeholders to be named identifiers. The identifiers may be useful for supporting such features as placeholder duplication or placeholder transformation.

The following example uses the identifiers first_name, last_name, and item:

Hello {%first_name%} {%last_name%},

Your shipment of {%item%} is now ready to pick up.

Thanks {%first_name%}!

Example of a snippet in TexMate syntax:

Hello ${1:first_name} ${2:last_name},

Your shipment of ${3:item} is now ready to pick up.

Thanks ${4:first_name}!

Placeholder duplication

This allows the user to indicate that the value supplied for one placeholder should be replicated in multiple places, relative to the entire text of the programmable snippet. In the previous example, the named placeholder first_name is an example of this usage.

Placeholder transformation

This allows the user to indicate that one or more values supplied for a placeholder should be replicated and transformed in other places within the text of the programmable snippet. For example, the user may supply a document title in one part of the snippet, and specify that the document title should be repeated in other places, with the first instance being all-uppercase and every other instance being lower-case.

Snippet programming features

For applications that support scriptable snippets, the range of supported programming features varies. The following enumerates some of the features that are commonly implemented for programmable snippets.

Plain text

Although plain text is a fundamental feature included even with applications that support only non-programmable "static" snippets, programmable snippets are also used for working with plain text.

One common complication, however, is that environments that support programmable snippets often have to make distinctions between what counts as "plain text" and what counts as "programming instructions". Further complicating this distinction is the fact that applications that support programmable snippets almost always include support for recognition of multiple programming languages, either through basic syntax highlighting or execution of embedded commands.

For these and other reasons, emitting plain text from programmable snippets almost always entails being careful to avoid problems with syntax and delimiter collisions.

Constants and variables

Programmable snippets often include an ability to establish a binding to an existing variable scope or namespace, from which the user can select any of various constants or variables. These might include values such as the email address of the currently logged-in user on a given machine, the current system time and date, or the output value of a function.

Scriptable snippets are often associated with one or more currently active files. Consequently, variables may also include environment variables and arguments that specify the filename, cursor position, and parent directory among other stats relating to the files in a current editing session.

Interpreted code

Scriptable snippets may allow execution of code in one or more programming languages. This may include one or more standalone languages, or a language that is specific to the application in which the language is hosted.

Alternatives

The most basic alternative to code snippets is subroutines in libraries. Subroutines can be incorporated into a reusable software library and shared between multiple programming projects.

Design patterns in object-oriented programming, and functional programming, are both techniques that can allow programmers to avoid or reduce the practice of repeatedly inserting snippets into different pieces of code with slight variations each time. In languages in the C family, preprocessors are sometimes used for this purpose.

The disadvantage of this approach however is that it's harder to remember pattern or documentation.

Software assistance

As of 2021 some sophisticated deep-learning tooling emerged that can help to infer specific functionality from a human readable text and generate corresponding source code snippets (e.g. GitHub Copilot).[3][4]

See also

  • Engineering:Autocomplete – Computing feature predicting ending to a word a user is typing
  • Codebase – Source-code collection used to build a system, application, or component
  • Code refactoring – Restructuring existing computer code without changing its external behavior
  • Content management – Process of managing information or experiences built with an audience in mind
  • Pastebin – Type of online content hosting service where users can store plain text
  • Scrapbook (Mac OS) – Macintosh computer software
  • Version control – Activity of managing version of one or more files
  • Web widget – Applet intended to be used within web pages


References

  1. "Gedit/Plugins/Snippets". http://live.gnome.org/Gedit/Plugins/Snippets.  Example of the feature in the Gedit editor.
  2. Kim, Miryung; Bergman, Lawrence; Lau, Tessa; Notkin, David (2004). "An ethnographic study of copy and paste programming practices in OOPL". Proceedings: 2004 International Symposium on Empirical Software Engineering, ISESE 2004: 19–20 August 2004, Redondo Beach, California. Los Alamitos, CA: IEEE. pp. 83–92. ISBN 978-0-7695-2165-7. OCLC 326620442. http://pike.cs.ucla.edu/~miryung/Publications/isese04-copypaste.pdf. Retrieved 18 October 2016. "For each C&P instance, we also noted the relationship between a copied code snippet and code elsewhere in the code base." 
  3. H. M. LE, TRIET; CHEN, HAO; ALI BABAR, MUHAMMAD (2021). "Deep Learning for Source Code Modeling and Generation". ACM Computing Surveys (The University of Adelaide) 53 (3): 1–38. doi:10.1145/3383458. 
  4. "GitHub previews new AI tool that makes coding suggestions" (in en-US). https://social.techcrunch.com/2021/06/29/github-previews-new-ai-tool-that-makes-coding-suggestions/.