nylo-testing

Nylo Testing

Overview

Nylo v7 provides a Laravel-inspired testing framework built on top of Flutter's test library. It includes helpers for widget testing, API mocking, authentication simulation, time manipulation, factories with fake data, and a rich set of custom assertions. Tests live in the test/ directory and use nyTest, nyWidgetTest, and nyGroup as entry points.

When to Use

• Writing unit tests for models, services, or utility functions
• Writing widget tests for NyPage or NyState-based pages
• Mocking API responses for network-dependent tests
• Simulating authenticated or guest users in tests
• Testing time-sensitive logic with time travel helpers
• Generating fake data with factories and NyFaker
• Asserting routes, state updates, toast messages, or lock/loading states
• When NOT to use: for standard Flutter widget tests that do not involve Nylo's state, routing, or API layers, use Flutter's built-in test utilities directly

Quick Reference

Task	Code
Initialize test file	NyTest.init() at top of test body
Unit test	nyTest('name', () async { ... })
Widget test	nyWidgetTest('name', (tester) async { ... })
Group tests	nyGroup('name', () { ... })
Pump a NyPage	await tester.pumpNyWidget(child: MyPage())
Pump and wait for init	await tester.pumpNyWidgetAndWaitForInit(child: MyPage())
Mock API response	NyMockApi.respond('/users', {'id': 1})
Simulate auth user	NyTest.actingAs<User>(User(name: "Test"))
Travel to a time	NyTest.travel(DateTime(2025, 6, 15))
Create factory model	NyFactory.make<User>()
Fire state update	fireStateUpdate('HomePageState', data: {...})
Debug test state	NyTest.dump()

Test File Structure

import 'package:flutter_test/flutter_test.dart';
import 'package:nylo_framework/nylo_framework.dart';

void main() {
  NyTest.init();

  nySetUpAll(() async {
    // Runs once before all tests
  });

  nySetUp(() async {
    // Runs before each test
  });

  nyTearDown(() async {
    // Runs after each test
  });

  nyTearDownAll(() async {
    // Runs once after all tests
  });

  nyTest('my unit test', () async {
    expect(1 + 1, equals(2));
  });

  nyWidgetTest('my widget test', (tester) async {
    await tester.pumpNyWidget(child: MyPage());
    expect(find.text('Hello'), findsOneWidget);
  });

  nyGroup('user tests', () {
    nyTest('can create user', () async {
      // ...
    });
  });
}