ExtendGenerator - Instant Mock Data

Static utilities for generating random colors, UUIDs, mock credit cards, and stream-based data for rapid prototyping and testing.

1. 🌊 Stream Utilities

   streamOf<T>({T Function(int index) generator, int count, Duration interval}) · Stream<T>

   Show Parameters

   generator · T Function(int index) · required

   A function that creates a single item of type T. The index is passed for sequential generation.

   count · int · default: "10"

   The total number of items to emit.

   interval · Duration · default: "Duration(seconds: 1)"

   The delay between emitting each item.

   Simulates a live stream of data that emits up to count items with a specified interval between each emission. Ideal for testing StreamBuilder widgets.

   // Generates 5 items, emitted every 500 milliseconds.
   final priceStream = ExtendGenerator.streamOf<double>(
     (i) => 100.0 + i * 0.5,
     count: 5,
     interval: 500.milliseconds,
   );
   

   weightedBool(double chance) · bool

   Show Parameters

   chance · double · required

   A function that creates a single item of type T. The index is passed for sequential generation.

   Returns true based on a specific probability chance (0.0 to 1.0). Used for simulating real-world scenarios like transient network errors.

   // Returns true approximately 15% of the time
   final shouldFail = ExtendGenerator.weightedBool(0.15);
   

2. 🆔 Identifiers & Finance

   uuid · String

   Generates a Mock UUID (v4 format). Sufficient for UI testing and unique keys, but not cryptographically secure.

   final mockId = ExtendGenerator.uuid;
   // e.g., "a1b2c3d4-e5f6-7890-1234-567890abcdef"
   

   The generated keys are NOT cryptographically secure.

   randomCreditCard({CardType type}) · String

   Show Parameters

   type · CardType · default: "CardType.visa"

   The type of card to generate (Visa, Mastercard, Amex, Discover).

   Generates a mock credit card number that is valid according to the Luhn checksum algorithm. Ideal for testing form validation logic.

   final visaCard = ExtendGenerator.randomCreditCard(type: CardType.visa);
   

3. 📅 Time & Date

   randomDate({int daysBack}) · DateTime

   Show Parameters

   daysBack · int · default: "365"

   The maximum number of days into the past the date can be.

   Generates a random DateTime within the past daysBack (default 365 days). Useful for mock user data or post timestamps.

   ExtendGenerator

   final postDate = ExtendGenerator.randomDate(daysBack: 30);
   

4. 🎨 General Data

   randomColor · Color

   Generates a random, fully opaque (alpha=255) color. Ideal for visual debugging and distinguishing containers.

   Container(color: ExtendGenerator.randomColor);
   

   randomEmail · String

   Generates a mock email address using a random username and common domain names.

   final email = ExtendGenerator.randomEmail; // e.g., "[e-mail]"
   

   clipboardData · Future<String?>

   Retrieves the current text content from the system clipboard.

   final contents = await ExtendGenerator.clipboardData;