third_party.pigweed.src/pw_assert_basic/backend.gni
Ewout van Bekkum f7a5b51b0c pw_assert_basic: add a handler facade layer
Splits up the pw_assert_basic module to add a facade layer to
allow a user to provide a custom pw_assert_basic_HandleFailure()
implementation. The existing handler, previously named pw_Crash(),
was moved to a basic_handler facade which mirrors the
pw_cpu_exception structure and naming.

Unlike pw_cpu_exception, pw_assert_basic defaults to the
basic_handler backend.

This refactor should allow users, especially during initial
bringup, to trivially bring up assert support with target specific
handlers with less code duplication and complications.

Note that pw_assert_basic is still not recommended for production
use as it is rather heavy weight, we strongly recommend using
tokenized asserts.

Change-Id: I3a0c0aacc9a88d44b35b24ad0a13dd7e2badc209
Reviewed-on: https://pigweed-review.googlesource.com/c/pigweed/pigweed/+/28520
Commit-Queue: Ewout van Bekkum <ewout@google.com>
Reviewed-by: Keir Mierle <keir@google.com>
2021-01-05 19:33:52 +00:00

30 lines
1.3 KiB
Plaintext

# Copyright 2020 The Pigweed 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.
import("//build_overrides/pigweed.gni")
declare_args() {
# Handler backend for the pw_assert_basic module which implements
# pw_assert_basic_HandleFailure, this defaults to the basic_handler.
#
# Note: Don't confuse pw_assert_BACKEND and pw_assert_basic_HANDLER_BACKEND:
# 1) pw_assert_BACKEND must be set to dir_pw_assert_basic in order to
# use this module which ensures that asserts always invoke
# pw_assert_basic_HandleFailure.
# 2) pw_assert_basic_HANDLER_BACKEND allows you to switch out the
# implementation of the handler which is invoked (i.e.
# pw_assert_basic_HandleFailure).
pw_assert_basic_HANDLER_BACKEND = "$dir_pw_assert_basic:basic_handler"
}