fix macro issue for mcpp and adapt for d2x 0.1.1 (#2)

* fix macro issue for mcpp and adapt for d2x 0.1.1

- mcpp-community/OpenOrg#1

Signed-off-by: sunrisepeak <speakshen@163.com>

* update readme

* update readme

---------

Signed-off-by: sunrisepeak <speakshen@163.com>

Author: Sunrisepeak

README.md

@@ -18,6 +18,14 @@
 - d2x工具可以直接识别和加载
 - 提供了项目依赖描述, 支持一键配置环境
 
+## 快速开始
+
+- 第一步: 点击 [新建教程模板](https://github.com/new?template_name=d2x-project-template&template_owner=d2learn) 按钮, 通过模板仓库创建新教程项目
+- 第二步: 克隆新仓库到本地 - `git clone git@github.com:your_name/your_repo_name.git`
+- 第三步:
+  - [安装d2x工具](https://d2learn.github.io/d2x-project-template/chapter_1.html)
+  - [认识项目结构并配置](https://d2learn.github.io/d2x-project-template/chapter_2.html)
+
 ## 具体项目案例
 
 | 项目 | 简介 | 备注 |

book/src/chapter_1.md

@@ -43,6 +43,16 @@ TODO...
 
 ### 创建项目
 
+**通过模块创建(推荐)**
+
+点击 [新建教程模板](https://github.com/new?template_name=d2x-project-template&template_owner=d2learn) 按钮, 通过模板仓库创建新教程项目. 然后, 再把生成的仓库clone到本地
+
+```bash
+git clone git@github.com:your_name/your_repo_name.git
+```
+
+**本地创建**
+
 通过`d2x new xxx`命令创建一个新项目
 
 ```
@@ -51,7 +61,7 @@ d2x new d2hello
 
 命令运行后会生成一个叫`d2hello`的目录, 进入/打开这个目录就能看到项目的基础结构
 
-## 测试
+### 测试
 
 进入新创建项目的根目录, 运行命令进行测试完整性
 

book/src/chapter_2.md

@@ -28,8 +28,8 @@ d2x类项目是一种强调交互的教程类项目, 他通常由 `[Book + Video
 ├── config.xlings
 ├── d2x
 ├── dslings                ////// Code: 项目练习代码目录
-│   ├── hello-mcpp.cpp       // 具体的练习代码
-│   ├── helloworld.cpp       
+│   ├── hellomcpp.cpp        // 具体的练习代码
+│   ├── hellocpp.cpp       
 │   └── xmake.lua            // 练习代码编排和配置文件
 ├── LICENSE
 ├── README.md
@@ -148,20 +148,19 @@ d2x checker
 根据控制台报错, 修复代码并观察控制台的变化. 下面是控制台的信息解释
 
 ```
-🌏Progress: [>----------] 0/10 -->> 显示当前的练习进度
+ 🌏 ▒░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0/2  -->> 显示当前的练习进度
+                                                                                                                               
+ ✗ hellocpp                 -->> 当前显示检测状态和练习名
+ + → dslings/hellocpp.cpp   -->> 当前练习的文件路径
+                                                                                                                               
+ [ 23%]: cache compiling.release dslings/hellocpp.cpp -->> 显示编译状态
+ error: dslings/hellocpp.cpp:29:39: error: found ':' in nested-name-specifier, expected '::'
+    29 |     std::cout << "hello, mcpp!" << std:endl; // 0.修复这个编译错误
+       |                                       ^
+       |                                       ::
+   ▼ 5 more lines below...
 
-[Target: 00-0-hello-mcpp] - normal -->> 当前的练习名
-
-❌ Error: Compilation/Running failed for dslings/hello-mcpp.cpp -->> 显示检测状态
-
- The code exist some error!
-
----------C-Output--------- - 编译器输出信息
-[HONLY LOGW]: main: dslings/hello-mcpp.cpp:24 - ❌ | a == 1.1 (1 == 1.100000) -->> 错误提示及位置(24行)
-[HONLY LOGW]: main: dslings/hello-mcpp.cpp:26 - 🥳 Delete the D2X_WAIT to continue...
-
-
-AI: xxx -->> AI提示(需要配置大模型的key, 可不使用)
+🤖:   AI Disabled / 未启用 - https://github.com/d2learn/d2x  -->> 显示AI状态/信息(需要配置大模型的key, 可不使用)
 ```
 
 > 注: 退出检测程序使用`ctrl + c`
@@ -176,7 +175,7 @@ AI: xxx -->> AI提示(需要配置大模型的key, 可不使用)
 在`dslings`目录创建`0-test.cpp`文件, 并添加如下内容
 
 ```cpp
-#include <d2x/cpp/common.hpp> // 辅助工具
+#include <d2x/cpp/d2x.hpp> // 辅助工具
 
 #include <iosteam> // 故意写错测试 编译期检查
 
@@ -185,7 +184,8 @@ int main() {
 
     int a = 1;
     int b = 2;
-    d2x_assert_eq(a, b); // 测试运行时检查
+
+    d2x::assert_eq(a, b); // 测试运行时检查
 }
 ```
 
@@ -209,10 +209,10 @@ target("0-test")
 由d2x工具支持的自动化代码练习项目, 通过在项目根目录下
 执行 d2x checker 进入"编译器驱动开发模式"的练习代码自动检测.
 需要用户根据控制台的报错和提示信息, 修改代码中的错误. 当修复所有编译错误和
-运行时检查点后, 你可以删除或注释掉代码中的 D2X_WAIT 宏, 会自动进入下一个练习.
-  - D2X_WAIT: 该宏用于隔离不同练习, 你可以删除或注释掉该宏, 进入下一个练习.
-  - d2x_assert_eq: 该宏用于运行时检查点, 你需要修复代码中的错误, 使得所有
-  - D2X_YOUR_ANSWER: 该宏用于提示你需要修改的代码, 一般用于代码填空(即用正确的代码替换这个宏)
+运行时检查点后, 你可以删除或注释掉代码中的 d2x::wait(), 会自动进入下一个练习.
+  - d2x::wait(): 用于隔离不同练习, 你可以删除或注释掉, 进入下一个练习.
+  - d2x::assert_eq: 用于运行时检查点, 你需要修复代码中的错误, 使得所有
+  - D2X_YOUR_ANSWER: 用于提示你需要修改的代码, 一般用于代码填空(即用正确的代码替换他)
 
 ## 其他功能 (可选)
 

d2x/cpp/common.hpp

@@ -0,0 +1,40 @@
+#ifndef D2X_HPP__D2X
+#define D2X_HPP__D2X
+
+#include <iostream>
+#include <string>
+#include <source_location>
+#include <format>
+
+namespace d2x {
+    inline void wait(const std::source_location& loc = std::source_location::current()) {
+        std::cout << std::format("\033[33m{}:{} - 🥳 D2X_WAIT: Delete the 'd2x::wait()' or '//d2x::wait()' to continue...\033[0m\n", loc.file_name(), loc.line());
+    }
+
+    template <typename T1, typename T2>
+    inline bool assert_eq(const T1& a, const T2& b, const std::string& msg = "",
+                          const std::source_location& loc = std::source_location::current()) {
+        if (a != b) {
+            std::cout << std::format("\033[31m{}:{} - ❌(error) | Assertion failed: {} != {}. {}\033[0m\n", 
+                        loc.file_name(), loc.line(), a, b, msg);
+            return false;
+        }
+        std::cout << std::format("\033[32m{}:{} - ✅ Assertion passed: {} == {}\033[0m\n", 
+                    loc.file_name(), loc.line(), a, b);
+        return true;
+    }
+
+    inline bool assert_true(bool condition, const std::string& msg = "",
+                            const std::source_location& loc = std::source_location::current()) {
+        if (!(condition)) {
+            std::cout << std::format("\033[31m{}:{} - ❌(error) | Assertion failed: condition is false. {}\033[0m\n", 
+                        loc.file_name(), loc.line(), msg);
+            return false;
+        }
+        std::cout << std::format("\033[32m{}:{} - ✅ Assertion passed: condition is true\033[0m\n", 
+                    loc.file_name(), loc.line());
+        return true;
+    }
+}
+
+#endif

d2x/cpp/common.lua

@@ -0,0 +1,13 @@
+module;
+
+#include <d2x/cpp/d2x.hpp>
+
+export module d2x;
+
+import std;
+
+export namespace d2x {
+    using d2x::wait;
+    using d2x::assert_eq;
+    using d2x::assert_true;
+};