clock · Package details

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

The clock package provides a fakeable wrapper around Dart's core clock APIs, enabling predictable and testable time handling in applications. It abstracts system time operations like DateTime.now() and Duration, allowing developers to simulate different points in time during testing. This is especially useful for unit and integration tests involving timers, scheduled tasks, or time-based logic. The package supports all major platforms and integrates seamlessly with Flutter projects.

Use cases

Testing time-dependent logic
Simulating future or past dates
Mocking system time in unit tests
Building countdown timers
Implementing delayed actions

Key features

Fakeable system time
Consistent behavior across tests
Minimal overhead
Cross-platform support
Easy integration with existing code

Suitable for

Test-driven development
Time-sensitive app features
Automated testing frameworks
Flutter apps with timers
Developers needing deterministic time behavior

Considerations

Not intended for production time handling
Requires explicit use of the wrapper
May need refactoring of time-dependent code
Limited to basic time operations
Best used in test environments only

Original README snapshot from the linked source repository. Visit the repository for the latest content.

Overview

This repository is home to tooling related Dart packages. Generally, this means packages published through the tools.dart.dev publisher that don't naturally belong to other topic monorepos (like dart-lang/build, dart-lang/test, or dart-lang/shelf).

Packages

Package	Description	Issues	Version
api_summary	Creates an API summary for a package.
bazel_worker	Protocol and utilities to implement or invoke persistent bazel workers.
benchmark_harness	The official Dart project benchmark harness.
boolean_selector	A flexible syntax for boolean expressions, based on a simplified version of Dart's expression syntax.
browser_launcher	Provides a standardized way to launch web browsers for testing and tools.
cli_config	A library to take config values from configuration files, CLI arguments, and environment variables.
cli_util	A library to help in building Dart command-line apps.
clock	A fakeable wrapper for dart:core clock APIs.
code_builder	A fluent, builder-based library for generating valid Dart code.
coverage	Coverage data manipulation and formatting
csslib	A library for parsing and analyzing CSS (Cascading Style Sheets).
extension_discovery	A convention and utilities for package extension discovery.
file	A pluggable, mockable file system abstraction for Dart.
file_testing	Testing utilities for package:file.
glob	A library to perform Bash-style file and directory globbing.
graphs	Graph algorithms that operate on graphs in any representation.
html	APIs for parsing and manipulating HTML content outside the browser.
io	Utilities for the Dart VM Runtime including support for ANSI colors, file copying, and standard exit code values.
json_rpc_2	Utilities to write a client or server using the JSON-RPC 2.0 spec.
markdown	A portable Markdown library written in Dart that can parse Markdown into HTML.
mime	Utilities for handling media (MIME) types, including determining a type from a file extension and file contents.
oauth2	A client library for authenticating with a remote service via OAuth2 on behalf of a user, and making authorized HTTP requests with the user's OAuth2 credentials.
package_config	Support for reading and writing Dart Package Configuration files.
pool	Manage a finite pool of resources. Useful for controlling concurrent file system or network requests.
process	A pluggable, mockable process invocation abstraction for Dart.
pub_semver	Versions and version constraints implementing pub's versioning policy. This is very similar to vanilla semver, with a few corner cases.
pubspec_parse	Simple package for parsing pubspec.yaml files with a type-safe API and rich error reporting.
source_map_stack_trace	A package for applying source maps to stack traces.
source_maps	A library to programmatically manipulate source map files.
source_span	Provides a standard representation for source code locations and spans.
sse	Provides client and server functionality for setting up bi-directional communication through Server Sent Events (SSE) and corresponding POST requests.
stack_trace	A package for manipulating stack traces and printing them readably.
stream_channel	An abstraction for two-way communication channels based on the Dart Stream class.
stream_transform	A collection of utilities to transform and manipulate streams.
string_scanner	A class for parsing strings using a sequence of patterns.
term_glyph	Useful Unicode glyphs and ASCII substitutes.
test_reflective_loader	Support for discovering tests and test suites using reflection.
timing	A simple package for tracking the performance of synchronous and asynchronous actions.
unified_analytics	A package for logging analytics for all Dart and Flutter related tooling to Google Analytics.
watcher	A file system watcher. It monitors changes to contents of directories and sends notifications when files have been added, removed, or modified.
yaml	A parser for YAML, a human-friendly data serialization standard
yaml_edit	A library for YAML manipulation with comment and whitespace preservation.