bs_utils

bs_utils is a lightweight, multipurpose Flutter and Dart utility package that provides a broad collection of extensions, performance trackers, and convenience wrapper methods to accelerate daily development.

Note: This package is actively used as a core foundational dependency for the "BS Collection" packages (such as bs_l10n, bs_overlay, etc.).

Overview

The package is structurally divided to target several domains: Core Utilities, Performance & Debugging, and Syntactic Sugar Extensions.

⚙️ Core Utilities

  • MethodsUtils: Handle advanced functional needs with elegant wrappers like tryThis (safe execution returning null on error), tryIf (polling/retry until condition met), waitUntil, and latestValid for handling execution racing.
  • DevicePlatform: A unified API to detect platforms (iOS, Android, Windows, macOS, Linux, Web, Fuchsia) providing simple semantic checks like isDesktop, isMobile, and isApple.

⏱️ Performance & Debugging

  • Time Tracker: Robust Tracker methods to measure execution time of both asynchronous and synchronous functions (trackSync, trackAsync), as well as helper methods to directly compare their performance (compareSync, compareAsync, compare).
  • True Debug Print: Provides the dprint() snippet and String.log extensions which guarantees printing strictly during Dart's kDebugMode to avoid console clutter in release builds.

🧩 Useful Extensions

Rich extensions provided on common Dart and Flutter classes over diverse sectors:

  • Iterables: Discover min/max elements naturally via maxOf, allMaxOf, minOf, and append.
  • Time & Numbers: Fluid duration declarations on num (e.g., 5.seconds, 2.weeks) and powerful Duration formatting/clamping logic.
  • Flutter Core Types: Includes TextStyle.copyExcept (which drops specific properties), a robust TextSpan.copyWith, and calculation helpers on Size (canContain, add, multiply).
  • State & Enums: Simple boolean getters to intuitively assess Enum states from AppLifecycleState, ConnectionState, TargetPlatform, and TextDirection (e.g., .isResumed, .isDone, .isAndroid).

Issues & Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page. To contribute, fork the repository at https://github.com/B-Saeid/bs_utils and submit a pull request.

Enjoy a cleaner codebase, write less boilerplate!

Libraries

bs_utils
extensions
time