chore(deps): update xUnit.net v3 to 4.0

Aberta
  • Algo errado?
#591 0 comentários 0 reações 0 responsáveis Ver no GitHub

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
4/5
Tempo estimado
3-5 dias
Facilidade para iniciantes
48/100
Tipo de issue
Refatoração
Clareza
Claramente especificada
Status de atividade
Ativa
Stack de tecnologia
csharp, github-actions
Domínio
build-system, testing

Direção de pesquisa

Start with root Directory.Packages.props, tests/Directory.Build.props, and .github/workflows/build-library.yml; check the xUnit 4 migration notes and the test runner configuration. Search for the listed ordering and parallelism APIs, then run dotnet restore, dotnet build, and dotnet test. Done means CI and coverage work, all tests remain discovered, and the deferred MTP migration has a follow-up issue.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

dependencies Infrastructure

Part 5 of the outdated-package sweep (dotnet-outdated 4.8.1, 2026-11-05). Major upgrade of the xUnit.net v3 framework.

Current state

Root Directory.Packages.props:

  • xunit.v3 3.2.2, xunit.v3.core 3.2.2, xunit.v3.assert 3.2.2 -> 4.0.2
  • xunit.runner.visualstudio 3.1.5 -> 4.0.1

tests/Directory.Build.props: test projects are OutputType=Exe, reference Microsoft.NET.Test.Sdk, xunit.v3, XUnit.Combinatorial, and xunit.runner.visualstudio; dotnet test runs via the VSTest host with coverlet / XPlat Code Coverage. xunit.v3.core and xunit.v3.assert are referenced by CommunityToolkit.Datasync.TestCommon.

Key breaking changes in 4.0.0 (https://xunit.net/releases/v3/4.0.0)

  • Microsoft Testing Platform v1 support dropped; MTP v2 is now the default. If CI/dotnet test prints "Testing with VSTest target is no longer supported by Microsoft.Testing.Platform on .NET 10 SDK and later", the repo's test runner config must be updated (see https://xunit.net/docs/getting-started/v3/microsoft-testing-platform and the "Testing with 'dotnet test'" doc). Two options: (a) stay on VSTest by using the xunit.v3.*.mtp-off package variants (e.g. xunit.v3.mtp-off instead of xunit.v3), or (b) move to MTP v2 and global.json test.runner settings. Prefer (a) first (smallest change; keeps coverlet/XPlat coverage and current CI commands), and file a follow-up issue for MTP migration.
  • Reporting switches renamed for MTP (-report-xunit -> -report-xunit-xml, etc.) and CTRF format changed. Check .github/workflows/build-library.yml and any scripts for use of these flags.
  • New class/method test orderers; test case ordering semantics changed. Search the tests for ITestCaseOrderer, TestCaseOrderer, CollectionBehavior, DisableTestParallelization, MaxParallelThreads.
  • Parallelism attributes: [assembly: CollectionBehavior] options for parallelism are obsolete/uncallable; use [assembly: Parallelization]. Check xunit.runner.json / testconfig.json too.
  • Mono unsupported (not relevant).
  • XUnit.Combinatorial 2.x works with 4.x (depends on xunit.v3.extensibility.core >= 1.0.0); confirm after the "update test tooling" PR.

Steps

  1. Create the branch. Bump all four packages in lockstep (versions must exist: check NuGet; use latest 4.0.x).
  2. Choose option (a) above; fix compile errors (extensibility/orderer/parallelism APIs).
  3. dotnet restore && dotnet build && dotnet test. Compare total/passed/skipped test counts against main before the change to prove no tests were silently dropped or not discovered.
  4. Verify the CI test summary + coverage output still work (TestResults/SummaryGithub.md, coverage upload) in .github/workflows/build-library.yml.
  5. Dispatch build-library.yml on the fork with --ref <branch>.
  6. Check CONTRIBUTING.md/docs for test-run instructions that need updating.

Acceptance criteria

  • xunit.v3 packages at 4.0.x and runner at 4.0.1; no test loss (document counts in the PR); CI green with coverage.
  • If MTP migration is deferred, a follow-up issue exists.
  • PR title: chore(deps): update xUnit.net v3 to 4.0.
Linguagem predominante
C#
Estrelas
184
Forks
48
Merge médio
21min
PRs com merge (30d)
7

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de CommunityToolkit/Datasync

Todas as issues de CommunityToolkit/Datasync

Issues semelhantes

Mais issues de C#

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.