🚀 zeba_academy_widget_tester_plus

A powerful yet lightweight Flutter package that simplifies widget testing with visual builders, interaction helpers, snapshot testing, and debug logging — all in one place.

✨ Features

  • 🧪 Simplified Testing System – Clean and structured test execution
  • 👆 Interaction Testing – Easy APIs for tap, scroll, and text input
  • 📸 Snapshot Testing – Save and compare widget states
  • 🎨 Visual Test Builder – Build multiple UI scenarios effortlessly
  • 🧾 Debug Logs – Centralized logging for test debugging

📦 Installation

Add this to your pubspec.yaml:

dev_dependencies:
  zeba_academy_widget_tester_plus: ^0.0.1

Then run:

flutter pub get

🚀 Getting Started

Basic Example

import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:zeba_academy_widget_tester_plus/zeba_academy_widget_tester_plus.dart';

void main() {
  testWidgets('Button interaction test', (tester) async {
    final testerPlus = TesterPlus();

    await tester.pumpWidget(
      MaterialApp(
        home: Scaffold(
          body: ElevatedButton(
            onPressed: () {},
            child: const Text('Tap Me'),
          ),
        ),
      ),
    );

    final interaction = InteractionTester(tester);

    await testerPlus.runTest(
      name: "Tap Button Test",
      tester: tester,
      callback: (tester) async {
        await interaction.tap(find.text('Tap Me'));
      },
    );

    expect(testerPlus.results.first.success, true);
  });
}

🧪 Core Components

🔹 TesterPlus

Handles execution and tracks test results.

🔹 InteractionTester

Provides helper methods for UI interactions.

🔹 SnapshotManager

Stores and compares widget snapshots.

🔹 VisualTestBuilder

Build multiple UI test scenarios easily.

🔹 DebugLogger

Logs test execution details.

📸 Snapshot Testing Example

final result = SnapshotManager.compare("home_screen", newImage);

🎨 Visual Test Builder Example

final builder = VisualTestBuilder()
  ..addScenario(MyWidget())
  ..addScenario(MyWidget(darkMode: true));

final scenarios = builder.build();

🧾 Debug Logs

DebugLogger.log("Test started");

📁 Project Structure

lib/
 ├── zeba_academy_widget_tester_plus.dart
 └── src/
     ├── core/
     ├── builder/
     └── models/

🚀 Roadmap

  • Golden test integration
  • Pixel-perfect snapshot comparison
  • HTML test reports
  • CLI runner
  • CI/CD support

📜 License (GPL v3)

This project is licensed under the GNU General Public License v3.0.

👨‍💻 About Me

✨ I’m Sufyan bin Uzayr, an open-source developer passionate about building and sharing meaningful projects. You can learn more about me and my work at sufyanism.com or connect with me on Linkedin

🌐 Your all-in-one no-bloat hub!

🚀 Explore cutting-edge resources in coding, tech, and development at zeba.academy and code.zeba.academy. Empower yourself with practical skills through curated directives, real-world projects, and hands-on experience. Level up your tech game today! 💻✨

Zeba Academy is a learning platform dedicated to coding, technology, and development. ➡ Visit our main site: zeba.academy ➡ Explore hands-on courses and resources at: code.zeba.academy ➡ Check out our YouTube for more tutorials: zeba.academy ➡ Follow us on Instagram: zeba.academy

❤️ Support

If you like this package, give it a ⭐ on GitHub and share it with the community!

Thank you for visiting! 🚀

Libraries

zeba_academy_widget_tester_plus