BLT/include/blt/std/format.h

612 lines
19 KiB
C
Raw Normal View History

/*
* Created by Brett on 26/01/23.
* Licensed under GNU General Public License V3.0
* See LICENSE file for license detail
*/
#ifndef BLT_TESTS_FORMAT_H
#define BLT_TESTS_FORMAT_H
#include <string>
#include <utility>
#include <vector>
#include <blt/math/math.h>
2023-11-22 20:39:46 -05:00
#include <algorithm>
2023-12-11 14:57:10 -05:00
#include <string_view>
#include "memory.h"
2024-02-21 13:18:05 -05:00
#include "vector.h"
2023-12-11 14:57:10 -05:00
#include <variant>
namespace blt::string
{
2023-03-05 17:21:14 -05:00
2023-11-22 20:39:46 -05:00
template<typename T>
static inline std::string withGrouping(T t, size_t group = 3)
{
2023-11-22 20:39:46 -05:00
// TODO: all this + make it faster
static_assert(std::is_integral_v<T>, "Must be integer type! (Floats currently not supported!)");
auto str = std::to_string(t);
std::string ret;
ret.reserve(str.size());
size_t count = 0;
for (int64_t i = str.size() - 1; i >= 0; i--)
{
2023-11-22 20:39:46 -05:00
ret += str[i];
if (count++ % (group) == group - 1 && i != 0)
2023-11-22 20:39:46 -05:00
ret += ',';
}
std::reverse(ret.begin(), ret.end());
return ret;
}
static inline std::string fromBytes(unsigned long bytes)
{
if (bytes > 1073741824)
{
2023-03-05 17:06:07 -05:00
// gigabyte
2023-03-05 17:21:14 -05:00
return std::to_string(round_up<3>((double) bytes / 1024.0 / 1024.0 / 1024.0)) += "gb";
} else if (bytes > 1048576)
{
2023-03-05 17:06:07 -05:00
// megabyte
return std::to_string(round_up<3>((double) bytes / 1024.0 / 1024.0)) += "mb";
} else if (bytes > 1024)
{
2023-03-05 17:06:07 -05:00
// kilobyte
return std::to_string(round_up<3>((double) bytes / 1024.0)) += "kb";
} else
{
2023-03-05 17:06:07 -05:00
return std::to_string(bytes) += "b";
}
}
// TODO: update table formatter to use these!
/**
* creates a line starting/ending with ending char filled between with spacing char
* @param totalLength total length to generate
* @param endingChar beginning and ending char to use
* @param spacingChar char to use for spacing
* @return a generated line string eg: +--------+
*/
std::string createLine(size_t totalLength, char endingChar, char spacingChar);
/**
* Create a padding string using length and spacing char
* @param length length of string to generate
* @param spacing char to use to generate padding
* @return a padding string
*/
std::string createPadding(size_t length, char spacing = ' ');
// TODO template the padding functions:
/**
* Ensure that string str has expected length, pad after the string otherwise.
* @param str string to pad
* @param expectedLength expected length of the string.
* @return a space padded string
*/
static inline std::string postPadWithSpaces(const std::string& str, size_t expectedLength)
{
auto currentSize = (int) (str.length() - 1);
if ((int) expectedLength - currentSize <= 0)
return str;
auto paddedString = str;
paddedString += createPadding(expectedLength - currentSize);
return paddedString;
}
/**
* Ensure that string str has expected length, pad before the string otherwise.
* @param str string to pad
* @param expectedLength expected length of the string.
* @return a space padded string
*/
static inline std::string prePadWithSpaces(const std::string& str, size_t expectedLength)
{
auto currentSize = str.length() - 1;
auto paddedString = std::string();
paddedString += createPadding(expectedLength - currentSize);
paddedString += str;
return paddedString;
}
struct utf8_string
{
2023-07-24 02:55:03 -04:00
char* characters;
unsigned int size;
};
// taken from java, adapted for c++.
static inline utf8_string createUTFString(const std::string& str)
{
const auto strlen = (unsigned int) str.size();
unsigned int utflen = strlen;
for (unsigned int i = 0; i < strlen; i++)
{
unsigned char c = str[i];
if (c >= 0x80 || c == 0)
2023-02-06 21:54:01 -05:00
utflen += 1;
}
if (utflen > 65535 || /* overflow */ utflen < strlen)
throw "UTF Error";
2023-07-24 02:55:03 -04:00
utf8_string chars{};
chars.size = utflen + 2;
chars.characters = new char[chars.size];
int count = 0;
chars.characters[count++] = (char) ((utflen >> 8) & 0xFF);
2023-07-27 01:47:11 -04:00
chars.characters[count++] = (char) ((utflen >> 0) & 0xFF);
2023-04-05 17:21:19 -04:00
unsigned int i = 0;
for (i = 0; i < strlen; i++)
{ // optimized for initial run of ASCII
int c = (unsigned char) str[i];
if (c >= 0x80 || c == 0) break;
chars.characters[count++] = (char) c;
}
for (; i < strlen; i++)
{
int c = (unsigned char) str[i];
if (c < 0x80 && c != 0)
{
chars.characters[count++] = (char) c;
} else if (c >= 0x800)
{
chars.characters[count++] = (char) (0xE0 | ((c >> 12) & 0x0F));
chars.characters[count++] = (char) (0x80 | ((c >> 6) & 0x3F));
chars.characters[count++] = (char) (0x80 | ((c >> 0) & 0x3F));
} else
{
chars.characters[count++] = (char) (0xC0 | ((c >> 6) & 0x1F));
chars.characters[count++] = (char) (0x80 | ((c >> 0) & 0x3F));
}
}
return chars;
}
static inline std::string getStringFromUTF8(const utf8_string& str)
{
2023-04-05 17:21:19 -04:00
int utflen = (int) str.size;
int c, char2, char3;
int count = 0;
int chararr_count = 0;
auto chararr = new char[utflen + 1];
while (count < utflen)
{
c = (int) str.characters[count] & 0xff;
if (c > 127) break;
count++;
chararr[chararr_count++] = (char) c;
}
while (count < utflen)
{
c = (int) str.characters[count] & 0xff;
switch (c >> 4)
{
case 0:
case 1:
case 2:
case 3:
case 4:
case 5:
case 6:
case 7:
/* 0xxxxxxx*/
count++;
chararr[chararr_count++] = (char) c;
break;
case 12:
case 13:
/* 110x xxxx 10xx xxxx*/
count += 2;
if (count > utflen)
throw "malformed input: partial character at end";
char2 = (int) str.characters[count - 1];
if ((char2 & 0xC0) != 0x80)
throw "malformed input around byte " + std::to_string(count);
chararr[chararr_count++] = (char) (((c & 0x1F) << 6) |
(char2 & 0x3F));
2023-04-05 17:21:19 -04:00
break;
case 14:
/* 1110 xxxx 10xx xxxx 10xx xxxx */
count += 3;
if (count > utflen)
throw "malformed input: partial character at end";
char2 = (int) str.characters[count - 2];
char3 = (int) str.characters[count - 1];
if (((char2 & 0xC0) != 0x80) || ((char3 & 0xC0) != 0x80))
throw "malformed input around byte " + std::to_string(count - 1);
chararr[chararr_count++] = (char) (((c & 0x0F) << 12) |
((char2 & 0x3F) << 6) |
((char3 & 0x3F) << 0));
break;
default:
/* 10xx xxxx, 1111 xxxx */
throw "malformed input around byte " + std::to_string(count);
break;
}
}
chararr[utflen] = '\0';
std::string strs{chararr};
delete[] chararr;
return strs;
}
struct TableColumn
{
std::string columnName;
size_t maxColumnLength = 0;
2023-01-27 10:45:18 -05:00
explicit TableColumn(std::string columnName): columnName(std::move(columnName))
{}
};
struct TableRow
{
std::vector<std::string> rowValues;
};
class TableFormatter
{
private:
2023-01-29 17:10:36 -05:00
std::string m_tableName;
int m_columnPadding;
int m_maxColumnWidth;
std::vector<TableColumn> columns;
std::vector<TableRow> rows;
2023-01-27 10:45:18 -05:00
2023-01-29 17:10:36 -05:00
std::string generateTopSeparator(size_t size);
2023-01-27 10:45:18 -05:00
std::string generateColumnHeader();
2023-01-27 10:45:18 -05:00
std::string generateSeparator(size_t size);
2023-01-27 10:45:18 -05:00
void updateMaxColumnLengths();
2023-01-27 10:45:18 -05:00
[[nodiscard]] inline size_t columnSize(const TableColumn& column) const
{
return column.columnName.size() + m_columnPadding * 2;
}
2023-01-27 10:45:18 -05:00
public:
2023-01-29 17:10:36 -05:00
explicit TableFormatter(std::string tableName = "", int columnPadding = 2, int maxColumnWidth = 500):
m_tableName(std::move(tableName)), m_columnPadding(columnPadding), m_maxColumnWidth(maxColumnWidth)
{}
inline void addColumn(const TableColumn& column)
{
columns.push_back(column);
}
2023-01-27 10:45:18 -05:00
2023-12-03 17:01:51 -05:00
inline void addColumn(std::string column)
{
columns.emplace_back(std::move(column));
}
inline void addRow(TableRow row)
{
if (row.rowValues.size() > columns.size())
throw "Cannot insert more rows than columns!\n";
// ensure every row populates every column. This is important as the table generator assumes that all rows are complete!
if (row.rowValues.size() < columns.size())
for (auto i = row.rowValues.size(); i < columns.size(); i++)
row.rowValues.emplace_back(" ");
rows.push_back(std::move(row));
}
2023-01-27 10:45:18 -05:00
inline void addRow(const std::initializer_list<std::string>& values)
{
TableRow row;
for (const auto& value : values)
row.rowValues.push_back(value);
addRow(row);
}
2023-01-27 10:45:18 -05:00
std::vector<std::string> createTable(bool top = false, bool bottom = false);
};
2023-12-11 14:57:10 -05:00
static inline constexpr size_t MAX_CHILDREN = 16;
/**
* Structure which provides variables for the internal spacing of ASCII objects
*/
struct ascii_padding_format
2023-12-11 14:57:10 -05:00
{
2023-12-15 14:03:33 -05:00
size_t horizontalPadding = 1;
size_t verticalPadding = 1;
2023-12-11 14:57:10 -05:00
};
struct tree_format
{
ascii_padding_format boxFormat;
2023-12-11 14:57:10 -05:00
int verticalPadding;
int horizontalPadding;
// should we remove preceding spaces?
bool collapse = true;
tree_format(): boxFormat{}, verticalPadding(1), horizontalPadding(4)
{}
};
struct tree_node
{
2023-12-10 14:54:08 -05:00
std::string data;
std::string title;
2023-12-11 14:57:10 -05:00
blt::static_vector<tree_node*, 16> children;
};
2023-12-11 14:57:10 -05:00
class ascii_data
{
2023-12-11 14:57:10 -05:00
private:
char* data_;
size_t width_ = 0;
size_t height_ = 0;
size_t size_ = 0;
public:
2023-12-11 14:57:10 -05:00
ascii_data(size_t width, size_t height): data_(new char[width * height]), width_(width), height_(height), size_(width * height)
{
2023-12-11 14:57:10 -05:00
// he he he
memset(data_, ' ', width * height);
}
ascii_data(const ascii_data& copy) = delete;
ascii_data(ascii_data&& move) noexcept
{
data_ = move.data_;
width_ = move.width_;
height_ = move.height_;
size_ = move.size_;
}
ascii_data& operator=(const ascii_data& copy) = delete;
ascii_data& operator=(ascii_data&& move) noexcept
{
delete[] data_;
data_ = move.data_;
width_ = move.width_;
height_ = move.height_;
size_ = move.size_;
return *this;
};
inline char& at(size_t x, size_t y)
2023-12-11 14:57:10 -05:00
{
return data_[x * height_ + y];
2023-12-11 14:57:10 -05:00
}
inline char* data()
2023-12-11 14:57:10 -05:00
{
return data_;
}
std::vector<std::string> toVec()
{
std::vector<std::string> vec;
for (size_t j = 0; j < height(); j++)
{
std::string line;
line.reserve(width());
for (size_t i = 0; i < width(); i++)
2023-12-11 14:57:10 -05:00
{
line += at(i, j);
}
vec.push_back(std::move(line));
}
return vec;
}
[[nodiscard]] char* data() const
{
return data_;
}
[[nodiscard]] inline size_t width() const
{
return width_;
}
[[nodiscard]] inline size_t height() const
{
return height_;
}
[[nodiscard]] inline size_t size() const
{
return size_;
}
~ascii_data()
{
delete[] data_;
}
};
class ascii_object
2023-12-11 14:57:10 -05:00
{
protected:
2023-12-11 14:57:10 -05:00
size_t width_;
size_t height_;
public:
ascii_object(size_t width, size_t height): width_(width), height_(height)
{}
2023-12-11 14:57:10 -05:00
/**
* @return Internal width of the ascii object. This does not include the bordering box
*/
2023-12-11 14:57:10 -05:00
[[nodiscard]] inline size_t width() const
{
return width_;
2023-12-11 14:57:10 -05:00
}
/**
* @return Internal height of the ascii object. This does not include the border.
*/
2023-12-11 14:57:10 -05:00
[[nodiscard]] inline size_t height() const
{
return height_;
}
/**
* @return full height of the ascii box, includes the expected border around the box
*/
[[nodiscard]] inline size_t full_height() const
2023-12-11 14:57:10 -05:00
{
return height_ + 2;
}
/**
* @return full width of the ascii box, includes the expected border around the box.
*/
[[nodiscard]] inline size_t full_width() const
{
return width_ + 2;
2023-12-11 14:57:10 -05:00
}
};
class ascii_box : public ascii_object
{
public:
std::string_view data;
const ascii_padding_format& format;
public:
explicit ascii_box(std::string_view data,
const ascii_padding_format& format = {}): ascii_object(data.length() + (format.horizontalPadding * 2),
1 + (format.verticalPadding * 2)), data(data), format(format)
{}
};
class ascii_titled_box : public ascii_object
{
public:
std::string_view title;
std::string_view data;
const ascii_padding_format& format;
public:
ascii_titled_box(std::string_view title, std::string_view data,
const ascii_padding_format& format = {}):
ascii_object(std::max(data.length(), title.length()) + (format.horizontalPadding * 2),
3 + (format.verticalPadding * 2)), title(title), data(data), format(format)
{}
};
typedef std::variant<ascii_box, ascii_titled_box> box_type;
2023-12-11 14:57:10 -05:00
class ascii_boxes
{
private:
std::vector<box_type> boxes_;
size_t width_ = 1;
size_t height_ = 0;
2023-12-15 02:36:50 -05:00
enum class STORED_TYPE
{
NONE, BOX, BOX_WITH_TITLE, BOTH
};
STORED_TYPE type = STORED_TYPE::NONE;
2023-12-11 14:57:10 -05:00
public:
ascii_boxes() = default;
2023-12-15 02:36:50 -05:00
ascii_boxes(std::initializer_list<box_type> boxes)
{
for (const auto& b : boxes)
push_back(b);
}
void push_back(box_type&& box);
inline void push_back(const box_type& box)
2023-12-11 14:57:10 -05:00
{
push_back(box_type(box));
2023-12-11 14:57:10 -05:00
}
inline std::vector<box_type>& boxes()
2023-12-11 14:57:10 -05:00
{
return boxes_;
}
[[nodiscard]] inline size_t width() const
{
return width_;
}
[[nodiscard]] inline size_t height() const
{
return height_;
}
2023-12-15 02:36:50 -05:00
[[nodiscard]] inline bool is_mixed() const
{
return type == STORED_TYPE::BOTH;
}
2023-12-11 14:57:10 -05:00
};
typedef std::variant<box_type, ascii_boxes> box_container;
2023-12-11 14:57:10 -05:00
2023-12-15 02:36:50 -05:00
ascii_data constructBox(const box_container& box, bool normalize_mixed_types = true);
2023-12-11 14:57:10 -05:00
class BinaryTreeFormatter
{
public:
// data classes
struct Node
{
std::string data;
Node* left = nullptr;
Node* right = nullptr;
explicit Node(std::string data): data(std::move(data))
{}
Node* with(Node* l, Node* r = nullptr)
{
left = l;
right = r;
return this;
}
~Node()
{
delete left;
delete right;
}
};
private:
2023-12-11 14:57:10 -05:00
tree_format format;
2023-12-01 15:03:47 -05:00
Node* root = nullptr;
public:
explicit BinaryTreeFormatter(std::string rootData, const tree_format& format = {}):
format(format), root(new Node(std::move(rootData)))
{}
std::vector<std::string> generateBox(Node* node) const;
inline Node* getRoot()
{
return root;
}
std::vector<std::string> construct();
BinaryTreeFormatter()
{
delete root;
}
};
}
#endif //BLT_TESTS_FORMAT_H