Provides comprehensive YAML Language support to Visual Studio Code, via the yaml-language-server, with built-in Kubernetes and Kedge syntax support.
Supports JSON Schema 7 and below.
- YAML validation:
- Detects whether the entire file is valid yaml
- Detects errors such as:
- Node is not found
- Node has an invalid key node type
- Node has an invalid type
- Node is not a valid child node
- Document Outlining (Ctrl + Shift + O):
- Provides the document outlining of all completed nodes in the file
- Auto completion (Ctrl + Space):
- Auto completes on all commands
- Scalar nodes autocomplete to schema's defaults if they exist
- Hover support:
- Hovering over a node shows description if provided by schema
- Formatter:
- Allows for formatting the current file
Auto completion and hover support are provided by the schema. Please refer to Language Server Settings to setup a schema
The following settings are supported:
yaml.format.enable
: Enable/disable default YAML formatter (requires restart)yaml.format.singleQuote
: Use single quotes instead of double quotesyaml.format.bracketSpacing
: Print spaces between brackets in objectsyaml.format.proseWrap
: Always: wrap prose if it exeeds the print width, Never: never wrap the prose, Preserve: wrap prose as-isyaml.format.printWidth
: Specify the line length that the printer will wrap onyaml.validate
: Enable/disable validation featureyaml.hover
: Enable/disable hoveryaml.completion
: Enable/disable autocompletionyaml.schemas
: Helps you associate schemas with files in a glob patternyaml.schemaStore.enable
: When set to true the YAML language server will pull in all available schemas from JSON Schema Storeyaml.customTags
: Array of custom tags that the parser will validate against. It has two ways to be used. Either an item in the array is a custom tag such as "!Ref" and it will automatically map !Ref to scalar or you can specify the type of the object !Ref should be e.g. "!Ref sequence". The type of object can be either scalar (for strings and booleans), sequence (for arrays), map (for objects).[yaml]
: VSCode-YAML adds default configuration for all yaml files. More specifically it converts tabs to spaces to ensure valid yaml, sets the tab size, and allows live typing autocompletion. These settings can be modified via the corresponding settings inside the[yaml]
section in the settings:editor.insertSpaces
editor.tabSize
editor.quickSuggestions
In order to use the custom tags in your YAML file you need to first specify the custom tags in the setting of your code editor. For example, you can have the following custom tags:
"yaml.customTags": [
"!Scalar-example scalar",
"!Seq-example sequence",
"!Mapping-example mapping"
]
The !Scalar-example would map to a scalar custom tag, the !Seq-example would map to a sequence custom tag, the !Mapping-example would map to a mapping custom tag.
You can then use the newly defined custom tags inside the YAML file:
some_key: !Scalar-example some_value
some_sequence: !Seq-example
- some_seq_key_1: some_seq_value_1
- some_seq_key_2: some_seq_value_2
some_mapping: !Mapping-example
some_mapping_key_1: some_mapping_value_1
some_mapping_key_2: some_mapping_value_2
yaml.schemas applies a schema to a file. In other words, the schema (placed on the left) is applied to the glob pattern on the right. Your schema can be local or online. Your schema must be a relative path and not an absolute path.
When associating a schema it should follow the format below
"yaml.schemas": {
"url": "globPattern",
"Kubernetes": "globPattern",
"kedge": ["globPattern", "globPattern2"]
}
e.g.
"yaml.schemas": {
"http://json.schemastore.org/composer": ["/*"],
"file:///home/johnd/some-schema.json": ["some.yaml"],
"../relative/path/schema.json": ["/config*.yaml"],
}
e.g.
"yaml.schemas": {
"kubernetes": ["/myYamlFile.yaml"]
}
e.g.
"yaml.schemas": {
"kedge": ["/myKedgeApp.yaml"]
}
e.g.
"yaml.schemas": {
"http://json.schemastore.org/composer": ["/*"],
"kubernetes": ["/myYamlFile.yaml"]
}
- The entrance point for
yaml.schemas
is location in user and workspace settings - Supports schemas through schema store as well as any other schema url
- Supports 'yamlValidation' point which allows you to contribute a schema for a specific type of yaml file (Similar to jsonValidation) e.g.
{
"contributes": {
"yamlValidation": [
{
"fileMatch": "yourfile.yml",
"url": "./schema.json"
}
]
}
}
This extension allows you to specify json schemas that you want to validate against the yaml that you write. In the vscode user and workspace preferences you can set a url and a glob pattern that you want to validate against the schema. Kubernetes and kedge are optional fields. They do not require a url as the language server will provide that. You just need the keywords kubernetes/kedge and a glob pattern.
- Install prerequisites:
- latest Visual Studio Code
- Node.js v6.0.0 or higher
- Fork and clone this repository and go into the folder
$ cd vscode-yaml
- Install the dependencies
$ npm install
- Compile the Typescript to Javascript
$ npm run compile
- Open the client in vscode
- Make changes as neccessary and the run the code using F5
-
Download both the Yaml Language Server and this VSCode Yaml Client.
-
Create a project with the directories in the following structure.
ParentFolder/
├──── vscode-yaml/
├──── yaml-language-server/
-
Run
npm install
in both directories to initializenode_modules
dependencies. -
In
vscode-yaml/src/extension.ts
set theserverModule
variable to:serverModule = context.asAbsolutePath(path.join("..", "yaml-language-server", "out", "server", "src", "server.js"));
This will redirect which YAML LS to use.
-
In BOTH directories run:
npm run compile
-
To run the language server in VSCode, click
View -> Debug
, then from the drop down menu beside the green arrow selectLaunch Extension (vscode-yaml)
, click the arrow, and a new VSCode window should load with the YAML LS running. -
To debug the language server in VSCode, from the same drop down menu select
Attach (yaml-language-server)
, and click the green arrow to start. Ensure you've opened a YAML file or else the server would have not yet started.
Note: Disable or remove any existing implementations of the YAML Language server from VSCode or there will be conflicts.
- To develop the language server visit https://github.com/redhat-developer/yaml-language-server
Refer to VS Code documentation on how to run and debug the extension
To obtain and install the latest release from github you can:
- First download the latest *.vsix file from Github Releases section
- Inside of VSCode navigate to the extension tab and click the three elipses (...).
- Click install from VSIX and provide the location of the *.vsix that was downloaded
All contributions are welcome!