Code Snippets¶
The ability to reuse pieces of code allows users to avoid doing repetitive work, making the programming workflow more simple and productive. Elyra supports custom code snippets that can be added to the file editor.
You can manage code snippets using the JupyterLab UI or the Elyra CLI.
Managing code snippets using the JupyterLab UI¶
Code snippets can be listed, added, modified, duplicated, inserted, and removed in the Code Snippets panel.
To access the panel in JupyterLab:
Select the
Code Snippets
panel from the JupyterLab sidebar.OR
Open the JupyterLab command palette (
Cmd/Ctrl + Shift + C
) and search formanage code snippets
.
Creating a code snippet¶
To create a code snippet:
- Open the
Code Snippets
panel. - You can create a new code snippet in 3 ways:
- Click
+
. - Highlight the desired text in the editor, right click, and choose
Save As Code Snippet
from the context menu. - Select one or more cells, right click, and choose
Save As Code Snippet
from the context menu.- Use
Shift + Click
to select multiple cells. - When multiple cells are selected, their contents will be combined into a single snippet. Each cell’s contents will be separated by an empty line.
- If you want to make a snippet from one or more cells, there must not be any highlighted text. If text is highlighted, only the highlighted text will be added to the snippet. Any other selected cells will be ignored.
- Use
- Click
- Enter a code snippet display name, an optional description, and tag the code snippet to make it more easily discoverable.
- Define the code snippet. Refer to the Code snippet properties for details.
- Save the code snippet. The new code snippet entry is displayed in the list.
- Expand the entry to preview the snippet content.
Modifying a code snippet¶
To edit a code snippet:
- Open the
Code Snippets
panel. - Click the pencil next to the code snippet entry.
Duplicating a code snippet¶
To duplicate a code snippet:
- Open the
Code Snippets
panel. - Click the duplicate icon next to the code snippet entry.
- Follow the steps in ‘Modifying a code snippet’ to customize the duplicated code snippet.
Deleting a code snippet¶
To delete a code snippet:
- Open the
Code Snippets
panel. - Click the trash can next to the code snippet entry.
Using code snippets¶
To search for a code snippet, type a keyword in the search bar or select one or more tags.
To insert the code snippet content into an open editor, click the insert button or use drag and drop.
Code snippets are automatically added as code blocks in markdown files and notebook markdown cells. When inserting snippets into executable editors (e.g. a notebook code cell or a Python/R file editor), the extension will verify kernel language compatibility, warning the user when a mismatch is detected.
Managing code snippets using the Elyra CLI¶
You can list, create, edit, or delete code snippets using the elyra-metadata
CLI.
Listing code snippets¶
To list code snippets run
$ elyra-metadata list code-snippets
The output lists for each code snippet the name and the name of the associated JSON formatted metadata file, which is stored in the JupyterLab data directory in the metadata/code-snippets
subdirectory.
Available metadata instances for code-snippets (includes invalid):
Schema Instance Resource
--------- -------- --------
code-snippet preview_dataframe /.../metadata/code-snippets/preview_dataframe.json
To format the output as JSON run elyra-metadata list code-snippets --json
. Note that the JSON export includes the content of the metadata files, not just their names.
Creating a code snippet¶
To create a code snippet:
$ elyra-metadata create code-snippets \
--display_name "Preview DataFrame" \
--description "Preview Pandas DataFrame" \
--tags "['Python', 'Pandas']" \
--language "Python" \
--code "['df.head(5)']"
Refer to the Code snippet properties section for an explanation of the parameters.
Modifying a code snippet¶
To modify a code snippet:
$ elyra-metadata update code-snippets \
--name "preview_dataframe" \
--display_name "Preview DataFrame" \
--description "Preview Pandas DataFrame" \
--tags "['Python', 'Pandas']" \
--language "Python" \
--code "['# Display first 5 rows', 'df.head(5)']"
Refer to the Code snippet properties section for an explanation of the parameters. Note that you must specify the --name
parameter.
Exporting code snippets¶
To export code snippets:
$ elyra-metadata export code-snippets \
--directory "/tmp/foo"
The above example will export all code snippets to the “/tmp/foo/code-snippets” directory.
Note that you must specify the --directory
option.
There are two flags that can be specified when exporting code snippets:
- To include invalid code snippets, use the
--include-invalid
flag. - To clean out the export directory, use the
--clean
flag. Using the--clean
flag in the above example will empty the “/tmp/foo/code-snippets” directory before exporting the code snippets.
Importing code snippets¶
To import code snippets:
$ elyra-metadata import code-snippets \
--directory "/tmp/foo"
The above example will import all valid code snippets in the “/tmp/foo” directory (files present in any sub-directories will be ignored).
Note that you must specify the --directory
option.
By default, metadata will not be imported if a code snippet instance with the same name already exists. The --overwrite
flag can be used to override this default behavior and to replace any installed metadata with the newer file in the import directory.
Deleting a code snippet¶
To delete a code snippet run the following command, replacing the code snippet name as appropriate.
$ elyra-metadata remove code-snippets --name "preview_dataframe"
Code snippet properties¶
The string in the headings below, which is enclosed in parentheses, denotes the CLI option name.
Name (display_name)¶
A user-friendly name for the code snippet. This property is required.
Example: Preview DataFrame
N/A (name)¶
A unique identifier for this code snippet. If not specified when the code snippet is created, a value is automatically generated from display_name
.
Example: preview_dataframe
Description (description)¶
Description for this code snippet. This property is optional.
Example: Preview Pandas DataFrame
Tags (tags)¶
Zero or more tags for this code snippet. This property is optional.
Example: ['Python', 'Pandas']
Language (language)¶
Code snippet language name. Use one of the pre-defined values (Python
, Java
, R
, Scala
, and Markdown
) or provide a custom string. This property is required.
Example: Python
Code (code)¶
The code snippet, formatted as an array of strings. Each item in the array represents a line in the code. This property is required.
Example: ['# A Python comment', 'print(variable)']