Files
carbon-lang/explorer/ast/BUILD
T
Adrien Leravat d0645c6a85 Explorer: rename value categories to expression categories (#2744)
Rename value categories to expression categories based on [Discord discussion](https://discord.com/channels/655572317891461132/753021843459538996/1092924035517665332) regarding naming and behavior.

>* let expression -> value expression
>* var expression -> reference expression
>* located expression -> initializing expression
>So:
>- "value expressions" produce values (with no associated location). "reference expressions" produce a location of an existing value. "initializing expressions" take a location and initialize it.
>- A let binding is initialized by a value expression, because lets represent values (with category conversions performed as needed, but if a conversion is performed from a different category of expression, the value of the object is pinned for the lifetime of the let).
>- A var binding is initialized by an initializing expression, without performing a copy (with category conversions performed as needed, calling a copy constructor if the initializer is a different expression category).
>- The & operator requires a reference expression, and it's an error to give it other kinds.
>- The left-hand side of . requires a value expression when calling a function with a non-addr receiver, and requires a reference expression when calling a function with an addr receiver (it's an error to give it a value expression, and for an initializing expression, a temporary is materialized).

Changes
* Rename "value category" to "expression category"
* Rename Var and Let value categories to Value, Reference, and Initializing expression
* Rename `lvalue` to `location` (most of the time)
2023-04-05 16:16:10 -07:00

161 lines
3.6 KiB
Python

# Part of the Carbon Language project, under the Apache License v2.0 with LLVM
# Exceptions. See /LICENSE for license information.
# SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
package(default_visibility = ["//explorer:__subpackages__"])
cc_library(
name = "ast",
srcs = [
"ast_node.cpp",
"ast_rtti.cpp",
"bindings.cpp",
"clone_context.cpp",
"declaration.cpp",
"element.cpp",
"expression.cpp",
"impl_binding.cpp",
"pattern.cpp",
"statement.cpp",
"value.cpp",
],
hdrs = [
"address.h",
"ast.h",
"ast_kinds.h",
"ast_node.h",
"ast_rtti.h",
"bindings.h",
"clone_context.h",
"declaration.h",
"element.h",
"element_path.h",
"expression.h",
"impl_binding.h",
"pattern.h",
"return_term.h",
"statement.h",
"value.h",
"value_node.h",
"value_transform.h",
],
textual_hdrs = [
"value_kinds.def",
],
deps = [
":expression_category",
":library_name",
":paren_contents",
"//common:check",
"//common:enum_base",
"//common:error",
"//common:indirect_value",
"//common:ostream",
"//explorer/common:arena",
"//explorer/common:error_builders",
"//explorer/common:nonnull",
"//explorer/common:source_location",
"@llvm-project//llvm:Support",
],
)
cc_library(
name = "ast_test_matchers",
testonly = 1,
srcs = [
"ast_test_matchers_internal.cpp",
"ast_test_matchers_internal.h",
],
hdrs = ["ast_test_matchers.h"],
deps = [
":ast",
"@com_google_googletest//:gtest",
"@llvm-project//llvm:Support",
],
)
cc_test(
name = "ast_test_matchers_test",
srcs = ["ast_test_matchers_test.cpp"],
deps = [
":ast",
":ast_test_matchers",
"//common:gtest_main",
"//explorer/common:arena",
"@com_google_googletest//:gtest",
],
)
cc_test(
name = "expression_test",
srcs = ["expression_test.cpp"],
deps = [
":ast",
":paren_contents",
"//common:gtest_main",
"//explorer/common:arena",
"@com_google_googletest//:gtest",
"@llvm-project//llvm:Support",
],
)
cc_library(
name = "library_name",
hdrs = ["library_name.h"],
)
cc_library(
name = "paren_contents",
hdrs = ["paren_contents.h"],
deps = [
"//explorer/common:error_builders",
"//explorer/common:source_location",
],
)
cc_test(
name = "element_test",
srcs = ["element_test.cpp"],
deps = [
":ast",
":paren_contents",
"//common:gtest_main",
"//explorer/common:arena",
"@com_google_googletest//:gtest",
"@llvm-project//llvm:Support",
],
)
cc_test(
name = "pattern_test",
srcs = ["pattern_test.cpp"],
deps = [
":ast",
":paren_contents",
"//common:gtest_main",
"//explorer/common:arena",
"@com_google_googletest//:gtest",
"@llvm-project//llvm:Support",
],
)
cc_library(
name = "static_scope",
srcs = ["static_scope.cpp"],
hdrs = ["static_scope.h"],
deps = [
":ast",
"//common:check",
"//common:error",
"//explorer/common:error_builders",
"//explorer/common:nonnull",
"//explorer/common:source_location",
"@llvm-project//llvm:Support",
],
)
cc_library(
name = "expression_category",
hdrs = ["expression_category.h"],
)