Sharpliner 1.6.0
See the version list below for details.
dotnet add package Sharpliner --version 1.6.0
NuGet\Install-Package Sharpliner -Version 1.6.0
<PackageReference Include="Sharpliner" Version="1.6.0" />
paket add Sharpliner --version 1.6.0
#r "nuget: Sharpliner, 1.6.0"
// Install Sharpliner as a Cake Addin #addin nuget:?package=Sharpliner&version=1.6.0 // Install Sharpliner as a Cake Tool #tool nuget:?package=Sharpliner&version=1.6.0
Sharpliner is a .NET library that lets you use C# for Azure DevOps pipeline definition instead of YAML. Exchange YAML indentation problems for the type-safe environment of C# and let the intellisense speed up your work!
Getting started
All you have to do is reference our NuGet package in your project, override a class with your definition and dotnet build
the project! Dead simple!
For more detailed steps, check our documentation.
Example
// Just override prepared abstract classes and `dotnet build` the project, nothing else is needed!
// For a full list of classes you can override
// see https://github.com/sharpliner/sharpliner/blob/main/src/Sharpliner/AzureDevOps/PublicDefinitions.cs
// You can also generate collections of definitions dynamically
// see https://github.com/sharpliner/sharpliner/blob/main/docs/AzureDevOps/DefinitionCollections.md
class PullRequestPipeline : SingleStagePipelineDefinition
{
// Say where to publish the YAML to
public override string TargetFile => "eng/pr.yml";
public override TargetPathType TargetPathType => TargetPathType.RelativeToGitRoot;
public override SingleStagePipeline Pipeline => new()
{
Pr = new PrTrigger("main"),
Variables =
[
// YAML ${{ if }} conditions are available with handy macros that expand into the
// expressions such as comparing branch names. We also have "else"
If.IsBranch("net-6.0")
.Variable("DotnetVersion", "6.0.100")
.Group("net6-keyvault")
.Else
.Variable("DotnetVersion", "5.0.202"),
],
Jobs =
{
new Job("Build")
{
Pool = new HostedPool("Azure Pipelines", "windows-latest"),
Steps =
[
// Many tasks have helper methods for shorter notation
DotNet.Install.Sdk(variables["DotnetVersion"]),
// You can also specify any pipeline task in full too
Task("DotNetCoreCLI@2", "Build and test") with
{
Inputs = new()
{
{ "command", "test" },
{ "projects", "src/MyProject.sln" },
}
},
// Frequently used ${{ if }} statements have readable macros
If.IsPullRequest
// You can load script contents from a .ps1 file and inline them into YAML
// This way you can write scripts with syntax highlighting separately
.Step(Powershell.FromResourceFile("New-Report.ps1", "Create build report")),
]
}
},
};
}
Sharpliner features
Apart from the obvious benefits of using static type language with IDE support, not having to have to deal with indentation problems ever again, being able to split the code easily or the ability to generate YAML programatically, there are several other benefits of using Sharpliner.
Intellisense
One of the best things when using Sharpliner is that you won't have to go the YAML reference every time you're adding a new piece of your pipeline. Having everything strongly typed will make your IDE give you hints all the way!
Nice APIs
Imagine you want to install the .NET SDK. For that, Azure Pipelines have the DotNetCoreCLI@2
task.
However, this task's specification is quite long since the task does many things:
# .NET Core
# Build, test, package, or publish a dotnet application, or run a custom dotnet command
# https://docs.microsoft.com/en-us/azure/devops/pipelines/tasks/build/dotnet-core-cli?view=azure-devops
- task: DotNetCoreCLI@2
inputs:
command: 'build' # Options: build, push, pack, publish, restore, run, test, custom
publishWebProjects: true # Required when command == Publish
projects: # Optional
custom: # Required when command == Custom
arguments: # Optional
publishTestResults: true # Optional
testRunTitle: # Optional
zipAfterPublish: true # Optional
versioningScheme: 'off' # Options: off, byPrereleaseNumber, byEnvVar, byBuildNumber
versionEnvVar: # Required when versioningScheme == byEnvVar
majorVersion: '1' # Required when versioningScheme == ByPrereleaseNumber
minorVersion: '0' # Required when versioningScheme == ByPrereleaseNumber
patchVersion: '0' # Required when versioningScheme == ByPrereleaseNumber
buildProperties: # Optional
verbosityPack: 'Detailed' # Options: -, quiet, minimal, normal, detailed, diagnostic
workingDirectory:
Notice how some of the properties are only valid in a specific combination with other. With Sharpliner, we remove some of this complexity using nice fluent APIs:
DotNet.Install.Sdk(parameters["version"]),
DotNet.Restore.FromFeed("dotnet-7-preview-feed", includeNuGetOrg: false) with
{
ExternalFeedCredentials = "feeds/dotnet-7",
NoCache = true,
RestoreDirectory = ".packages",
},
DotNet.Build("src/MyProject.csproj") with
{
Timeout = TimeSpan.FromMinutes(20)
},
Useful macros
Some very common pipeline patterns such as comparing the current branch name or detecting pull requests are very cumbersome to do in YAML (long conditions full of complicated ${{ if }}
syntax).
For many of these, we have handy macros so that you get more readable and shorter code.
For example this YAML
${{ if eq(variables['Build.SourceBranch'], 'refs/heads/production') }}:
name: rg-suffix
value: -pr
${{ if ne(variables['Build.SourceBranch'], 'refs/heads/production') }}:
name: rg-suffix
value: -prod
can become this C#
If.IsBranch("production")
.Variable("rg-suffix", "-pr")
.Else
.Variable("rg-suffix", "-prod")
Re-usable pipeline blocks
Sharpliner lets you re-use code more easily than YAML templates do. Apart from obvious C# code re-use, you can also define sets of C# building blocks and re-use them in your pipelines:
class ProjectBuildSteps : StepLibrary
{
public override List<Conditioned<Step>> Steps =>
[
DotNet.Install.Sdk("6.0.100"),
If.IsBranch("main")
.Step(DotNet.Restore.Projects("src/MyProject.sln")),
DotNet.Build("src/MyProject.sln"),
];
}
You can then reference this library in between build steps and it will get expanded into the pipeline's YAML:
new Job("Build")
{
Steps =
[
Script.Inline("echo 'Hello World'"),
StepLibrary<ProjectBuildSteps>(),
Script.Inline("echo 'Goodbye World'"),
]
}
...
More about this feature can be found here (DefinitionLibraries.md).
Sourcing scripts from files
When you need to add cmd, PowerShell or bash steps into your pipeline, mainatining these bits inside YAML can be error prone.
With Sharpliner you can keep scripts in their own files (.ps1
, .sh
..) where you get the natural environment you're used to such as syntax highlighting.
Sharpliner gives you APIs to load these on build time and include them inline:
Steps =
[
Bash.FromResourceFile("embedded-script.sh") with
{
DisplayName = "Run post-build clean-up",
Timeout = TimeSpan.FromMinutes(5),
}
]
Correct variable/parameter types
Frequent struggle people have with Azure pipelines is using the right type of variable in the right context.
Be it a ${{ compile time parameter }}
, a variable['used in runtime']
or a $(macro)
syntax, with Sharpliner you won't have to worry about which one to pick as it understands the context and selects the right one for you.
Pipeline validation
Your pipeline definition can be validated during publishing and you can uncover issues, such as typos inside dependsOn
, you would only find by trying to run the pipeline in CI.
This gives you a faster dev loop and greater productivity.
We are continuosly adding new validations as we find new error-prone spots. Each validation can be individually configured/silenced in case you don't wish to take advantage of these:
class YourCustomConfiguration : SharplinerConfiguration
{
public override void Configure()
{
// You can set severity for various validations
Validations.DependsOn = ValidationSeverity.Off;
Validations.Name = ValidationSeverity.Warning;
// You can also further customize serialization
Serialization.PrettifyYaml = false;
Serialization.UseElseExpression = true;
Serialization.IncludeHeaders = false;
// You can add hooks that execute during the publish process
Hooks.BeforePublish = (definition, path) => {};
Hooks.AfterPublish = (definition, path) => {};
}
}
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 is compatible. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. |
-
net6.0
- Microsoft.Build.Framework (>= 17.9.5)
- Microsoft.Build.Utilities.Core (>= 17.9.5)
- OneOf (>= 3.0.263)
- OneOf.SourceGenerator (>= 3.0.263)
- YamlDotNet (>= 16.1.3)
-
net7.0
- Microsoft.Build.Framework (>= 17.9.5)
- Microsoft.Build.Utilities.Core (>= 17.9.5)
- OneOf (>= 3.0.263)
- OneOf.SourceGenerator (>= 3.0.263)
- YamlDotNet (>= 16.1.3)
-
net8.0
- Microsoft.Build.Framework (>= 17.9.5)
- Microsoft.Build.Utilities.Core (>= 17.9.5)
- OneOf (>= 3.0.263)
- OneOf.SourceGenerator (>= 3.0.263)
- YamlDotNet (>= 16.1.3)
-
net9.0
- Microsoft.Build.Framework (>= 17.9.5)
- Microsoft.Build.Utilities.Core (>= 17.9.5)
- OneOf (>= 3.0.263)
- OneOf.SourceGenerator (>= 3.0.263)
- YamlDotNet (>= 16.1.3)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories (1)
Showing the top 1 popular GitHub repositories that depend on Sharpliner:
Repository | Stars |
---|---|
sharpliner/sharpliner
Use C# instead of YAML to define your Azure DevOps pipelines
|
Version | Downloads | Last updated |
---|---|---|
1.6.5 | 68 | 12/16/2024 |
1.6.4 | 252 | 12/2/2024 |
1.6.3 | 96 | 11/26/2024 |
1.6.2 | 111 | 11/24/2024 |
1.6.1 | 242 | 11/18/2024 |
1.6.0 | 86 | 11/16/2024 |
1.5.22 | 136 | 10/27/2024 |
1.5.21 | 473 | 10/2/2024 |
1.5.20 | 262 | 7/25/2024 |
1.5.19 | 81 | 7/25/2024 |
1.5.18 | 2,235 | 5/17/2024 |
1.5.17 | 79 | 5/16/2024 |
1.5.16 | 185 | 5/2/2024 |
1.5.15 | 438 | 4/22/2024 |
1.5.14 | 164 | 4/16/2024 |
1.5.13 | 138 | 4/15/2024 |
1.5.12 | 120 | 4/15/2024 |
1.5.11 | 149 | 4/6/2024 |
1.5.10 | 129 | 4/2/2024 |
1.5.9 | 478 | 2/16/2024 |
1.5.8 | 147 | 2/13/2024 |
1.5.7 | 705 | 1/13/2024 |
1.5.6 | 419 | 11/16/2023 |
1.5.5 | 5,323 | 4/19/2023 |
1.5.4 | 243 | 4/19/2023 |
1.5.3 | 242 | 4/10/2023 |
1.5.2 | 1,371 | 3/8/2023 |
1.5.1 | 390 | 3/5/2023 |
1.5.0 | 333 | 2/12/2023 |
1.4.12 | 677 | 1/31/2023 |
1.4.11 | 322 | 1/31/2023 |
1.4.10 | 359 | 1/30/2023 |
1.4.9 | 601 | 12/29/2022 |
1.4.8 | 400 | 11/20/2022 |
1.4.7 | 2,562 | 10/28/2022 |
1.4.6 | 433 | 10/28/2022 |
1.4.5 | 512 | 10/18/2022 |
1.4.4 | 532 | 9/16/2022 |
1.4.3 | 452 | 9/7/2022 |
1.4.2 | 471 | 9/1/2022 |
1.4.1 | 476 | 8/31/2022 |
1.3.7 | 488 | 8/26/2022 |
1.3.6 | 506 | 8/14/2022 |
1.3.5 | 536 | 7/11/2022 |
1.3.4 | 524 | 5/13/2022 |
1.3.3 | 560 | 4/17/2022 |
1.3.2 | 493 | 4/3/2022 |
1.3.1 | 655 | 3/15/2022 |
1.3.0 | 516 | 3/13/2022 |
1.2.9 | 540 | 3/5/2022 |
1.2.8 | 518 | 2/26/2022 |
1.2.7 | 531 | 2/17/2022 |
1.2.6 | 3,752 | 2/14/2022 |
1.2.5 | 503 | 2/11/2022 |
1.2.4 | 372 | 12/15/2021 |
1.2.3 | 350 | 12/5/2021 |
1.2.1 | 1,650 | 11/28/2021 |
1.2.0 | 1,406 | 11/28/2021 |
1.1.2 | 5,501 | 11/23/2021 |
1.1.1 | 405 | 11/18/2021 |
1.1.0 | 393 | 11/15/2021 |
1.0.2 | 423 | 11/8/2021 |
1.0.0 | 482 | 11/6/2021 |
0.3.9 | 418 | 11/4/2021 |
0.3.8 | 405 | 11/1/2021 |
0.3.7 | 423 | 10/24/2021 |
0.3.6 | 474 | 10/20/2021 |
0.3.5 | 415 | 10/20/2021 |
0.3.4 | 409 | 10/17/2021 |
0.3.3 | 471 | 10/16/2021 |
0.3.2 | 399 | 10/14/2021 |
0.3.1 | 372 | 10/14/2021 |
0.3.0 | 441 | 10/14/2021 |
0.2.2 | 381 | 8/30/2021 |
0.2.1 | 406 | 8/22/2021 |
0.2.0 | 403 | 8/22/2021 |
0.1.1 | 553 | 7/24/2021 |
0.1.0 | 480 | 7/24/2021 |