ANcpLua.NET.Sdk.Test 1.4.1

ANcpLua.NET.Sdk

MSBuild SDK with opinionated defaults for .NET projects. Inspired by Meziantou.NET.Sdk.

SDKs

Installation

Add a global.json to your repo root:

{
  "msbuild-sdks": {
    "ANcpLua.NET.Sdk": "*",
    "ANcpLua.NET.Sdk.Web": "*"
  }
}

Then replace your SDK reference:

<Project Sdk="ANcpLua.NET.Sdk"></Project>

For Web projects:

<Project Sdk="ANcpLua.NET.Sdk.Web"></Project>

Working Features

Banned API Analyzer (RS0030)

Enforces best practices via BannedSymbols.txt:

ANcpLua.Analyzers (Bundled)

See ANcpLua.Analyzers for all 16 rules.

Extensions (Auto-Enabled by Default)

Extensions (Opt-in)

SourceGen Helpers include: EquatableArray<T>, DiagnosticInfo, DiagnosticsExtensions, SymbolExtensions, SyntaxExtensions, SemanticModelExtensions, CompilationExtensions, SyntaxValueProvider helpers, EnumerableExtensions, FileExtensions, LocationInfo, EquatableMessageArgs

For analyzers, CLI tools, or test projects, use ANcpLua.Roslyn.Utilities NuGet package instead.

Analyzer Test Fixtures (Auto-Injected)

Test projects with "Analyzer" in their name automatically receive:

Base classes injected into ANcpLua.Testing.Analyzers namespace:

// Analyzer tests
public class MyAnalyzerTests : AnalyzerTest<MyAnalyzer> {
    [Fact]
    public async Task Test() => await VerifyAsync("source code...");
}

// Code fix tests
public class MyCodeFixTests : CodeFixTest<MyAnalyzer, MyCodeFix> {
    [Fact]
    public async Task Test() => await VerifyAsync("source", "fixed");
}

// Code fix with EditorConfig
public class MyConfigTests : CodeFixTestWithEditorConfig<MyAnalyzer, MyCodeFix> {
    [Fact]
    public async Task Test() => await VerifyAsync(
        source, fixed,
        editorConfig: new() { ["my_option"] = "value" });
}

Opt-out: <InjectAnalyzerTestFixtures>false</InjectAnalyzerTestFixtures>

Polyfills (Opt-in for Legacy TFMs)

Configuration

Web Service Defaults (Auto-Registered for Web Projects)

When using Microsoft.NET.Sdk.Web, the SDK automatically adds Aspire 13.0-compatible service defaults:

Opt-out: <AutoRegisterServiceDefaults>false</AutoRegisterServiceDefaults>

DevLogs - Frontend Console Bridge

Captures browser console.log/warn/error and sends to server logs. Enabled by default in Development.

Add to your HTML (only served in Development):

<script src="/dev-logs.js"></script>

All frontend logs appear in server output with [BROWSER] prefix:

info: DevLogEntry[0] [BROWSER] User clicked button
error: DevLogEntry[0] [BROWSER] Failed to fetch data

Configuration:

builder.UseANcpSdkConventions(options =>
{
    options.DevLogs.Enabled = true;           // Default: true
    options.DevLogs.RoutePattern = "/api/dev-logs"; // Default
    options.DevLogs.EnableInProduction = false;     // Default: false
});

Why this matters: AI agents can see frontend and backend logs in one place without using browser MCP (which burns tokens and is slow).

Repository Requirements

This SDK enforces the following repository-level configurations:

Directory.Packages.props (Required)

<PropertyGroup>
  <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
  <CentralPackageTransitivePinningEnabled>true</CentralPackageTransitivePinningEnabled>
</PropertyGroup>

Directory.Build.props (Recommended)

<PropertyGroup>
  <LangVersion>latest</LangVersion>
  <Nullable>enable</Nullable>
  <Deterministic>true</Deterministic>
</PropertyGroup>
<PropertyGroup Condition="'$(CI)' == 'true'">
  <ContinuousIntegrationBuild>true</ContinuousIntegrationBuild>
</PropertyGroup>

Note: LangVersion and Nullable are SDK-owned properties. Place them in Directory.Build.props, NOT in individual csproj files.

Running Tests

export CI=true
export NUGET_DIRECTORY="$(pwd)/artifacts"
dotnet test --project tests/ANcpLua.Sdk.Tests/ANcpLua.Sdk.Tests.csproj