feat: SOCL v1.0.2, changelog soon!v1.0.2

Signed-off-by: Amlal El Mahrouss <amlal@nekernel.org>
author: Amlal El Mahrouss <amlal@nekernel.org> 2025-07-26 01:47:32 +0100
committer: Amlal El Mahrouss <amlal@nekernel.org> 2025-07-26 01:47:32 +0100
commit: c52dbf5513ae7f106634967162da5cfb01dc5af3 (patch)
tree: b6715d0fdacebd48491b9b05cf85f1d92028f84b /dev/examples
parent: 01565adb9cf5ef991196f56c7f5f7b6161daa005 (diff)
10 files changed, 292 insertions, 0 deletions
diff --git a/dev/examples/cgi/CMakeLists.txt b/dev/examples/cgi/CMakeLists.txt
new file mode 100644
index 0000000..391899f
--- /dev/null
+++ b/dev/examples/cgi/CMakeLists.txt
@@ -0,0 +1,12 @@
+
+cmake_minimum_required(VERSION 3.15...3.31)
+
+project(
+  CGI
+  VERSION 1.0
+  LANGUAGES CXX)
+
+add_executable(CGI cgi.cc)
+
+set_property(TARGET CGI PROPERTY CXX_STANDARD 20)
+target_include_directories(CGI PUBLIC ../../)
diff --git a/dev/examples/cgi/cgi.cc b/dev/examples/cgi/cgi.cc
new file mode 100644
index 0000000..b4c0b34
--- /dev/null
+++ b/dev/examples/cgi/cgi.cc
@@ -0,0 +1,91 @@
+/* 
+  cgi example
+  written by Amlal El Mahrouss.
+  licensed under the MIT license
+ */
+
+#include <lib/utility/cgi.hpp>
+#include <fstream>
+#include <sstream>
+#include <string>
+
+const std::string g_not_found = R"(
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="UTF-8">
+  <title>error | snu-lib</title>
+  <style>
+    body {
+      font-family: monospace;
+      background: white;
+      color: black;
+      margin: 2em;
+    }
+    h1 {
+      font-size: 1.5em;
+    }
+    hr {
+      border: none;
+      border-top: 1px solid #ccc;
+    }
+    table {
+      width: 100%;
+      border-collapse: collapse;
+    }
+    td {
+      padding: 0.2em 0.5em;
+    }
+    td:first-child {
+      white-space: nowrap;
+    }
+    a {
+      color: blue;
+      text-decoration: none;
+    }
+    a:hover {
+      text-decoration: underline;
+    }
+  </style>
+</head>
+<body>
+  <h1>Uh Oh!</h1>
+  <address>No index file was found in this directory.</address>
+  <hr>
+  <table>
+    <tr><th>Name</th></tr>
+    <tr><td colspan="3"><hr></td></tr>
+
+    <tr>
+      <td><a href="javascript:window.location.reload();">Refresh</a></td>
+    </tr>
+
+    <tr><td colspan="3"><hr></td></tr>
+  </table>
+  <address>snu's Common Gateway Server.</address>
+</body>
+</html>
+)";
+
+/* finally test it */
+/* @brief this stub loads a 'index.html' or returns an error message if not found. */
+int main(int argc, char** argv)
+{
+	// ... let's assume we serve data.
+
+	snu::cgi::cgi_writer writer;
+	std::stringstream	  ss_file;
+
+	std::ifstream fp("index.html");
+
+	if (fp.good())
+		ss_file << fp.rdbuf();
+	else
+		ss_file << g_not_found;
+
+	fp.close();
+
+	writer.eval_html(ss_file);
+
+	return 0;
+}
diff --git a/dev/examples/equiv/CMakeLists.txt b/dev/examples/equiv/CMakeLists.txt
new file mode 100644
index 0000000..8b29e23
--- /dev/null
+++ b/dev/examples/equiv/CMakeLists.txt
@@ -0,0 +1,12 @@
+
+cmake_minimum_required(VERSION 3.15...3.31)
+
+project(
+  Equiv
+  VERSION 1.0
+  LANGUAGES CXX)
+
+add_executable(Equiv equiv.cc)
+
+set_property(TARGET Equiv PROPERTY CXX_STANDARD 20)
+target_include_directories(Equiv PUBLIC ../../)
diff --git a/dev/examples/equiv/equiv.cc b/dev/examples/equiv/equiv.cc
new file mode 100644
index 0000000..896637d
--- /dev/null
+++ b/dev/examples/equiv/equiv.cc
@@ -0,0 +1,19 @@
+/* 
+  string checksum example
+  written by Amlal El Mahrouss.
+  licensed under the MIT license
+ */
+
+#include <lib/logic/equiv.hpp>
+#include <iostream>
+
+/* finally test it */
+int main(int argc, char** argv)
+{
+	std::cout << std::boolalpha;
+	std::cout << snu::equiv::is_same<bool, int>::value << std::endl;
+	std::cout << snu::equiv::is_same<bool, bool>::value << std::endl;
+	std::cout << snu::equiv::is_same<int, int>::value << std::endl;
+
+	return 0;
+}
diff --git a/dev/examples/fix/CMakeLists.txt b/dev/examples/fix/CMakeLists.txt
new file mode 100644
index 0000000..db8921b
--- /dev/null
+++ b/dev/examples/fix/CMakeLists.txt
@@ -0,0 +1,12 @@
+
+cmake_minimum_required(VERSION 3.15...3.31)
+
+project(
+  Fix
+  VERSION 1.0
+  LANGUAGES CXX)
+
+add_executable(Fix fix.cc)
+
+set_property(TARGET Fix PROPERTY CXX_STANDARD 20)
+target_include_directories(Fix PUBLIC ../../)
diff --git a/dev/examples/fix/fix.cc b/dev/examples/fix/fix.cc
new file mode 100644
index 0000000..f67d8a0
--- /dev/null
+++ b/dev/examples/fix/fix.cc
@@ -0,0 +1,26 @@
+/* 
+  fix example
+  written by Amlal El Mahrouss.
+  licensed under the MIT license
+ */
+
+#include <lib/fix/parser.hpp>
+#include <iostream>
+
+/* finally test it */
+int main(int argc, char** argv)
+{
+	snu::fix::visitor<char>	 visitor;
+	snu::fix::range_data<char> fix = visitor.visit("8=FIX.4.2|9=65|35=A|49=SERVER|56=CLIENT|34=177|52=20090107-18:15:16|98=0|108=30|10=062|");
+
+	std::cout << "magic: " << fix.msg_magic_ << std::endl;
+	std::cout << "is_valid: " << std::boolalpha << fix.is_valid() << std::endl;
+
+	for (auto fields : fix.msg_body_)
+	{
+		std::cout << "key: " << fields.first;
+		std::cout << ", value: " << fields.second << std::endl;
+	}
+
+	return 0;
+}
diff --git a/dev/examples/opt/CMakeLists.txt b/dev/examples/opt/CMakeLists.txt
new file mode 100644
index 0000000..b63b1de
--- /dev/null
+++ b/dev/examples/opt/CMakeLists.txt
@@ -0,0 +1,12 @@
+
+cmake_minimum_required(VERSION 3.15...3.31)
+
+project(
+  Opt
+  VERSION 1.0
+  LANGUAGES CXX)
+
+add_executable(Opt opt.cc)
+
+set_property(TARGET Opt PROPERTY CXX_STANDARD 20)
+target_include_directories(Opt PUBLIC ../../)
diff --git a/dev/examples/opt/opt.cc b/dev/examples/opt/opt.cc
new file mode 100644
index 0000000..a914d8d
--- /dev/null
+++ b/dev/examples/opt/opt.cc
@@ -0,0 +1,44 @@
+/* 
+  string checksum example
+  written by Amlal El Mahrouss.
+  licensed under the MIT license
+ */
+
+#include <lib/logic/opt.hpp>
+#include <lib/io/print.hpp>
+#include <string>
+
+static const char do_hash(const std::string& in)
+{
+	int hash = 0;
+
+	for (long index = 0; index < in.size(); ++index)
+	{
+		hash += in[index];
+	}
+
+	return hash;
+}
+
+static auto do_some(const std::string recv_data, const std::string check_data)
+{
+	const int hash_to_check = do_hash(check_data); /* here we assume this should match opt_hash */
+	const int opt_hash		= do_hash(recv_data);  /* we assume that the hash is correct */
+
+	auto opt = snu::opt::opt(snu::opt::eval_eq(hash_to_check, opt_hash)); /* do the compute */
+	return opt;
+}
+
+/* finally test it */
+int main(int argc, char** argv)
+{
+	// ... let's assume we fetch data from network...
+
+	snu::println("Testing data...");
+
+	auto opt = do_some("Ohio", "Ohio");
+	opt.expect("Checksum failed, Ohio isn't Ohio!");
+
+
+	return 0;
+}
diff --git a/dev/examples/tracked_ptr/CMakeLists.txt b/dev/examples/tracked_ptr/CMakeLists.txt
new file mode 100644
index 0000000..9396506
--- /dev/null
+++ b/dev/examples/tracked_ptr/CMakeLists.txt
@@ -0,0 +1,12 @@
+
+cmake_minimum_required(VERSION 3.15...3.31)
+
+project(
+  Fix
+  VERSION 1.0
+  LANGUAGES CXX)
+
+add_executable(TrackedPtr tracked_ptr.cc)
+
+set_property(TARGET TrackedPtr PROPERTY CXX_STANDARD 20)
+target_include_directories(TrackedPtr PUBLIC ../../)
diff --git a/dev/examples/tracked_ptr/tracked_ptr.cc b/dev/examples/tracked_ptr/tracked_ptr.cc
new file mode 100644
index 0000000..c182494
--- /dev/null
+++ b/dev/examples/tracked_ptr/tracked_ptr.cc
@@ -0,0 +1,52 @@
+/*
+  tracked_ptr example
+  written by Amlal El Mahrouss.
+  licensed under the MIT license
+ */
+
+#include <lib/memory/tracked_ptr.hpp>
+#include <iostream>
+
+void summon_tracked_ptr()
+{
+	snu::memory::tracked_ptr<int> ptr = snu::memory::make_tracked(42);
+	std::cout << ptr.data() << "=" << ptr.manager().allocator().allocated_count_ << std::endl;
+}
+
+void summon_leak_tracked_ptr()
+{
+	snu::memory::tracked_ptr<int>* ptr = new snu::memory::tracked_ptr<int>(42);
+	std::cout << ptr->data() << "=" << ptr->manager().allocator().allocated_count_ << std::endl;
+}
+
+/* finally test it */
+int main(int argc, char** argv)
+{
+	summon_tracked_ptr();
+	summon_tracked_ptr();
+	summon_tracked_ptr();
+	summon_tracked_ptr();
+
+	snu::memory::tracked_ptr<int> ptr;
+
+	std::cout << ptr.data() << "=" << ptr.manager().allocator().allocated_count_ << std::endl;
+
+	std::cout << "total=" << ptr.manager().allocator().deallocated_count_ << std::endl;
+
+	std::cout << "leak-detected=" << std::boolalpha << (ptr.manager().allocator().allocated_count_ > ptr.manager().allocator().deallocated_count_) << std::endl;
+
+	summon_leak_tracked_ptr();
+	summon_leak_tracked_ptr();
+	summon_leak_tracked_ptr();
+	summon_leak_tracked_ptr();
+	summon_leak_tracked_ptr();
+	summon_leak_tracked_ptr();
+	summon_leak_tracked_ptr();
+	summon_leak_tracked_ptr();
+
+	std::cout << "total=" << ptr.manager().allocator().deallocated_count_ << std::endl;
+
+	std::cout << "leak-detected=" << std::boolalpha << (ptr.manager().allocator().allocated_count_ > ptr.manager().allocator().deallocated_count_) << std::endl;
+
+	return 0;
+}
author	Amlal El Mahrouss <amlal@nekernel.org>	2025-07-26 01:47:32 +0100
committer	Amlal El Mahrouss <amlal@nekernel.org>	2025-07-26 01:47:32 +0100
commit	c52dbf5513ae7f106634967162da5cfb01dc5af3 (patch)
tree	b6715d0fdacebd48491b9b05cf85f1d92028f84b /dev/examples
parent	01565adb9cf5ef991196f56c7f5f7b6161daa005 (diff)