blob: e91d03cc96952dc8a82374b2c45327aeddb8cfab [file] [log] [blame]
/*
* Copyright (C) 2018 The Android Open Source Project
*
* 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
*
* http://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.
*/
#define LOG_TAG "sysprop_cpp_gen"
#include "CppGen.h"
#include <android-base/file.h>
#include <android-base/logging.h>
#include <android-base/stringprintf.h>
#include <android-base/strings.h>
#include <cerrno>
#include <filesystem>
#include <regex>
#include <string>
#include "CodeWriter.h"
#include "Common.h"
#include "sysprop.pb.h"
using android::base::Result;
namespace {
constexpr const char* kIndent = " ";
constexpr const char* kCppHeaderIncludes =
R"(#include <cstdint>
#include <optional>
#include <string>
#include <vector>
)";
constexpr const char* kCppSourceIncludes =
R"(#include <cctype>
#include <cerrno>
#include <cstdio>
#include <cstring>
#include <limits>
#include <utility>
#include <strings.h>
#ifdef __BIONIC__
#include <sys/system_properties.h>
[[maybe_unused]] static bool SetProp(const char* key, const char* value) {
return __system_property_set(key, value) == 0;
}
#else
#include <android-base/properties.h>
[[maybe_unused]] static bool SetProp(const char* key, const char* value) {
android::base::SetProperty(key, value);
return true;
}
#endif
#include <android-base/parseint.h>
#include <log/log.h>
)";
constexpr const char* kCppParsersAndFormatters =
R"(template <typename T> constexpr bool is_vector = false;
template <typename T> constexpr bool is_vector<std::vector<T>> = true;
template <> [[maybe_unused]] std::optional<bool> DoParse(const char* str) {
static constexpr const char* kYes[] = {"1", "true"};
static constexpr const char* kNo[] = {"0", "false"};
for (const char* yes : kYes) {
if (strcasecmp(yes, str) == 0) return std::make_optional(true);
}
for (const char* no : kNo) {
if (strcasecmp(no, str) == 0) return std::make_optional(false);
}
return std::nullopt;
}
template <> [[maybe_unused]] std::optional<std::int32_t> DoParse(const char* str) {
std::int32_t ret;
return android::base::ParseInt(str, &ret) ? std::make_optional(ret) : std::nullopt;
}
template <> [[maybe_unused]] std::optional<std::uint32_t> DoParse(const char* str) {
std::uint32_t ret;
return android::base::ParseUint(str, &ret) ? std::make_optional(ret) : std::nullopt;
}
template <> [[maybe_unused]] std::optional<std::int64_t> DoParse(const char* str) {
std::int64_t ret;
return android::base::ParseInt(str, &ret) ? std::make_optional(ret) : std::nullopt;
}
template <> [[maybe_unused]] std::optional<std::uint64_t> DoParse(const char* str) {
std::uint64_t ret;
return android::base::ParseUint(str, &ret) ? std::make_optional(ret) : std::nullopt;
}
template <> [[maybe_unused]] std::optional<double> DoParse(const char* str) {
int old_errno = errno;
errno = 0;
char* end;
double ret = std::strtod(str, &end);
if (errno != 0) {
return std::nullopt;
}
if (str == end || *end != '\0') {
errno = EINVAL;
return std::nullopt;
}
errno = old_errno;
return std::make_optional(ret);
}
template <> [[maybe_unused]] std::optional<std::string> DoParse(const char* str) {
return *str == '\0' ? std::nullopt : std::make_optional(str);
}
template <typename Vec> [[maybe_unused]] Vec DoParseList(const char* str) {
Vec ret;
if (*str == '\0') return ret;
const char* p = str;
for (;;) {
const char* r = p;
std::string value;
while (*r != ',') {
if (*r == '\\') ++r;
if (*r == '\0') break;
value += *r++;
}
ret.emplace_back(DoParse<typename Vec::value_type>(value.c_str()));
if (*r == '\0') break;
p = r + 1;
}
return ret;
}
template <typename T> inline T TryParse(const char* str) {
if constexpr(is_vector<T>) {
return DoParseList<T>(str);
} else {
return DoParse<T>(str);
}
}
[[maybe_unused]] std::string FormatValue(const std::optional<std::int32_t>& value) {
return value ? std::to_string(*value) : "";
}
[[maybe_unused]] std::string FormatValue(const std::optional<std::uint32_t>& value) {
return value ? std::to_string(*value) : "";
}
[[maybe_unused]] std::string FormatValue(const std::optional<std::int64_t>& value) {
return value ? std::to_string(*value) : "";
}
[[maybe_unused]] std::string FormatValue(const std::optional<std::uint64_t>& value) {
return value ? std::to_string(*value) : "";
}
[[maybe_unused]] std::string FormatValue(const std::optional<double>& value) {
if (!value) return "";
char buf[1024];
std::sprintf(buf, "%.*g", std::numeric_limits<double>::max_digits10, *value);
return buf;
}
[[maybe_unused]] std::string FormatValue(const std::optional<bool>& value) {
return value ? (*value ? "true" : "false") : "";
}
template <typename T>
[[maybe_unused]] std::string FormatValue(const std::vector<T>& value) {
if (value.empty()) return "";
std::string ret;
bool first = true;
for (auto&& element : value) {
if (!first) ret += ',';
else first = false;
if constexpr(std::is_same_v<T, std::optional<std::string>>) {
if (element) {
for (char c : *element) {
if (c == '\\' || c == ',') ret += '\\';
ret += c;
}
}
} else {
ret += FormatValue(element);
}
}
return ret;
}
template <typename T>
T GetProp(const char* key, const char* legacy = nullptr) {
std::string value;
#ifdef __BIONIC__
auto pi = __system_property_find(key);
if (pi != nullptr) {
__system_property_read_callback(pi, [](void* cookie, const char*, const char* value, std::uint32_t) {
*static_cast<std::string*>(cookie) = value;
}, &value);
}
#else
value = android::base::GetProperty(key, "");
#endif
if (value.empty() && legacy) {
ALOGD("prop %s doesn't exist; fallback to legacy prop %s", key, legacy);
return GetProp<T>(legacy);
}
return TryParse<T>(value.c_str());
}
)";
const std::regex kRegexDot{"\\."};
const std::regex kRegexUnderscore{"_"};
std::string GetCppEnumName(const sysprop::Property& prop);
std::string GetCppPropTypeName(const sysprop::Property& prop);
std::string GetCppNamespace(const sysprop::Properties& props);
std::string GenerateHeader(const sysprop::Properties& props,
sysprop::Scope scope);
std::string GenerateSource(const sysprop::Properties& props,
const std::string& include_name);
std::string GetCppEnumName(const sysprop::Property& prop) {
return ApiNameToIdentifier(prop.api_name()) + "_values";
}
std::string GetCppPropTypeName(const sysprop::Property& prop) {
switch (prop.type()) {
case sysprop::Boolean:
return "std::optional<bool>";
case sysprop::Integer:
return "std::optional<std::int32_t>";
case sysprop::Long:
return "std::optional<std::int64_t>";
case sysprop::Double:
return "std::optional<double>";
case sysprop::String:
return "std::optional<std::string>";
case sysprop::Enum:
return "std::optional<" + GetCppEnumName(prop) + ">";
case sysprop::UInt:
return "std::optional<std::uint32_t>";
case sysprop::ULong:
return "std::optional<std::uint64_t>";
case sysprop::BooleanList:
return "std::vector<std::optional<bool>>";
case sysprop::IntegerList:
return "std::vector<std::optional<std::int32_t>>";
case sysprop::LongList:
return "std::vector<std::optional<std::int64_t>>";
case sysprop::DoubleList:
return "std::vector<std::optional<double>>";
case sysprop::StringList:
return "std::vector<std::optional<std::string>>";
case sysprop::EnumList:
return "std::vector<std::optional<" + GetCppEnumName(prop) + ">>";
case sysprop::UIntList:
return "std::vector<std::optional<std::uint32_t>>";
case sysprop::ULongList:
return "std::vector<std::optional<std::uint64_t>>";
default:
__builtin_unreachable();
}
}
std::string GetCppNamespace(const sysprop::Properties& props) {
return std::regex_replace(props.module(), kRegexDot, "::");
}
std::string GenerateHeader(const sysprop::Properties& props,
sysprop::Scope scope) {
CodeWriter writer(kIndent);
writer.Write("%s", kGeneratedFileFooterComments);
writer.Write("#pragma once\n\n");
writer.Write("%s", kCppHeaderIncludes);
std::string cpp_namespace = GetCppNamespace(props);
writer.Write("namespace %s {\n\n", cpp_namespace.c_str());
bool first = true;
for (int i = 0; i < props.prop_size(); ++i) {
const sysprop::Property& prop = props.prop(i);
// Scope: Internal > Public
if (prop.scope() > scope) continue;
if (!first) {
writer.Write("\n");
} else {
first = false;
}
std::string prop_id = ApiNameToIdentifier(prop.api_name());
std::string prop_type = GetCppPropTypeName(prop);
if (prop.type() == sysprop::Enum || prop.type() == sysprop::EnumList) {
writer.Write("enum class %s {\n", GetCppEnumName(prop).c_str());
writer.Indent();
for (const std::string& name :
android::base::Split(prop.enum_values(), "|")) {
writer.Write("%s,\n", ToUpper(name).c_str());
}
writer.Dedent();
writer.Write("};\n\n");
}
if (prop.deprecated()) writer.Write("[[deprecated]] ");
writer.Write("%s %s();\n", prop_type.c_str(), prop_id.c_str());
if (prop.access() != sysprop::Readonly) {
if (prop.deprecated()) writer.Write("[[deprecated]] ");
writer.Write("bool %s(const %s& value);\n", prop_id.c_str(),
prop_type.c_str());
}
}
writer.Write("\n} // namespace %s\n", cpp_namespace.c_str());
return writer.Code();
}
std::string GenerateSource(const sysprop::Properties& props,
const std::string& include_name) {
CodeWriter writer(kIndent);
writer.Write("%s", kGeneratedFileFooterComments);
writer.Write("#include <%s>\n\n", include_name.c_str());
writer.Write("%s", kCppSourceIncludes);
std::string cpp_namespace = GetCppNamespace(props);
writer.Write("namespace {\n\n");
writer.Write("using namespace %s;\n\n", cpp_namespace.c_str());
writer.Write("template <typename T> T DoParse(const char* str);\n\n");
for (int i = 0; i < props.prop_size(); ++i) {
const sysprop::Property& prop = props.prop(i);
if (prop.type() != sysprop::Enum && prop.type() != sysprop::EnumList) {
continue;
}
std::string prop_id = ApiNameToIdentifier(prop.api_name());
std::string enum_name = GetCppEnumName(prop);
writer.Write("constexpr const std::pair<const char*, %s> %s_list[] = {\n",
enum_name.c_str(), prop_id.c_str());
writer.Indent();
for (const std::string& name : ParseEnumValues(prop.enum_values())) {
writer.Write("{\"%s\", %s::%s},\n", name.c_str(), enum_name.c_str(),
ToUpper(name).c_str());
}
writer.Dedent();
writer.Write("};\n\n");
writer.Write("template <>\n");
writer.Write("std::optional<%s> DoParse(const char* str) {\n",
enum_name.c_str());
writer.Indent();
writer.Write("for (auto [name, val] : %s_list) {\n", prop_id.c_str());
writer.Indent();
writer.Write("if (strcmp(str, name) == 0) {\n");
writer.Indent();
writer.Write("return val;\n");
writer.Dedent();
writer.Write("}\n");
writer.Dedent();
writer.Write("}\n");
writer.Write("return std::nullopt;\n");
writer.Dedent();
writer.Write("}\n\n");
if (prop.access() != sysprop::Readonly) {
writer.Write("std::string FormatValue(std::optional<%s> value) {\n",
enum_name.c_str());
writer.Indent();
writer.Write("if (!value) return \"\";\n");
writer.Write("for (auto [name, val] : %s_list) {\n", prop_id.c_str());
writer.Indent();
writer.Write("if (val == *value) {\n");
writer.Indent();
writer.Write("return name;\n");
writer.Dedent();
writer.Write("}\n");
writer.Dedent();
writer.Write("}\n");
writer.Write(
"LOG_ALWAYS_FATAL(\"Invalid value %%d for property %s\", "
"static_cast<std::int32_t>(*value));\n",
prop.prop_name().c_str());
writer.Write("__builtin_unreachable();\n");
writer.Dedent();
writer.Write("}\n\n");
}
}
writer.Write("%s", kCppParsersAndFormatters);
writer.Write("} // namespace\n\n");
writer.Write("namespace %s {\n\n", cpp_namespace.c_str());
for (int i = 0; i < props.prop_size(); ++i) {
if (i > 0) writer.Write("\n");
const sysprop::Property& prop = props.prop(i);
std::string prop_id = ApiNameToIdentifier(prop.api_name());
std::string prop_type = GetCppPropTypeName(prop);
std::string prop_name = prop.prop_name();
std::string legacy_name = prop.legacy_prop_name();
writer.Write("%s %s() {\n", prop_type.c_str(), prop_id.c_str());
writer.Indent();
if (legacy_name.empty()) {
writer.Write("return GetProp<%s>(\"%s\");\n", prop_type.c_str(),
prop_name.c_str());
} else {
writer.Write("return GetProp<%s>(\"%s\", \"%s\");\n", prop_type.c_str(),
prop_name.c_str(), legacy_name.c_str());
}
writer.Dedent();
writer.Write("}\n");
if (prop.access() != sysprop::Readonly) {
writer.Write("\nbool %s(const %s& value) {\n", prop_id.c_str(),
prop_type.c_str());
writer.Indent();
const char* format_expr = "FormatValue(value).c_str()";
// Specialized formatters here
if (prop.type() == sysprop::String) {
format_expr = "value ? value->c_str() : \"\"";
} else if (prop.integer_as_bool()) {
if (prop.type() == sysprop::Boolean) {
// optional<bool> -> optional<int>
format_expr = "FormatValue(std::optional<int>(value)).c_str()";
} else if (prop.type() == sysprop::BooleanList) {
// vector<optional<bool>> -> vector<optional<int>>
format_expr =
"FormatValue(std::vector<std::optional<int>>("
"value.begin(), value.end())).c_str()";
}
}
writer.Write("return SetProp(\"%s\", %s);\n", prop.prop_name().c_str(),
format_expr);
writer.Dedent();
writer.Write("}\n");
}
}
writer.Write("\n} // namespace %s\n", cpp_namespace.c_str());
return writer.Code();
}
} // namespace
Result<void> GenerateCppFiles(const std::string& input_file_path,
const std::string& header_dir,
const std::string& public_header_dir,
const std::string& source_output_dir,
const std::string& include_name) {
sysprop::Properties props;
if (auto res = ParseProps(input_file_path); res.ok()) {
props = std::move(*res);
} else {
return res.error();
}
std::string output_basename = android::base::Basename(input_file_path);
for (auto&& [scope, dir] : {
std::pair(sysprop::Internal, header_dir),
std::pair(sysprop::Public, public_header_dir),
}) {
std::error_code ec;
std::filesystem::create_directories(dir, ec);
if (ec) {
return Errorf("Creating directory to {} failed: {}", dir, ec.message());
}
std::string path = dir + "/" + output_basename + ".h";
std::string result = GenerateHeader(props, scope);
if (!android::base::WriteStringToFile(result, path)) {
return ErrnoErrorf("Writing generated header to {} failed", path);
}
}
std::string source_path = source_output_dir + "/" + output_basename + ".cpp";
std::string source_result = GenerateSource(props, include_name);
if (!android::base::WriteStringToFile(source_result, source_path)) {
return ErrnoErrorf("Writing generated source to {} failed", source_path);
}
return {};
}