Files
carbon-lang/explorer/syntax/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

152 lines
3.5 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:__pkg__",
"//explorer/fuzzing:__pkg__",
])
cc_library(
name = "bison_wrap",
hdrs = ["bison_wrap.h"],
deps = ["//common:check"],
)
cc_test(
name = "parse_test",
srcs = ["parse_test.cpp"],
deps = [
":syntax",
"//common:gtest_main",
"//explorer/common:arena",
"@com_google_googletest//:gtest",
],
)
cc_library(
name = "parse_test_matchers",
testonly = 1,
srcs = ["parse_test_matchers_internal.h"],
hdrs = ["parse_test_matchers.h"],
deps = [
":syntax",
"@com_google_googletest//:gtest",
"@llvm-project//llvm:Support",
],
)
cc_library(
name = "prelude",
srcs = ["prelude.cpp"],
hdrs = ["prelude.h"],
data = ["//explorer:standard_libraries"],
deps = [
":syntax",
"//common:error",
"//explorer/ast",
"//explorer/common:arena",
"//explorer/common:nonnull",
],
)
cc_library(
name = "syntax",
srcs = [
"lex_helper.h",
"lex_scan_helper.cpp",
"lex_scan_helper.h",
"lexer.cpp",
"lexer.h",
"parse.cpp",
"parse_and_lex_context.cpp",
"parse_and_lex_context.h",
"parser.cpp",
"parser.h",
],
hdrs = [
"parse.h",
],
# Disable warnings for generated code.
copts = [
"-Wno-implicit-fallthrough", # Needed to make yyinput() code compile.
"-Wno-unneeded-internal-declaration",
"-Wno-unused-but-set-variable",
"-Wno-unused-function",
"-Wno-writable-strings",
],
deps = [
":bison_wrap",
"//common:check",
"//common:error",
"//common:ostream",
"//common:string_helpers",
"//explorer/ast",
"//explorer/ast:expression_category",
"//explorer/ast:paren_contents",
"//explorer/common:arena",
"//explorer/common:error_builders",
"//explorer/common:nonnull",
"@llvm-project//llvm:Support",
],
)
genrule(
name = "syntax_bison_srcs",
srcs = ["parser.ypp"],
outs = [
"parser.cpp",
"parser.h",
"parser.output",
],
cmd = "M4=$(M4) $(BISON) " +
"--output=$(location parser.cpp) " +
"--report=state " +
"--defines=$(location parser.h) " +
"$(location parser.ypp)",
toolchains = [
"@rules_bison//bison:current_bison_toolchain",
"@rules_m4//m4:current_m4_toolchain",
],
)
genrule(
name = "syntax_flex_srcs",
srcs = ["lexer.lpp"],
outs = [
"lexer.cpp",
"lexer.h",
],
cmd = "M4=$(M4) $(FLEX) " +
"--outfile=$(location lexer.cpp) " +
"--header-file=$(location lexer.h) " +
"$(location lexer.lpp)",
toolchains = [
"@rules_flex//flex:current_flex_toolchain",
"@rules_m4//m4:current_m4_toolchain",
],
)
py_library(
name = "format_grammar_lib",
srcs = ["format_grammar.py"],
)
py_test(
name = "format_grammar_test",
srcs = ["format_grammar_test.py"],
deps = ["format_grammar_lib"],
)
cc_test(
name = "unimplemented_example_test",
srcs = ["unimplemented_example_test.cpp"],
deps = [
":parse_test_matchers",
":syntax",
"//common:gtest_main",
"//explorer/ast:ast_test_matchers",
"@com_google_googletest//:gtest",
],
)