third_party.pigweed.src/pw_assert_basic/BUILD.gn
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

70 lines
1.8 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")
import("$dir_pw_build/facade.gni")
import("$dir_pw_build/target_types.gni")
import("$dir_pw_docgen/docs.gni")
import("backend.gni")
config("default_config") {
include_dirs = [ "public" ]
}
config("backend_config") {
include_dirs = [ "public_overrides" ]
}
pw_facade("handler") {
backend = pw_assert_basic_HANDLER_BACKEND
public_configs = [ ":default_config" ]
public_deps = [ "$dir_pw_preprocessor" ]
public = [ "public/pw_assert_basic/handler.h" ]
}
pw_source_set("pw_assert_basic") {
public_configs = [
":backend_config",
":default_config",
]
deps = [
"$dir_pw_assert:facade",
"$dir_pw_preprocessor",
pw_assert_basic_HANDLER_BACKEND,
]
public = [
"public/pw_assert_basic/assert_basic.h",
"public/pw_assert_basic/handler.h",
"public_overrides/pw_assert_backend/assert_backend.h",
]
sources = [ "assert_basic.cc" ]
}
# A basic handler backend using sysio.
pw_source_set("basic_handler") {
deps = [
":handler.facade",
"$dir_pw_assert:facade",
"$dir_pw_preprocessor",
"$dir_pw_string",
"$dir_pw_sys_io",
]
sources = [ "basic_handler.cc" ]
}
pw_doc_group("docs") {
sources = [ "docs.rst" ]
}