YamlPeek 1.0.0

dotnet add package YamlPeek --version 1.0.0
NuGet\Install-Package YamlPeek -Version 1.0.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="YamlPeek" Version="1.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add YamlPeek --version 1.0.0
#r "nuget: YamlPeek, 1.0.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install YamlPeek as a Cake Addin
#addin nuget:?package=YamlPeek&version=1.0.0

// Install YamlPeek as a Cake Tool
#tool nuget:?package=YamlPeek&version=1.0.0

Yaml Icon YamlPeek MSBuild Task

Version Downloads License Build

Read values from yaml files using JSONPath query expressions.

Usage:

  <YamlPeek ContentPath="[YAML_FILE]" Query="[JSONPath]">
    <Output TaskParameter="Result" PropertyName="Value" />
  </YamlPeek>
  <YamlPeek Content="[YAML]" Query="[JSONPath]">
    <Output TaskParameter="Result" ItemName="Values" />
  </YamlPeek>

Parameters:

Parameter Description
Content Optional string parameter.<br/>Specifies the YAML input as a string.
ContentPath Optional ITaskItem parameter.<br/>Specifies the YAML input as a file path.
Query Required string parameter.<br/>Specifies the JSONPath expression.
Result Output ITaskItem[] parameter.<br/>Contains the results that are returned by the task.

You can either provide the path to a YAML file via ContentPath or provide the straight YAML content to Content. The Query is a JSONPath expression that is evaluated and returned via the Result task parameter. You can assign the resulting value to either a property (i.e. for a single value) or an item name (i.e. for multiple results).

YAML object properties are automatically projected as item metadata when assigning the resulting value to an item. For example, given the following JSON:

http:
  host: localhost
  port: 80
  ssl: true

You can read the entire http value as an item with each property as a metadata value with:

<YamlPeek ContentPath="host.yaml" Query="$.http">
    <Output TaskParameter="Result" ItemName="Http" />
</YamlPeek>

The Http item will have the following values (if it were declared in MSBuild):

<ItemGroup>
    <Http Include="[item raw json]">
        <host>localhost</host>
        <port>80</port>
        <ssl>true</ssl>
    </Http>
</ItemGroup>

These item metadata values could be read as MSBuild properties as follows, for example:

<PropertyGroup>
    <Host>@(Http -> '%(host)')</Host>
    <Port>@(Http -> '%(port)')</Port>
    <Ssl>@(Http -> '%(ssl)')</Ssl>
</PropertyGroup>

In addition to the explicitly opted in object properties, the entire node is available as raw YAML via the special _ (single underscore) metadata item.

There are no supported framework assets in this package.

Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.0.0 13,687 9/15/2021