|
1 | | -# puppet-vscode |
| 1 | +<!-- |
| 2 | +TODO: Need correct marketplace ID |
| 3 | +[](https://marketplace.visualstudio.com/items?itemName=jpogran.Puppet) |
| 4 | +[](https://marketplace.visualstudio.com/items?itemName=jpogran.Puppet) |
| 5 | +--> |
2 | 6 |
|
3 | | -## Features |
| 7 | +# Puppet Language Support for Visual Studio Code |
4 | 8 |
|
5 | | -## Syntax Highlighting |
| 9 | +This extension provides Puppet Language support for [Visual Studio Code](https://code.visualstudio.com/) |
6 | 10 |
|
7 | | -- Puppet DSL |
8 | | -- Puppet grammar |
| 11 | +The extension is composed of the VS Code Extension in the [`client/`](client) directory and the Puppet Language Server in the [`server/`](server) directory |
9 | 12 |
|
10 | | -\!\[syntax\]\(images/syntax.png\) |
11 | 13 |
|
12 | | -## Snippet support |
| 14 | +## How to run the client and server for development |
13 | 15 |
|
14 | | -\!\[feature X\]\(images/snippets.png\) |
| 16 | +### Run the language server |
15 | 17 |
|
16 | | -## Puppet Linting support |
| 18 | +Follow the instructions in the server documentation - [How to run the Language Server for Develoment](server/READMEmd#How_to_run_the_Language_Server_for_Development). Ensure you use the `--timeout=0` and `--no-stop` arguments so the server does not stop. |
17 | 19 |
|
18 | | -On document save, puppet-lint will be run on the open file. |
| 20 | +### Run the client |
19 | 21 |
|
20 | | -\!\[feature X\]\(images/puppet-lint.png\) |
| 22 | +* Ensure nodejs is installed |
21 | 23 |
|
22 | | -## Requirements |
| 24 | +* Clone this repository |
23 | 25 |
|
24 | | -- puppet-lint installed and available on the PATH or path to binary set in extension settings. |
| 26 | +``` |
| 27 | +> git clone https://github.com/jpogran/puppet-vscode.git |
25 | 28 |
|
26 | | -## Extension Settings |
| 29 | +> cd puppet-vscode |
| 30 | +> cd client |
| 31 | +``` |
27 | 32 |
|
28 | | -This extension contributes the following settings: |
| 33 | +* Install the node modules and start VS Code |
29 | 34 |
|
30 | | -* `puppetLint.enable`: enable/disable this extension |
31 | | -* `puppetLint.path`: set to the path to puppet-lint |
| 35 | +``` |
| 36 | +> npm install |
| 37 | +... |
32 | 38 |
|
33 | | -## Known Issues |
| 39 | +> [email protected] postinstall C:\Source\puppet-vscode\client |
| 40 | +> node ./node_modules/vscode/bin/install |
34 | 41 |
|
35 | | -None yet. |
| 42 | +Detected VS Code engine version: ^1.10.0 |
| 43 | +Found minimal version that qualifies engine range: 1.10.0 |
| 44 | +Fetching vscode.d.ts from: https://raw.githubusercontent.com/Microsoft/vscode/1.10.0/src/vs/vscode.d.ts |
| 45 | +vscode.d.ts successfully installed! |
36 | 46 |
|
37 | | -## Release Notes |
| 47 | +> code . |
| 48 | +``` |
38 | 49 |
|
39 | | -**Note** Not released yet. WIP |
| 50 | +* Once VS Code is running, press `F5` to start a build and a new VS Code development instance should start |
40 | 51 |
|
41 | | -- syntax |
42 | | -- grammar |
43 | | -- linter |
| 52 | +* Open a Puppet file (.pp) and the client will start and connect to the Puppet Server |
44 | 53 |
|
45 | | -### 0.0.1 |
| 54 | +> Other Puppet VS Code extensions may cause issues with the development instance. Ensure that you either uninstall or disable the other Puppet extensions prior. |
46 | 55 |
|
47 | | -Initial release of the puppet extension. |
| 56 | +## Issues |
48 | 57 |
|
49 | | -### 0.0.2 |
50 | | - |
51 | | -Puppet Resource and Puppet Module commands. |
52 | | - |
53 | | -### 0.0.3 |
54 | | - |
55 | | -Puppet Parser validate linter added |
| 58 | +Please raise issues for the Language Server or Extension using the GitHub issue tracker. |
0 commit comments