Provides comprehensive YAML Language support to Visual Studio Code, via the yaml-language-server, with built-in Kubernetes syntax support.

Enables auto formatting of the code when you save a file. Visual Studio supports auto formatting of the code with the CTRL+E,D or CTRL+E,F key shortcuts but with this extension the command 'Format Document' is executed on Save. Note: I highly recommend you to use EditorConfig. @olivertech2016 Store it on your external USB device and retrieve it on your Mac. Or use a cloud service. I think there're several manners to move your files from Windows to Mac and then reverse it. Moreover, I tested your storyboard on my Visual Studio 2019 for Windows it works properly. Have you checked my attachment?

Studio

Features

  1. 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
  2. Document Outlining (Ctrl + Shift + O):
    • Provides the document outlining of all completed nodes in the file
  3. Auto completion (Ctrl + Space):
    • Auto completes on all commands
    • Scalar nodes autocomplete to schema's defaults if they exist
  4. Hover support:
    • Hovering over a node shows description if provided by schema
  5. Formatter:
    • Allows for formatting the current file
    • On type formatting auto indent for array items
Visual studio mac auto formation

Auto completion and hover support are provided by the schema. Please refer to Language Server Settings to setup a schema

Extension Settings

The following settings are supported:

Visual Studio Mac Auto Formatting

  • yaml.format.enable: Enable/disable default YAML formatter (requires restart)
  • yaml.format.singleQuote: Use single quotes instead of double quotes
  • yaml.format.bracketSpacing: Print spaces between brackets in objects
  • yaml.format.proseWrap: Always: wrap prose if it exeeds the print width, Never: never wrap the prose, Preserve: wrap prose as-is
  • yaml.format.printWidth: Specify the line length that the printer will wrap on
  • yaml.validate: Enable/disable validation feature
  • yaml.hover: Enable/disable hover
  • yaml.completion: Enable/disable autocompletion
  • yaml.schemas: Helps you associate schemas with files in a glob pattern
  • yaml.schemaStore.enable: When set to true the YAML language server will pull in all available schemas from JSON Schema Store
  • yaml.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), mapping (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 and formatting, also allows code lens. These settings can be modified via the corresponding settings inside the [yaml] section in the settings:
    • editor.tabSize
    • editor.formatOnType
  • http.proxy: The URL of the proxy server that will be used when attempting to download a schema. If it is not set or it is undefined no proxy server will be used.
  • http.proxyStrictSSL: If true the proxy server certificate should be verified against the list of supplied CAs. Default is false.

Adding custom tags

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:

Visual Studio Mac Vs Windows

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:

Associating schemas

YAML Language support uses JSON Schemas to understand the shape of a YAML file, including its value sets, defaults and descriptions. The schema support is shipped with JSON Schema Draft 7.

We support schemas provided through JSON Schema Store. However, schemas can also be defined in a workspace.

The association of a YAML file to a schema can be done either in the YAML file itself using a modeline or in the User or Workspace settings under the property yaml.schemas.

Associating a schema in the YAML file

It is possible to specify a yaml schema using a modeline.

Associating a schema to a glob pattern via yaml.schemas:

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. The entrance point for yaml.schemas is location in user and workspace settings

When associating a schema it should follow the format below

e.g.

e.g.

e.g.

On Windows with full path:

On Mac/Linux with full path:

Since 0.11.0 YAML Schemas can be used for validation:

A schema can be associated with multiple globs using a json array, e.g.

e.g.

e.g.

e.g.

Multi root schema association:

You can also use relative paths when working with multi root workspaces.

Suppose you have a multi root workspace that is laid out like:

You must then associate schemas relative to the root of the multi root workspace project.

yaml.schemas allows you to specify json schemas that you want to validate against the yaml that you write. Kubernetes is a reserved keyword field. It does not require a url as the language server will provide that. You just need the keyword kubernetes and a glob pattern.

Mapping a schema in an extension

  • Supports yamlValidation point which allows you to contribute a schema for a specific type of yaml file (Similar to jsonValidation)e.g.

How to contribute

The instructions are available in the contribution guide.

Default Formatter

Code formatting is supported using either one of yapf or autopep8.
The default code format provider is autopep8.

Auto Formatting

Formatting the source code as and when you save the contents of the file is supported.
Enabling this requires configuring the setting 'editor.formatOnSave': true as identified here.

Paths

All samples provided here are for windows.
However Mac/Linux paths are also supported.

AutoPep8

You can configure the format provider by changing a setting in the User or Workspace settings file as follows:

Installing autopep8

Custom Path

This is generally unnecessary. As the Extension will resolve the path to the formatter based on Python executable being used or configured in python.pythonPath of settings.json. If this cannot be found, then the formatter will be resolved based on the current environment Path settings.

If this is not the case or you wish to use another version of autopep8, all you need to do is configure the path as follows either in the User or Workspace settings file:

Yapf

You can configure the format provider by changing a setting in the User or Workspace settings file as follows:

Custom Path

This is generally unnecessary. As the Extension will resolve the path to the formatter based on Python executable being used or configured in python.pythonPath of settings.json. If this cannot be found, then the formatter will be resolved based on the current environment Path settings.

If this is not the case or you wish to use another version of yapf, all you need to do is configure the path as follows either in the User or Workspace settings file:

Custom arguments to Yapf

Custom arguments can be passed into yaps by configuring the settings in the User or Workspace settings as follows:

Auto

Installing Yapf

Visual studio mac os

pip install yapf