first commit with implemented code and backbones

Author: Charliechen114514

codes_and_assets/ini_map/CMakeLists.txt

@@ -0,0 +1,16 @@
+cmake_minimum_required(VERSION 3.25)
+project(Week1_ini_parse_Projects VERSION 0.1 LANGUAGES CXX)
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
+set(CMAKE_BUILD_TYPE "Debug")
+
+message(STATUS "Configuring the example utils sources for core")
+add_subdirectory(example_utils)
+message(STATUS "Configuring the example utils sources for core done")
+
+add_subdirectory(string_splits)
+add_subdirectory(ini_parse)
+
+add_subdirectory(example)
+add_subdirectory(test)
+

codes_and_assets/ini_map/example/CMakeLists.txt

@@ -0,0 +1,3 @@
+add_executable(example_ini example_ini.cpp)
+target_link_libraries(example_ini PRIVATE IniParser)
+

codes_and_assets/ini_map/example/example_ini.cpp

@@ -0,0 +1,42 @@
+#include "ini_parse.h"
+#include <cassert>
+#include <iostream>
+#include <string>
+
+const char* sample = R"ini(
+; this is a comment
+# also a comment
+; top-level keys
+topkey = topvalue
+
+[server]
+host = example.com
+port= 8080
+path = "/api/v1/resource" ; inline comment
+escaped = "line\nnew"  # another inline comment
+
+[database]
+user = dbuser
+password = "p@ss;word" ; note semicolon inside quoted value
+timeout=30
+
+)ini";
+
+int main() {
+	using namespace cxx_utils::ini_parser;
+
+	IniParser parser;
+	bool ok = parser.parse({ sample });
+	assert(ok);
+
+	for (const auto& sec_pair : parser.data()) {
+		std::cout << "[" << sec_pair.first << "]\n";
+		for (const auto& kv : sec_pair.second) {
+			std::cout << kv.first << " = " << kv.second << "\n";
+		}
+		std::cout << "\n";
+	}
+
+	std::cout << "All tests passed.\n";
+	return 0;
+}

codes_and_assets/ini_map/example_utils/CMakeLists.txt

@@ -0,0 +1,5 @@
+add_subdirectory(privates)
+
+add_library(ExampleUtils STATIC banner.cpp)
+target_include_directories(ExampleUtils PUBLIC .)
+target_link_libraries(ExampleUtils PRIVATE ExampleUtilsPrivate)

codes_and_assets/ini_map/example_utils/banner.cpp

@@ -0,0 +1,26 @@
+#include "banner.h"
+#include "banner/banner_private.h"
+#include <cstddef>
+#include <sstream>
+#include <string_view>
+
+namespace cxx_utils::example_utils {
+
+std::string banner_src(std::string_view view,
+                       const BannerAlignment alignment,
+                       const char banner_ch) {
+	const size_t str_length = view.length();
+	const size_t banner_length = example_utils_private::expected_banner_length(view);
+	const size_t banner_escape_length = example_utils_private::expected_left_escape(alignment);
+	const std::string banners(banner_length, banner_ch);
+	const std::string escape_left(banner_escape_length, ' ');
+
+	std::ostringstream banner_stream;
+	banner_stream << banners << '\n'
+	              << escape_left << view << '\n'
+	              << banners << '\n';
+
+	return banner_stream.str();
+}
+
+}

codes_and_assets/ini_map/example_utils/banner.h

@@ -0,0 +1,44 @@
+/**
+ * @file banner.h
+ * @author Charliechen114514 (chengh1922@mails.jlu.edu.cn)
+ * @brief Banner Public Interfaces
+ * @version 0.1
+ * @date 2025-11-17
+ *
+ * @copyright Copyright (c) 2025
+ *
+ */
+
+#pragma once
+#include <string>
+#include <string_view>
+
+namespace cxx_utils {
+namespace example_utils {
+	/**
+	 * @brief   BannerAlignment indicated the alignment of
+	 *          string position
+	 *
+	 */
+	enum class BannerAlignment {
+		LEFT,
+		CENTER,
+		RIGHT
+	};
+
+	/**
+	 * @brief   Create A String Sources for banner, you can use it to
+	 *          Redirect to any IO
+	 *
+	 * @param view
+	 * @param alignment
+	 * @param banner_ch
+	 * @return std::string
+	 */
+	[[nodiscard("Don't Ignore the Return Value of"
+	            " Banner String, else why shell you create it :)")]]
+	std::string banner_src(std::string_view view,
+	                       const BannerAlignment alignment = BannerAlignment::CENTER,
+	                       const char banner_ch = '=');
+}
+}

codes_and_assets/ini_map/example_utils/example_utils.h

@@ -0,0 +1,13 @@
+/**
+ * @file example_utils.h
+ * @author Charliechen114514 (chengh1922@mails.jlu.edu.cn)
+ * @brief Summary Header for the Example Utilities
+ * @version 0.1
+ * @date 2025-11-17
+ *
+ * @copyright Copyright (c) 2025
+ *
+ */
+
+#pragma once
+#include "banner.h"

codes_and_assets/ini_map/example_utils/privates/CMakeLists.txt

@@ -0,0 +1,9 @@
+message(STATUS "Configuring the ExampleUtilsPrivate")
+add_library(ExampleUtilsPrivate STATIC
+            banner/banner_private.cpp 
+            banner/banner_private.h)
+
+
+target_include_directories(ExampleUtilsPrivate PUBLIC .)
+message(STATUS "Configuring the ExampleUtilsPrivate Done")
+

codes_and_assets/ini_map/example_utils/privates/banner/banner_private.cpp

@@ -0,0 +1,22 @@
+#include "banner_private.h"
+
+namespace cxx_utils::example_utils_private {
+std::size_t
+expected_banner_length(const std::string_view v) {
+	return 2 * LENGTH_ESCAPE + v.length();
+}
+
+std::size_t
+expected_left_escape(const example_utils::BannerAlignment alignment) {
+	switch (alignment) {
+	case example_utils::BannerAlignment::LEFT:
+		return 0;
+	case example_utils::BannerAlignment::CENTER:
+		return LENGTH_ESCAPE;
+	case example_utils::BannerAlignment::RIGHT:
+		return 2 * LENGTH_ESCAPE;
+	}
+	return LENGTH_ESCAPE;
+}
+
+}

codes_and_assets/ini_map/example_utils/privates/banner/banner_private.h

@@ -0,0 +1,17 @@
+#pragma once
+#include "../banner.h"
+#include <cstddef>
+#include <string_view>
+namespace cxx_utils {
+namespace example_utils_private {
+
+	static constexpr const size_t LENGTH_ESCAPE = 5;
+
+	std::size_t
+	expected_banner_length(const std::string_view v);
+
+	std::size_t
+	expected_left_escape(const example_utils::BannerAlignment alignment);
+
+}
+}