dart_test_adapter

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

O pacote dart_test_adapter fornece uma API em Dart para interagir programaticamente com os comandos `dart test` e `flutter test`. Ele permite que desenvolvedores executem testes, analisem resultados e gerenciem a execução de testes dentro de aplicações Dart, sendo ideal para integrar fluxos de trabalho de teste em ferramentas personalizadas ou pipelines CI/CD. Projetado para uso em ambientes de desenvolvimento em Android, iOS, macOS, Windows e Linux, oferece uma maneira contínua de automatizar e controlar execuções de testes sem depender de scripts de shell. O pacote é mantido por invertase.io e é de código aberto.

Casos de uso

Automatizando a execução de testes em pipelines de CI/CD
Integrando executadores de testes em ferramentas de desenvolvimento personalizadas
Analisando resultados de testes programaticamente
Executando testes a partir de aplicativos Dart
Habilitar a configuração dinâmica de teste

Principais recursos

Acesso programático aos executores de testes
Suporte multiplataforma
Integração com os frameworks de teste do Flutter e Dart
Análise em tempo real dos resultados
Open-source e ativamente mantido

Indicado para

engenheiro de automação CI/CD
Desenvolvedores de framework de testes
Criadores de ferramentas
Mantenedores de aplicativos Dart/Flutter

Considerações

Requer configuração adequada dos ambientes de teste
Pode ser necessário um tratamento adicional de erros para conjuntos de testes complexos
Não destinado à execução direta de testes pelo usuário final
Melhor usado em contextos de backend ou ferramentas, em vez de lógica de aplicativo

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

✅ Spec

A streamlined testing framework for Dart & Flutter.

What is it?

Spec builds on-top of existing Dart & Flutter testing tools to provide a streamlined & elegant testing environment. Spec provides both a CLI tool and Dart package.

Documentation

CLI

The Spec CLI allows you to run the spec command from your CLI environment and run your tests:

Intuitive testing output interface, inspired by Jest.
Interactive CLI (via spec --watch); automatically re-run tests when source code changes & rerunning of only failed tests.
Run both Dart & Flutter tests in parallel with a single command.
Run tests from multiple packages at the same time using Melos.

spec

Package

The spec package provides a different take on how to write tests. Designed with type-safety and IDE autocompletion in mind, spec alters the way you write your tests to be more declarative, less error prone and force good habits.

Getting Started

Matchers

Spec CLI works alongside normal Dart test matchers, however also ships with custom matchers, see the API reference docs.

Example of testing using Spec matchers:

import 'package:spec/spec.dart';

void main() {
  test('future example', () async {
    final future = Future.value(42);
    expect(future).toEqual(future);
    await expect(future).completion.toEqual(42);
    await expect(future).throws.isArgumentError();
  });

  test('stream example', () async {
    final stream = Stream.value(42);
    await expect(stream).emits.toEqual(42);
    await expect(stream).emits.isNull();
    await expect(stream).emits.not.isNull();
    await expect(stream).emitsError.isArgumentError();
  });

  test('function example', () {
    void throwsFn() => throw Error();
    expect(throwsFn).returnsNormally();
    expect(throwsFn).throws.isArgumentError();
  });
}

CLI

Installation

dart pub global activate spec_cli

Usage

Run tests:

spec

Run tests in interactive mode:

spec --watch

Interactive mode supports a number of keyboard shortcuts:

Watch Usage:
 › Press f to run only failed tests.
 › Press t to filter by a test name regex pattern.
 › Press q to quit watch mode.
 › Press Enter to trigger a test run.

GitHub Action

If you want to use Spec in your GitHub actions pipeline you can utilize the Spec GitHub action, instructions for how to use it can be found on the the spec-action's marketplace page and in its repository.

LICENSE

Built and maintained by Invertase.

Buscar pacotes, repositórios e categorias de apps

Instalar pacote