Skip to content

Commit 3c6ea9a

Browse files
Merge pull request #383 from jpogran/GH-323-gif-the-readme
(GH-323) Update the readme with gifs
2 parents 9f2d220 + 9551e01 commit 3c6ea9a

11 files changed

+26
-7
lines changed

README.md

Lines changed: 26 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -61,8 +61,6 @@ This extension provides full Puppet Language support for [Visual Studio Code](ht
6161

6262
**It is currently in technical preview, so that we can gather bug reports and find out what new features to add.**
6363

64-
![Example of features](https://raw.githubusercontent.com/lingua-pupuli/puppet-vscode/master/docs/assets/language_server.gif)
65-
6664
## Requirements
6765

6866
You will need to have the [Puppet Agent](https://puppet.com/docs/puppet/4.10/about_agent.html) or [Puppet Development Kit (PDK)](https://puppet.com/docs/pdk/1.x/pdk.html) installed in order to fully use this extension.
@@ -97,14 +95,20 @@ Syntax highlighting recognizes all versions of Puppet and displays as you type.
9795
- Puppet Grammar
9896
- Module metadata files
9997

98+
![syntax_highlighting](https://raw.githubusercontent.com/lingua-pupuli/puppet-vscode/master/docs/assets/syntax_highlighting.png)
99+
100100
### Auto Completion
101101

102102
Auto complete Puppet types and classes and their parameter sets as you type. Tab completion works as you would expect.
103103

104+
![auto_complete](https://raw.githubusercontent.com/lingua-pupuli/puppet-vscode/master/docs/assets/auto_complete.gif)
105+
104106
### Hover Support
105107

106108
Hovering over any resource, class declaration or other Puppet symbol provides instant contextual information. For example, hovering over the resource declaration lists the type name and parameter list, with all relevant help text.
107109

110+
![hover_support](https://raw.githubusercontent.com/lingua-pupuli/puppet-vscode/master/docs/assets/hover_support.gif)
111+
108112
### Code Snippets
109113

110114
As part of IntelliSense and Snippets, you can quickly create templates to automate repetitive series of code.
@@ -127,6 +131,8 @@ You can import existing resources directly using `puppet resource`
127131

128132
The information returned will be pasted into the open editor window where your cursor is resting, or at the begining of an empty file.
129133

134+
![puppet_resource](https://raw.githubusercontent.com/lingua-pupuli/puppet-vscode/master/docs/assets/puppet_resource.gif)
135+
130136
#### Puppet Node Graph preview
131137

132138
You can preview the [node graph](https://puppet.com/blog/visualize-your-infrastructure-models) of a manifest while you edit your Puppet Code.
@@ -137,6 +143,8 @@ You can preview the [node graph](https://puppet.com/blog/visualize-your-infrastr
137143

138144
The node graph will appear next to the manifest
139145

146+
![puppet_node_graph](https://raw.githubusercontent.com/lingua-pupuli/puppet-vscode/master/docs/assets/puppet_node_graph.gif)
147+
140148
### Puppet Development Kit Support
141149

142150
You can use the [Puppet Development Kit](https://puppet.com/blog/develop-modules-faster-new-puppet-development-kit) inside VS Code from the command palette. To use any of the above commands, open the command palette and start typing a command. You can also use the right-click context menu or the editor menu to reach these commands.
@@ -149,18 +157,26 @@ You can use the [Puppet Development Kit](https://puppet.com/blog/develop-modules
149157

150158
`PDK New Module` is available even if the extension isn't loaded, the rest of the commands are only available when the extension is loaded.
151159

160+
![pdk_new_module](https://raw.githubusercontent.com/lingua-pupuli/puppet-vscode/master/docs/assets/pdk_new_module.gif)
161+
152162
#### PDK new class
153163

154164
You can create new classes using PDK using the VS Code command palette. This functionality is only available when a Puppet file has already been opened, to trigger the extension.
155165

166+
![pdk_new_class](https://raw.githubusercontent.com/lingua-pupuli/puppet-vscode/master/docs/assets/pdk_new_class.gif)
167+
156168
#### PDK validate
157169

158170
You can initiate a valiadtion of your module using PDK using the VS Code command palette. This functionality is only available when a Puppet file has already been opened, to trigger the extension.
159171

172+
![pdk_validate](https://raw.githubusercontent.com/lingua-pupuli/puppet-vscode/master/docs/assets/pdk_validate.gif)
173+
160174
#### PDK test unit
161175

162176
You can run the test suite of your module using PDK using the VS Code command palette. This functionality is only available when a Puppet file has already been opened, to trigger the extension.
163177

178+
![pdk_test_unit](https://raw.githubusercontent.com/lingua-pupuli/puppet-vscode/master/docs/assets/pdk_test_unit.gif)
179+
164180
### Debugging Puppet manifests
165181

166182
**Note - This is an experimental feature**
@@ -175,6 +191,9 @@ The Puppet extension is able to debug the compilation of a Puppet manifest; much
175191
* Limited interactive debug console. For example, you can assign a variable a value, but just as in regular Puppet you can't change its value later
176192
* Step In, Out, and Over
177193

194+
195+
![Puppet Debug Adapter](https://raw.githubusercontent.com/lingua-pupuli/puppet-vscode/master/docs/assets/puppet_debug.gif)
196+
178197
The debugging features in the extension are based on the excellent ideas in [puppet-debugger](https://www.puppet-debugger.com/) by [Corey Osman](https://github.com/nwops).
179198

180199
#### Configuring the debug session
@@ -185,18 +204,18 @@ The [VSCode Debugging - Launch Configurations](https://code.visualstudio.com/doc
185204

186205
#### Settings
187206

188-
`manifest` - The manifest to apply. By default this is the currently open file in the editor
189-
190-
`noop` - Whether the `puppet apply` sets No Operation (Noop) mode. By default, this is set to true. This means when running the debugger it will not make changes to your system. The [documentation about the puppet agent](https://puppet.com/docs/puppet/5.3/man/apply.html#OPTIONS) has more information about `puppet apply` and and the `noop` option.
207+
- `manifest` - The manifest to apply. By default this is the currently open file in the editor
191208

192-
`args` - Additional arguements to pass to `puppet apply`, for example `['--debug']` will output debug information
209+
- `noop` - Whether the `puppet apply` sets No Operation (Noop) mode. By default, this is set to true. This means when running the debugger it will not make changes to your system. The [documentation about the puppet agent](https://puppet.com/docs/puppet/5.3/man/apply.html#OPTIONS) has more information about `puppet apply` and and the `noop` option.
193210

194-
![Puppet Debug Adapter](https://raw.githubusercontent.com/lingua-pupuli/puppet-vscode/master/docs/assets/puppet_debug.gif)
211+
- `args` - Additional arguements to pass to `puppet apply`, for example `['--debug']` will output debug information
195212

196213
## Installing the Extension
197214

198215
You can install the official release of the Puppet extension by following the steps in the [Visual Studio Code documentation](https://code.visualstudio.com/docs/editor/extension-gallery). In the Extensions pane, search for "puppet-vscode" extension and install it there. You will get notified automatically about any future extension updates!
199216

217+
![extension_install](https://raw.githubusercontent.com/lingua-pupuli/puppet-vscode/master/docs/assets/extension_install.gif)
218+
200219
You can also install the extension without access to the internet by following these [instructions](https://code.visualstudio.com/docs/editor/extension-gallery#_install-from-a-vsix.)
201220

202221
## Configuration

docs/assets/auto_complete.gif

1.03 MB
Loading

docs/assets/extension_install.gif

526 KB
Loading

docs/assets/hover_support.gif

992 KB
Loading

docs/assets/pdk_new_class.gif

307 KB
Loading

docs/assets/pdk_new_module.gif

691 KB
Loading

docs/assets/pdk_test_unit.gif

140 KB
Loading

docs/assets/pdk_validate.gif

184 KB
Loading

docs/assets/puppet_node_graph.gif

1.74 MB
Loading

docs/assets/puppet_resource.gif

222 KB
Loading

0 commit comments

Comments
 (0)