formatter: initial and basic indentation/alignment and expose the formatting via the LSP (#2673)

This commit is contained in:
Tyler Wilding
2023-05-28 12:22:00 -05:00
committed by GitHub
parent ad0b3297ca
commit 4c6982b0ec
22 changed files with 447 additions and 166 deletions
+64 -119
View File
@@ -1,5 +1,7 @@
#include "formatter.h"
#include "formatter_tree.h"
#include "common/util/FileUtil.h"
#include "common/util/string_util.h"
@@ -13,134 +15,74 @@ extern "C" {
extern const TSLanguage* tree_sitter_opengoal();
}
void walk_tree(TSTreeCursor* cursor, std::string& output, const std::string& source_code) {
// an imperative breadth-first-search
while (true) {
// Process the node
const auto curr_node = ts_tree_cursor_current_node(cursor);
const std::string curr_node_type = ts_node_type(curr_node);
std::string curr_node_field_name;
if (ts_tree_cursor_current_field_name(cursor)) {
curr_node_field_name = ts_tree_cursor_current_field_name(cursor);
}
if (curr_node_field_name == "open") {
output += "(";
} else if (curr_node_field_name == "close") {
output.pop_back();
output += ") ";
}
if (curr_node_type == "sym_name" || curr_node_type == "num_lit" ||
curr_node_type == "str_lit") {
uint32_t start = ts_node_start_byte(curr_node);
uint32_t end = ts_node_end_byte(curr_node);
const char* type = ts_node_type(curr_node);
(void)type;
// TODO - if it's a string literal, take out any newlines and reflow the string to the
// line-length
const auto contents = source_code.substr(start, end - start);
output += contents + " ";
std::string align_form(const std::string& form, int alignment_width) {
const auto lines = str_util::split(form);
std::string aligned_form = "";
for (int i = 0; i < lines.size(); i++) {
aligned_form += str_util::repeat(alignment_width, " ") + lines.at(i);
if (i != lines.size() - 1) {
aligned_form += "\n";
}
}
return aligned_form;
}
if (ts_tree_cursor_goto_first_child(cursor)) {
continue;
}
if (ts_tree_cursor_goto_next_sibling(cursor)) {
continue;
}
while (true) {
if (!ts_tree_cursor_goto_parent(cursor)) {
if (output.at(output.length() - 1) == ' ') {
output.pop_back();
std::string apply_formatting(const FormatterTree::Node& curr_node,
std::string output,
int tree_depth = 0) {
if (!curr_node.token && curr_node.refs.empty()) {
return output;
}
std::string curr_form = "";
if (curr_node.token) {
curr_form += curr_node.token.value();
return curr_form;
}
if (!curr_node.metadata.is_root) {
curr_form += "(";
}
for (int i = 0; i < curr_node.refs.size(); i++) {
const auto& ref = curr_node.refs.at(i);
// TODO - abstract these into formatting rules
if (!curr_node.metadata.is_root && curr_node.metadata.multiple_elements_first_line) {
if (i > 1) {
// TODO - kinda unsafe
// Trim the current form before applying a new-line
curr_form = str_util::rtrim(curr_form) + "\n";
if (ref.token) {
curr_form += str_util::repeat(curr_node.refs.at(0).token.value().length() + 2, " ");
}
return;
}
if (ts_tree_cursor_goto_next_sibling(cursor)) {
break;
} else if (!curr_node.metadata.is_root) {
if (i > 0) {
// Trim the current form before applying a new-line
curr_form = str_util::rtrim(curr_form) + "\n";
curr_form += str_util::repeat(tree_depth, " ");
}
}
}
}
// TODO - move this to str_util
std::string repeat(size_t n, const std::string& str) {
if (n == 0 || str.empty())
return {};
if (n == 1)
return str;
const auto period = str.size();
if (period == 1)
return std::string(n, str.front());
std::string ret(str);
ret.reserve(period * n);
std::size_t m{2};
for (; m < n; m *= 2)
ret += ret;
ret.append(ret.c_str(), (n - (m / 2)) * period);
return ret;
}
// It's possible to walk a tree-sitter tree imperatively with a cursor
// but the code for that is more verbose and less intuitive and I'm not sure how much
// of a benefit I'd get out of it since for formatting i basically have to convert every
// cursor to it's fat node
//
// But in any case, do it the easy way first and refactor later
void format_code(const std::string& source,
TSNode curr_node,
std::string& output,
std::string curr_form_head = "",
int indent = 0) {
if (ts_node_child_count(curr_node) == 0) {
uint32_t start = ts_node_start_byte(curr_node);
uint32_t end = ts_node_end_byte(curr_node);
// TODO - if it's a string literal, take out any newlines and reflow the string to the
// line-length
const auto contents = source.substr(start, end - start);
if (contents == ")") {
output.pop_back();
output += ") ";
} else if (contents == "(") {
output += "(";
if (ref.token) {
curr_form += ref.token.value() + " ";
} else {
output += contents + " ";
if (!curr_node.metadata.is_root && curr_node.metadata.multiple_elements_first_line) {
// align returned form's lines with this forms lines
// TODO - kinda unsafe
curr_form += align_form(apply_formatting(ref, "", tree_depth + 1),
curr_node.refs.at(0).token.value().length() + 2);
} else {
curr_form += apply_formatting(ref, "", tree_depth + 1);
}
}
return;
}
const std::string curr_node_type = ts_node_type(curr_node);
for (size_t i = 0; i < ts_node_child_count(curr_node); i++) {
auto child_node = ts_node_child(curr_node, i);
// If we are opening a list, peek at the first element in the list
// this is so we can properly handle indentation based on different forms
if (curr_node_type == "list_lit" && i == 1) {
uint32_t start = ts_node_start_byte(child_node);
uint32_t end = ts_node_end_byte(child_node);
// TODO - if it's a string literal, take out any newlines and reflow the string to the
// line-length
curr_form_head = source.substr(start, end - start);
}
std::string curr_node_field_name;
auto curr_field_name_raw = ts_node_field_name_for_child(
curr_node, i); // TODO - why is this always returning `close` for the opening paren..
if (curr_field_name_raw) {
curr_node_field_name = curr_field_name_raw;
}
if (curr_form_head == "defun" && i == 4) {
indent += 2;
output += "\n" + repeat(indent, " ");
} else if (curr_form_head == "defun" && i == 5) {
output += "\n" + repeat(indent, " ");
}
format_code(source, child_node, output, curr_form_head, indent);
if (curr_node_type == "source") {
output += "\n\n";
if (curr_node.metadata.is_root && i < curr_node.refs.size() - 1) {
curr_form += "\n\n";
}
}
if (!curr_node.metadata.is_root) {
curr_form = str_util::rtrim(curr_form) + ")";
}
return curr_form;
}
std::string formatter::format_code(const std::string& source) {
std::optional<std::string> formatter::format_code(const std::string& source) {
// Create a parser.
std::shared_ptr<TSParser> parser(ts_parser_new(), TreeSitterParserDeleter());
@@ -154,9 +96,12 @@ std::string formatter::format_code(const std::string& source) {
// Get the root node of the syntax tree.
TSNode root_node = ts_tree_root_node(tree.get());
if (ts_node_is_null(root_node) || ts_node_has_error(root_node)) {
return std::nullopt;
}
std::string output = "";
format_code(source, root_node, output, "", 0);
const auto formatting_tree = FormatterTree(source, root_node);
std::string formatted_code = apply_formatting(formatting_tree.root, "");
return str_util::trim(output);
return formatted_code;
}