mirror of
https://github.com/getml/sqlgen.git
synced 2025-12-31 14:39:31 -06:00
e736abfbb16c6c371ad3dc3a0dfc0df232fbb875
sqlgen
sqlgen is an ORM and SQL query generator for C++-20, similar to Python's SQLAlchemy/SQLModel or Rust's Diesel.
Much like SQLModel is closely integrated with pydantic, sqlgen is closely integrated with our sister project reflect-cpp. This allows you to construct very reliable and highly efficient data pipelines.
Simple example
Here is how you connect to a PostgreSQL database and insert some data:
#include <sqlgen/postgres.hpp>
struct People {
std::string first_name;
std::string last_name;
uint age;
};
const auto people = std::vector<People>({
person{.first_name = "Homer",
.last_name = "Simpson",
.age = 45}});
const auto credentials = sqlgen::postgres::Credentials{
.user = "...", .password = "...", ...
};
const auto conn = sqlgen::postgres::connect(credentials);
// Will automatically create a table called 'People'
// with the columns 'first_name', 'last_name' and 'age',
// if necessary.
const auto result = sqlgen::write(conn, people);
if (!result) {
std::cout << result.error().what() << std::endl;
}
Here is how you retrieve the same data from the database and print the results as a JSON:
#include <rfl/json.hpp> // reflect-cpp
#include <sqlgen/postgres.hpp>
const auto conn = sqlgen::postgres::connect(credentials);
const sqlgen::Result<std::vector<People>> result =
sqlgen::read<std::vector<People>>(conn);
if (result) {
std::cout << rfl::json::write(*result) << std::endl;
} else {
std::cout << result.error().what() << std::endl;
}
Installation
These three libraries are needed for PostgreSQL support:
sudo apt-get install autoconf bison flex
To install vcpkg:
git submodule update --init
./vcpkg/bootstrap-vcpkg.sh # Linux, macOS
./vcpkg/bootstrap-vcpkg.bat # Windows
# You may be prompted to install additional dependencies.
To compile the library:
cmake -S . -B build -DCMAKE_CXX_STANDARD=20 -DCMAKE_BUILD_TYPE=Release
cmake --build build -j 4 # gcc, clang
cmake --build build --config Release -j 4 # MSVC
Languages
C++
98.8%
CMake
0.9%
Python
0.3%