Files
abseil-cpp/absl/time/BUILD.bazel
Derek Mauro 1fdbcb591f Add absl::Clock, an abstract interface that interface allows
decoupling code that uses time from the code that creates a point in
time.  You can use this to your advantage by injecting Clocks into
interfaces rather than having implementations call absl::Now()
directly. absl::Clock::GetRealClock() returns an absl::Clock backed by
absl::Now().

Add absl::SimulatedClock, a test-only Clock implementation that does
not "tick" on its own. Time is advanced by explicit calls to the
AdvanceTime() or SetTime() functions. This is intended to be used for
dependency injection in tests to test how code behaves under simulated
time conditions.

PiperOrigin-RevId: 862858341
Change-Id: Ied9946dd84063c95505269971d3c996d4b66c6d8
2026-01-29 12:51:12 -08:00

245 lines
5.7 KiB
Python

#
# Copyright 2017 The Abseil Authors.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# https://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
load("@rules_cc//cc:cc_binary.bzl", "cc_binary")
load("@rules_cc//cc:cc_library.bzl", "cc_library")
load("@rules_cc//cc:cc_test.bzl", "cc_test")
load(
"//absl:copts/configure_copts.bzl",
"ABSL_DEFAULT_COPTS",
"ABSL_DEFAULT_LINKOPTS",
"ABSL_TEST_COPTS",
)
package(
default_visibility = ["//visibility:public"],
features = [
"header_modules",
"layering_check",
"parse_headers",
],
)
licenses(["notice"])
cc_library(
name = "time",
srcs = [
"civil_time.cc",
"clock.cc",
"duration.cc",
"format.cc",
"internal/get_current_time_chrono.inc",
"internal/get_current_time_posix.inc",
"time.cc",
],
hdrs = [
"civil_time.h",
"clock.h",
"time.h",
],
copts = ABSL_DEFAULT_COPTS,
linkopts = ABSL_DEFAULT_LINKOPTS,
deps = [
"//absl/base",
"//absl/base:config",
"//absl/base:core_headers",
"//absl/base:raw_logging_internal",
"//absl/numeric:int128",
"//absl/strings",
"//absl/strings:string_view",
"//absl/time/internal/cctz:civil_time",
"//absl/time/internal/cctz:time_zone",
"//absl/types:optional",
],
)
cc_library(
name = "clock_interface",
srcs = [
"clock_interface.cc",
],
hdrs = [
"clock_interface.h",
],
copts = ABSL_DEFAULT_COPTS,
linkopts = ABSL_DEFAULT_LINKOPTS,
deps = [
":time",
"//absl/base:config",
"//absl/base:core_headers",
"//absl/base:no_destructor",
"//absl/base:nullability",
"//absl/base:raw_logging_internal",
"//absl/synchronization",
],
)
cc_library(
name = "simulated_clock",
testonly = True,
srcs = [
"simulated_clock.cc",
],
hdrs = [
"simulated_clock.h",
],
copts = ABSL_DEFAULT_COPTS,
linkopts = ABSL_DEFAULT_LINKOPTS,
deps = [
":clock_interface",
":time",
"//absl/base:config",
"//absl/base:core_headers",
"//absl/base:nullability",
"//absl/synchronization",
],
)
cc_library(
name = "test_util",
testonly = True,
srcs = ["internal/test_util.cc"],
hdrs = ["internal/test_util.h"],
copts = ABSL_DEFAULT_COPTS,
linkopts = ABSL_DEFAULT_LINKOPTS,
visibility = ["//visibility:private"],
deps = [
":time",
"//absl/base:config",
"//absl/base:raw_logging_internal",
],
)
cc_test(
name = "time_test",
srcs = [
"civil_time_test.cc",
"clock_test.cc",
"duration_test.cc",
"format_test.cc",
"time_test.cc",
"time_zone_test.cc",
],
copts = ABSL_TEST_COPTS,
data = ["//absl/time/internal/cctz:zoneinfo"],
linkopts = ABSL_DEFAULT_LINKOPTS,
deps = [
":test_util",
":time",
"//absl/base:config",
"//absl/base:core_headers",
"//absl/hash:hash_testing",
"//absl/numeric:int128",
"//absl/random",
"//absl/strings:str_format",
"//absl/time/internal/cctz:time_zone",
"@googletest//:gtest",
"@googletest//:gtest_main",
],
)
cc_test(
name = "clock_interface_test",
srcs = [
"clock_interface_test.cc",
],
copts = ABSL_TEST_COPTS,
linkopts = ABSL_DEFAULT_LINKOPTS,
deps = [
":clock_interface",
":time",
"//absl/functional:bind_front",
"//absl/synchronization",
"@googletest//:gtest",
"@googletest//:gtest_main",
],
)
cc_test(
name = "simulated_clock_test",
srcs = [
"simulated_clock_test.cc",
],
copts = ABSL_TEST_COPTS,
linkopts = ABSL_DEFAULT_LINKOPTS,
deps = [
":clock_interface",
":simulated_clock",
":time",
"//absl/base:core_headers",
"//absl/base:raw_logging_internal",
"//absl/functional:bind_front",
"//absl/random",
"//absl/synchronization",
"@googletest//:gtest",
"@googletest//:gtest_main",
],
)
cc_test(
name = "flag_test",
srcs = [
"flag_test.cc",
],
copts = ABSL_TEST_COPTS,
linkopts = ABSL_DEFAULT_LINKOPTS,
tags = [
"no_test_android_arm",
"no_test_android_arm64",
"no_test_android_x86",
"no_test_ios_sim_arm64",
"no_test_ios_x86_64",
"no_test_lexan",
"no_test_loonix",
"no_test_wasm",
],
deps = [
":time",
"//absl/flags:flag",
"//absl/flags:reflection",
"@googletest//:gtest",
"@googletest//:gtest_main",
],
)
cc_binary(
name = "time_benchmark",
testonly = True,
srcs = [
"civil_time_benchmark.cc",
"clock_benchmark.cc",
"duration_benchmark.cc",
"format_benchmark.cc",
"time_benchmark.cc",
],
copts = ABSL_TEST_COPTS,
data = ["//absl/time/internal/cctz:zoneinfo"],
linkopts = ABSL_DEFAULT_LINKOPTS,
tags = [
"benchmark",
],
deps = [
":test_util",
":time",
"//absl/base",
"//absl/base:core_headers",
"//absl/flags:flag",
"//absl/hash",
"@google_benchmark//:benchmark_main",
],
)