spec_cli

Visão geral do pacote

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

spec_cli é uma ferramenta de interface de linha de comando para o Spec, um framework de testes simplificado projetado para aplicativos Dart e Flutter. Ele simplifica a criação, execução e gerenciamento de testes com comandos intuitivos. Desenvolvido pela invertase.io, a ferramenta suporta macOS, Windows e Linux, permitindo que desenvolvedores executem testes de forma eficiente em várias plataformas. Com configuração mínima via `flutter pub add spec_cli`, integra-se perfeitamente em fluxos de trabalho existentes. A CLI aumenta a produtividade ao reduzir o código boilerplate e oferecer feedback claro durante as execuções de teste. Seu design leve foca na velocidade e na experiência do desenvolvedor.

Casos de uso

Automatizando a execução de testes em pipelines de CI/CD
Gerando arquivos de teste rapidamente
Executando testes com configuração mínima
Integração com projetos existentes do Dart/Flutter
Simplificando a descoberta e o relatório de testes

Principais recursos

Comandos simples de CLI para gerenciamento de testes
Suporte multiplataforma (macOS, Windows, Linux)
Integração sem esforço com Flutter e Dart
Execução rápida de testes e feedback
Geração de arquivos de teste embutidos

Indicado para

Desenvolvedores de Dart e Flutter procurando testes eficientes
Equipes usando fluxos de trabalho de CI/CD
Desenvolvedores que desejam configuração mínima para testes
iniciantes em automação de testes
Projetos que priorizam a experiência do desenvolvedor

Considerações

Requer SDK do Flutter para funcionalidade completa
Limitado a projetos usando o framework de teste Spec
Pode exigir configuração adicional para configurações de teste complexas
Não adequado para projetos não Dart/Flutter

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