Anarchy.Toolkit.Automation
2.0.0
dotnet add package Anarchy.Toolkit.Automation --version 2.0.0
NuGet\Install-Package Anarchy.Toolkit.Automation -Version 2.0.0
<PackageReference Include="Anarchy.Toolkit.Automation" Version="2.0.0" />
<PackageVersion Include="Anarchy.Toolkit.Automation" Version="2.0.0" />
<PackageReference Include="Anarchy.Toolkit.Automation" />
paket add Anarchy.Toolkit.Automation --version 2.0.0
#r "nuget: Anarchy.Toolkit.Automation, 2.0.0"
#:package Anarchy.Toolkit.Automation@2.0.0
#addin nuget:?package=Anarchy.Toolkit.Automation&version=2.0.0
#tool nuget:?package=Anarchy.Toolkit.Automation&version=2.0.0
Anarchy.Toolkit.Automation
Part of Anarchy I/O Toolkit, a .NET developer platform · Pillar: Build Ecosystem · Layer: Automation · Package catalog
The build and command-line operations shared by the toolkit's tooling: Anarchy build components (Anarchy.Toolkit.Automation.Build) call them from their targets, and the anarchy-toolkit tool from its commands. The build is powered by Fallout Build.
dotnet add package Anarchy.Toolkit.Automation
- Solutions:
SolutionBootstrappercreates a complete solution from aSolutionPlanin an empty directory: the Anarchy build host (BuildHostScaffolder), the packaged Makefile, scripts and settings files (SolutionScaffolder), a library per layer and the planned applications.SolutionWorkspacereads an existing solution's layout andApplicationScaffolderadds an API, job or UI to it. Existing files are never overwritten. - Layouts and preferences:
SolutionLayoutplaces libraries and applications by folder (src/Library/<Layer>,src/Api,src/Jobs,src/Ui) or by name prefix (src/<Layer>.<Name>).LayeringConfigurationresolves explicit layout arguments, optionallayeringvalues in the solution-root.anarchy-toolkit.json, then the folder-mode baseline; it validates the effective layout without requiring saved settings or inferring the mode.AutomationPreferencesreads and edits typed optional overrides shared by CLI and Fallout, keeping the CLI independent of Fallout. Explicit edits validate the merged document and write atomically; normal operations do not save preferences. - Build operations: layering checks, dependency maps, release versioning and notes, Git hooks, dependency upgrades and NuGet packaging, without depending on Fallout.
- Preference editing:
ShowAnarchyPreferences,SetAnarchyPreference,UnsetAnarchyPreferenceandConfigureAnarchyPreferencesshare the reader/writer used by both entry points; see Automation Preferences. - Agent skills:
AgentSkillTasksreads the Make targets and their#@skill markers, creates missing skills from a template and refreshes their generated commands (Sync), and checks them (Validate); the toolkit's own skills are the boilerplate's opt-inskillsitem. - Containers:
LocalContainerTasksmanages a Docker Compose environment;WaitForRunningtakes an optional readiness callback for containers without a health check. - Banners: tools built on this package choose their banner with
ConsoleBannerOptions: Anarchy's logo by default (AnarchyConsoleBanner), their ownIConsoleBannerthroughBanner, or none withHide = true.Write(console)prints it, skipping redirected output. Theanarchy-toolkittool always prints Anarchy's.
Most consumers should use the anarchy-toolkit tool or the Anarchy build targets rather than this package directly.
Distributed files
Boilerplate/ holds the Makefile, scripts, .gitignore, .editorconfig and agent skills (.agents/skills, installed only when selected) installed into generated solutions; together with the repository's global.json and nuget.config, it is embedded as-is. The repository's own .gitignore and .editorconfig start with the packaged ones and add their own entries below the managed block. BoilerplateCatalog lists and reads the packaged files and diffs them against a solution's copies (UnifiedDiff), so they can be inspected without installing them. The toolkit repository uses the same files in place through its root Makefile, which sets SCRIPTS_ROOT so that SCRIPTS_DIR (and shell completion) resolve to src/Automation/Boilerplate/scripts. The scripts find the project root from PROJECT_ROOT (exported by the Makefile), else their parent directory.
Releases
See the release notes for the complete release history.
| 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.Core (>= 2.0.1)
- Humanizer (>= 3.0.10)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.15)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.15)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.15)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.15)
- Microsoft.OpenApi (>= 3.11.1)
- Microsoft.OpenApi.YamlReader (>= 3.11.1)
- Newtonsoft.Json (>= 13.0.4)
- Serilog (>= 4.4.0)
- Spectre.Console (>= 0.57.2)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on Anarchy.Toolkit.Automation:
| Package | Downloads |
|---|---|
|
Anarchy.Toolkit.Automation.Build
Anarchy automation components, powered by Fallout Build: solution/test conventions, Microsoft.Testing.Platform-aware test runner, linting, layering checks, NuGet and ECR container release flows and local app runs. |
GitHub repositories
This package is not used by any popular GitHub repositories.
## Releases
### 2.0.0
- Breaking: Generate release entries in each package's `RELEASE-NOTES.md` instead of its README.
- chore(build): Format package release notes property
### 1.0.0
- New package identity, renamed from `Anarchy.Toolkit.Build.Cli`; versions below are historical releases under that package ID.
- Breaking: rename the public build-package version constant to `ToolkitPackageVersions.AutomationBuild`, the engine-file helper to `BuildEngineParameters`, and the `BuildHostScaffolder.Create` version parameter to `automationBuildVersion`; public automation default changes are also classified as breaking. This newly named package remains at its initial 1.0.0.
- Expose `make anarchy` and `make anarchy_help` as the canonical build commands, with `fallout` and `nuke` compatibility aliases, and rename the launcher to `scripts/build.anarchy.sh`.
- Add optional root-level automation overrides in `.anarchy-toolkit.json`, with shared validated read/edit operations and no required configuration file.
- Establish adopter organization conventions and ship guidance for selecting folder-based or prefix-based layering.
- Keep application-folder mappings out of prefix-based layering checks.
- Resolve optional layering overrides against the in-code folder baseline; a missing file or mode is valid and does not trigger layout inference. The unified schema covers all persistable automation preferences.
- Scaffold APIs and jobs with provider-neutral application telemetry.
- Add named `monorepo` and `single-app` layout presets, including one custom application-folder mapping, without changing the in-code monorepo baseline.
- Show the source of each effective saved/default preference and accept invocation-supplied values from the Fallout build target.
### Historical releases under `Anarchy.Toolkit.Build.Cli`
### 1.9.0
- feat(Build.Cli): ship the conventions and onboarding guides in the agent skills
### 1.8.0
- fix(Build.Cli): pack the boilerplate at its source paths
- feat(Build.Cli): ship a generic .gitignore synced through a managed block
- feat(Build.Cli): show, diff and dry-run the boilerplate before installing it
- feat(Build.Cli): keep the packaged .editorconfig in a managed block
- docs(mock-server): add a guide covering recording and migrating from MockServer
- feat(Build.Cli): ship adoption and runtime composition skills
### 1.7.0
- feat(Build.Cli): add opt-in agent skills to the boilerplate
- fix(Build.Cli): print a plain title on narrow terminals
- fix(Build.Cli): keep shell completion working for including Makefiles
### 1.6.0
- feat(Build.Fallout): run the mock server with or without its UI
### 1.5.1
- docs(packages): identify each package's pillar and layer
- build(packages): attribute the copyright to Leandro Melão Medeiros
- build: relicense under Apache-2.0 and update the package metadata
- fix(mock-server): default to port 6001, which browsers allow
### 1.5.0
- build(deps): upgrade Swashbuckle.AspNetCore to 11.0.1 and Microsoft.OpenApi to 3.11.1
- feat(Build.Cli): scaffold APIs without the Swagger theme and UIs with the logo and theme toggle
### 1.4.0
- feat: `OpenApiExpectationSync` adds mock server expectations for OpenAPI/Swagger endpoints (file or URL, JSON or YAML) that have none, never changing existing ones and reporting changed or removed endpoints; `mock_server_sync_openapi` Make target
### 1.3.0
- refactor: `LocalPorts` moved to `Anarchy.Toolkit.Core.Helper` (now references Anarchy.Toolkit.Core)
- feat: `mock-server.mk` boilerplate targets for `IMockServerBuild`
### 1.2.2
- docs: expand XML docblocks across all projects for the DocFX API reference
### 1.2.1
- `install-sdk.sh` installs the pinned feature band (e.g. `10.0.1xx`) when `global.json` only lets patches roll forward, the default, instead of a newer feature band its own check rejects; it also announces what it installs before downloading.
- `build.anarchy.sh` ignores a `DOTNET_EXE` that is not an executable (e.g. left over from a removed Homebrew SDK) and uses `dotnet` from `PATH`.
- The bootstrap scripts print standard headings and colors through `title.sh`, `subtitle.sh` and `colors.env`; `install-sdk.sh` shows a title when run on its own and a subtitle when part of `install_dev_env`.
### 1.2.0
- Configurable console banners: `IConsoleBanner`, `AnarchyConsoleBanner` and `ConsoleBannerOptions` let tools keep Anarchy's banner, render their own or print none.
- `LocalContainerTasks.WaitForRunning` gains an overload with a readiness callback.
### 1.1.0
- feat(Build.Fallout): replace AWS release flows with Docker and container builds
### 1.0.0
- Introduced solution bootstrapping and scaffolding with configurable layering, application templates and the build operations extracted from Build.Fallout.