Anarchy.Toolkit.Build.Fallout
3.0.0
See the version list below for details.
dotnet add package Anarchy.Toolkit.Build.Fallout --version 3.0.0
NuGet\Install-Package Anarchy.Toolkit.Build.Fallout -Version 3.0.0
<PackageReference Include="Anarchy.Toolkit.Build.Fallout" Version="3.0.0" />
<PackageVersion Include="Anarchy.Toolkit.Build.Fallout" Version="3.0.0" />
<PackageReference Include="Anarchy.Toolkit.Build.Fallout" />
paket add Anarchy.Toolkit.Build.Fallout --version 3.0.0
#r "nuget: Anarchy.Toolkit.Build.Fallout, 3.0.0"
#:package Anarchy.Toolkit.Build.Fallout@3.0.0
#addin nuget:?package=Anarchy.Toolkit.Build.Fallout&version=3.0.0
#tool nuget:?package=Anarchy.Toolkit.Build.Fallout&version=3.0.0
Anarchy.Toolkit.Build.Fallout
Reusable Fallout build components for .NET repositories.
dotnet add build/_build.csproj package Anarchy.Toolkit.Build.Fallout
Implement the components appropriate to your repository on a FalloutBuild class. For example, a package-only build can implement INuGetBuild, ILayeringBuild, IDependencyMapBuild, IDependencyUpgradeBuild and IGitHooksBuild, with an empty Artifacts collection. Use IBoilerplateBuild for scaffolding, or add the container (IContainerBuild, IDockerBuild) components as needed. External deployment and publication targets require their respective tools and credentials.
using Anarchy.Toolkit.Build.Fallout.Component;
using Anarchy.Toolkit.Build.Fallout.Core.Entity.Build;
using Anarchy.Toolkit.Build.Fallout.Infrastructure.Extension;
using Fallout.Common;
class Build : FalloutBuild, INuGetBuild, ILayeringBuild, IDependencyMapBuild,
IDependencyUpgradeBuild, IGitHooksBuild
{
public IReadOnlyCollection<Artifact> Artifacts => [];
public static int Main() => Execute<Build>(x => x.As<IDefaultBuild>().Clean);
}
Create .fallout/parameters.json with the solution path, then run dotnet run --project build/_build.csproj -- --help to see targets and parameters. The included scaffolding target writes its solution setting to .fallout/parameters.json; it will not overwrite existing files.
See the Fallout builds guide for component details and package publishing.
Local containers
IDockerBuild manages a local environment on a Docker Compose file (default: docker/docker-compose.yml, project named after the repository directory). It uses docker compose when available, otherwise the legacy docker-compose, and passes the compose file's directory as DOCKER_ROOT. The boilerplate's docker.mk exposes each target to Make:
| Target | Make | What it does |
|---|---|---|
DockerInfo |
docker_info |
Docker engine and Compose versions, the Compose command, and the running containers |
DockerStopAll |
docker_stopall |
Stops every container running on the host |
DockerLogs |
container_logs |
Prints the environment's logs, of DockerContainer if given |
DockerStart |
start |
up --detach --quiet-pull --remove-orphans, then waits for each DockerWaitFor container (healthy, with DockerWaitForHealthy) |
DockerStop, DockerRestart, DockerDestroy |
stop, restart, destroy |
Stop, restart (DockerContainer only, if given) or remove the environment, including its volumes |
DockerWaitRunning |
wait_running_container |
Waits up to DockerTimeout seconds (default 60) for DockerContainer to be running |
DockerWaitHealthy |
wait_healthy_container |
Waits up to DockerStartTimeout seconds (default 180) for it to be running, then up to DockerTimeout for its health check to pass; fails at once if it turns unhealthy or has no health check |
The waits show a progress bar on interactive terminals and plain lines otherwise (CI, redirected output).
Starting from an empty folder
For a guided setup, including APIs, jobs and UIs, install the Anarchy.Toolkit.Build.Cli.Tool global tool and run anarchy-toolkit bootstrap. See the tool README. To set up the build host manually instead:
With the .NET 10 SDK, Bash and Make installed, create a build host first:
mkdir -p build .fallout
dotnet new console --framework net10.0 --name _build --output build
dotnet add build/_build.csproj package Anarchy.Toolkit.Build.Fallout
printf '{}\n' > .fallout/parameters.json
Use the example above in build/Program.cs, adding IBoilerplateBuild to the class. Then generate a starter solution and try the build:
dotnet run --project build/_build.csproj -- SetupBoilerplate --boilerplate-solution-name MyApp
make compile
make check_layering
By default, scaffolding creates a solution containing the build and a starter src/Core project, along with tests/, samples/, docs/, Makefile, scripts and configuration files. Review the supplied .NET SDK and test-runner settings and enable or adapt the optional Make targets for your build components and tools.
Choosing what to install
Use --boilerplate-items for a comma-separated allowlist and --boilerplate-exclude to remove items. Names are case-insensitive; omit the allowlist to select everything.
| Item | Effect |
|---|---|
solution |
Create the named .sln, add the existing build and selected Core project, and set Solution in .fallout/parameters.json. Requires --boilerplate-solution-name. |
core |
Create src/Core/Core.csproj. Add it to a solution yourself if solution is excluded. |
tests, samples, docs |
Create the directory and its .gitkeep. |
Makefile, .gitignore, .editorconfig, global.json, nuget.config |
Install the corresponding packaged file. |
Directory.Build.props |
Create the SQL resource embedding rule if the file is absent. |
scripts |
Install all scripts; individual paths such as scripts/build.fallout.sh or scripts/bootstrap can also be selected or excluded. |
all selects every item and none selects nothing. Unknown names fail before any files are written. When selecting individual scripts, include their helpers: the launcher needs scripts/shared/colors.env, scripts/console/subtitle.sh and, unless environment reloading is disabled, scripts/bootstrap/shell-profile-path.sh.
Existing .gitignore and .editorconfig files are untouched unless --append-existing (or --apend-existing) is supplied; packaged content is then appended at most once. Review the result because later rules can change earlier ones. The same option adds the packaged test section ("runner": "Microsoft.Testing.Platform", which dotnet test needs to run xUnit.net v3 projects) to an existing global.json that does not have one; the rest of the file is kept, and a file with comments is left alone. Existing nuget.config and Directory.Build.props are always preserved, as is global.json otherwise. The target refuses to overwrite a solution, selected script, Makefile, starter project, .gitkeep or existing Solution parameter. If an operation fails partway through, inspect the output before retrying.
Releases
3.0.0
- feat(Build.Fallout): replace AWS release flows with Docker and container builds
2.0.0
- Breaking: layering, dependency map, release version and notes, Git hook, lint staging and local process tasks, their entities and the connection-string helpers moved to
Anarchy.Toolkit.Build.Cli(namespacesAnarchy.Toolkit.Build.Cli.Core.*and.Infrastructure.Helper). Targets are unchanged; updateusingdirectives that referenced them directly. ILayeringBuildgains theLayeringLayersandLayeringApplicationFoldersparameters, so layers and application folders (e.g.src/Api=Web) can be configured in.fallout/parameters.json.- The packaged Makefile and scripts now come from
Anarchy.Toolkit.Build.Cli.
1.0.2
- chore(deps): update AWS SDK packages
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- Anarchy.Toolkit.Build.Cli (>= 1.1.0)
- Fallout.Common (>= 11.0.18)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.15)
- Microsoft.Identity.Client (>= 4.92.0)
- Newtonsoft.Json (>= 13.0.4)
- NuGet.Packaging (>= 8.0.0)
- Serilog (>= 4.4.0)
- Serilog.Sinks.Console (>= 6.1.1)
- Spectre.Console (>= 0.57.2)
- System.Security.Cryptography.Pkcs (>= 11.0.0)
- System.Security.Cryptography.Xml (>= 11.0.0)
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 | |
|---|---|---|---|
| 3.9.0 | 45 | 11/18/2026 | |
| 3.8.0 | 45 | 11/18/2026 | |
| 3.7.0 | 73 | 11/17/2026 | |
| 3.6.1 | 74 | 11/17/2026 | |
| 3.6.0 | 72 | 11/17/2026 | |
| 3.5.0 | 82 | 11/17/2026 | |
| 3.4.0 | 82 | 11/17/2026 | |
| 3.3.1 | 85 | 11/16/2026 | |
| 3.3.0 | 83 | 11/16/2026 | |
| 3.2.0 | 95 | 11/15/2026 | |
| 3.1.0 | 98 | 11/15/2026 | |
| 3.0.0 | 89 | 11/14/2026 | |
| 2.0.0 | 92 | 11/13/2026 | |
| 1.0.1 | 92 | 11/11/2026 |
Initial release.