Bullseye 5.0.0

dotnet add package Bullseye --version 5.0.0
NuGet\Install-Package Bullseye -Version 5.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="Bullseye" Version="5.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Bullseye --version 5.0.0
#r "nuget: Bullseye, 5.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 Bullseye as a Cake Addin
#addin nuget:?package=Bullseye&version=5.0.0

// Install Bullseye as a Cake Tool
#tool nuget:?package=Bullseye&version=5.0.0

Bullseye

Bullseye

NuGet version

Build status CodeQL analysis Lint Spell check

AppVeyor smoke test status CircleCI smoke test status Cirrus CI smoke test status GitLab CI/CD smoke test status

Bullseye is a .NET library that runs a target dependency graph.

Bullseye is primarily designed as a build tool for .NET projects, and is usually used together with SimpleExec, but Bullseye targets can do anything. They are not restricted to building .NET projects.

Platform support: .NET 6.0 and later.

Quick start

  • Next to an existing .NET solution (.sln file), add a .NET console app named targetsdotnet new console --name targets

  • Change to the new directory — cd targets

  • Add a reference to Bullseyedotnet add package Bullseye

  • Add a reference to SimpleExecdotnet add package SimpleExec

  • Replace the contents of targets/Program.cs with:

    using static Bullseye.Targets;
    using static SimpleExec.Command;
    
    Target("build", () => RunAsync("dotnet", "build --configuration Release --nologo --verbosity quiet"));
    Target("test", DependsOn("build"), () => RunAsync("dotnet", "test --configuration Release --no-build --nologo --verbosity quiet"));
    Target("default", DependsOn("test"));
    
    await RunTargetsAndExitAsync(args, ex => ex is SimpleExec.ExitCodeException);
    
  • Change to the solution directory — cd ..

  • Run the targets project — dotnet run --project targets.

Voilà! You've just written and run your first Bullseye build program. You will see output similar to:

<img src="https://github.com/adamralph/bullseye/assets/677704/2f598c2f-89ab-43dc-929a-59f4504dfa28" width="1088px" />

For help, run dotnet run --project targets --help.

Sample wrapper scripts

  • build (Linux and macOS)

    #!/usr/bin/env bash
    set -euo pipefail
    dotnet run --project targets -- "$@"
    
  • build.cmd (Windows)

    @echo Off
    dotnet run --project targets -- %*
    

Enumerable inputs

For example, you may want to run your test projects one by one, so that the timing of each one and which one, if any, failed, is displayed in the Bullseye build summary:

Target(
    "test",
    DependsOn("build"),
    ForEach("./FooTests.Acceptance", "./FooTests.Performance"),
    project => RunAsync($"dotnet", $"test {project} --configuration Release --no-build --nologo --verbosity quiet"));
dotnet run -- test

<img src="https://github.com/adamralph/bullseye/assets/677704/c25901c6-f30b-4632-8b62-fa3a755729fc" width="1085px" />

Command-line arguments

Generally, all the command-line arguments passed to Program.cs should be passed along to Bullseye, as shown in the quick start above (RunTargetsAndExitAsync(args);). This is because Bullseye effectively provides a command-line interface, with options for displaying a list of targets, performing dry runs, suppressing colour, and more. For full details of the command-line options, run your targets project supplying the --help (-h/-?) option:

dotnet run --project targets -- --help
./build --help
./build.cmd --help

You can also handle custom arguments in Program.cs, but you should ensure that only valid arguments are passed along to Bullseye and that the help text contains both your custom arguments and the arguments supported by Bullseye. A good way to do this is to use a command-line parsing package to define your custom arguments, and to provide translation between the package and Bullseye. For example, see the test projects for:

Non-static API

For most cases, the static API described above is sufficient. For more complex scenarios where a number of target collections are required, the non-static API may be used.

var targets1 = new Targets();
targets1.Add("foo", () => Console.Out.WriteLine("foo1"));

var targets2 = new Targets();
targets2.Add("foo", () => Console.Out.WriteLine("foo2"));

await targets1.RunWithoutExitingAsync(args);
await targets2.RunWithoutExitingAsync(args);

NO_COLOR

Bullseye supports NO_COLOR.

Who's using Bullseye?

To name a few:

Feel free to send a pull request to add your repository or organisation to this list!


<sub>Target by Franck Juncker from the Noun Project.</sub>

Product 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • net6.0

    • No dependencies.
  • net7.0

    • No dependencies.
  • net8.0

    • No dependencies.

NuGet packages (7)

Showing the top 5 NuGet packages that depend on Bullseye:

Package Downloads
Apprio.Enablement.Infrastructure

Package Description

Faithlife.Build The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

A build automation system using C# build scripts.

Apprio.Azure.Infrastructure

Package Description

DevOpsTargets

A tools that are helping when deploying .NET and other applications.

Xenial.Beer

Beer - Delicious dotnet build tools

GitHub repositories (45)

Showing the top 5 popular GitHub repositories that depend on Bullseye:

Repository Stars
IdentityServer/IdentityServer4
OpenID Connect and OAuth 2.0 Framework for ASP.NET Core
xunit/xunit
xUnit.net is a free, open source, community-focused unit testing tool for .NET.
elastic/elasticsearch-net
This strongly-typed, client library enables working with Elasticsearch. It is the official client maintained and supported by Elastic.
JasperFx/marten
.NET Transactional Document DB and Event Store on PostgreSQL
aaubry/YamlDotNet
YamlDotNet is a .NET library for YAML
Version Downloads Last updated
5.0.0 14,349 1/15/2024
5.0.0-rc.1 560 12/21/2023
5.0.0-alpha.2 863 9/25/2023
5.0.0-alpha.1 936 6/9/2023
4.2.1 142,534 1/24/2023
4.2.1-rc.1 537 12/3/2022
4.2.0 48,407 11/9/2022
4.2.0-beta.1 352 10/30/2022
4.1.1 26,770 10/22/2022
4.1.0 975 10/16/2022
4.1.0-rc.1 211 10/9/2022
4.1.0-alpha.2 370 8/28/2022
4.1.0-alpha.1 4,044 3/13/2022
4.0.0 152,706 3/12/2022
4.0.0-rc.3 282 3/11/2022
4.0.0-rc.2 5,073 12/30/2021
4.0.0-rc.1 268 12/23/2021
4.0.0-beta.1 2,868 11/7/2021
4.0.0-alpha.2 243 11/6/2021
4.0.0-alpha.1 551 9/19/2021
3.8.0 722,102 8/20/2021
3.8.0-rc.1 435 8/3/2021
3.8.0-beta.1 224 7/28/2021
3.8.0-alpha.2 192 7/25/2021
3.8.0-alpha.1 202 7/25/2021
3.7.1 29,100 7/12/2021
3.7.0 487,653 1/20/2021
3.7.0-alpha.1 554 1/7/2021
3.6.0 39,932 1/1/2021
3.6.0-rc.1 1,261 12/22/2020
3.6.0-beta.1 302 12/4/2020
3.5.0 92,168 9/19/2020
3.5.0-rc.1 414 9/4/2020
3.4.0 45,635 7/26/2020
3.4.0-alpha.1 441 6/24/2020
3.3.0 226,861 4/2/2020
3.3.0-beta.1 405 3/6/2020
3.2.0 13,299 2/20/2020
3.2.0-rc.1 397 2/9/2020
3.2.0-alpha.2 584 12/26/2019
3.2.0-alpha.1 368 12/23/2019
3.1.0 61,757 12/7/2019
3.1.0-rc.1 947 11/13/2019
3.1.0-alpha.1 506 10/16/2019
3.0.0 65,278 10/13/2019
3.0.0-rc.1 4,311 9/8/2019
3.0.0-beta.3 867 8/27/2019
3.0.0-beta.2 252 8/25/2019
3.0.0-beta.1 271 8/25/2019
3.0.0-alpha.1 267 8/24/2019
2.4.0 6,730 7/27/2019
2.4.0-rc.2 14,551 7/15/2019
2.4.0-rc.1 242 7/15/2019
2.4.0-beta.1 721 6/28/2019
2.4.0-alpha.1 2,257 6/1/2019
2.3.0 64,441 12/17/2018
2.3.0-rc.1 2,219 12/14/2018
2.3.0-beta.6 882 12/8/2018
2.3.0-beta.5 348 12/8/2018
2.3.0-beta.4 331 12/7/2018
2.3.0-beta.3 391 12/4/2018
2.3.0-beta.2 358 11/30/2018
2.3.0-beta.1 337 11/27/2018
2.3.0-alpha.1 417 11/2/2018
2.2.0 5,184 10/19/2018
2.2.0-rc.2 373 10/13/2018
2.2.0-rc.1 363 10/13/2018
2.2.0-beta.2 368 10/12/2018
2.2.0-beta.1 378 10/11/2018
2.1.0 6,580 10/9/2018
2.1.0-beta.1 385 10/7/2018
2.0.0 1,042 10/7/2018
2.0.0-rc.3 498 9/30/2018
2.0.0-rc.2 414 9/27/2018
2.0.0-rc.1 374 9/26/2018
1.3.0 1,631 9/20/2018
1.2.0 5,411 9/3/2018
1.2.0-rc.2 13,951 9/2/2018
1.2.0-rc.1 395 9/2/2018
1.1.0 1,122 8/23/2018
1.1.0-rc.2 493 8/13/2018
1.1.0-rc.1 504 8/12/2018
1.0.1 1,078 8/2/2018
1.0.0 1,711 7/27/2018
1.0.0-rc.5 683 6/28/2018
1.0.0-rc.4 611 6/26/2018
1.0.0-rc.3 527 6/26/2018
1.0.0-rc.2 552 6/24/2018
1.0.0-rc.1 2,000 5/6/2018
1.0.0-alpha0002 866 11/17/2017
1.0.0-alpha0001 891 11/17/2017