diff --git a/README.en.md b/README.en.md new file mode 100644 index 0000000000000000000000000000000000000000..0e78e1d6070d8ed3336f52b1b4dc822f770570a1 --- /dev/null +++ b/README.en.md @@ -0,0 +1,31 @@ +# QLike + +QLike is an experimental project dedicated to exploring and implementing advanced generic mixin solutions and related meta-programming techniques. This project aims to provide a safer and more efficient approach to property reflection implementation, while addressing various limitations imposed by traditional string mixin methods. + +## Features + +- **Pure Compile-Time Function Execution (CTFE) Property Reflection**: Utilizes D language's compile-time computation capabilities to achieve type-safe property access. +- **No String Mixins**: Avoids the use of string mixins, thereby enhancing code safety and maintainability. +- **Direct Trait Access**: Allows direct access to struct members, simplifying the property collection process. +- **Generic Signal Handling**: Supports dynamic processing of object properties at runtime. + +## Documentation + +For detailed design decisions and technical implementations, please refer to the following documents: + +- [`PROPERTYINFO_REFACTORING.md`](PROPERTYINFO_REFACTORING.md) - Refactoring notes for property accessors. +- [`PURE_CTFE_IMPLEMENTATION.md`](PURE_CTFE_IMPLEMENTATION.md) - Implementation details of pure CTFE property reflection. +- [`REFLECTION_IMPLEMENTATION.md`](REFLECTION_IMPLEMENTATION.md) - Overview of generic property reflection implementation. +- [`SOLUTION_SUMMARY.md`](SOLUTION_SUMMARY.md) - Summary of the solution and architectural advantages. + +## Validation + +All critical features have been verified through build tests and runtime validation to be effective, without introducing breaking changes. + +## License + +This project follows the same licensing agreement as the repository. Please see the [LICENSE](LICENSE) file for more information. + +## Contributions + +If you are interested in contributing to QLike, please first review the current list of issues or contact the project maintainers to learn how to get involved. \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000000000000000000000000000000000000..59a7d39d76886f5d88a34979544ca95e7b18c502 --- /dev/null +++ b/README.md @@ -0,0 +1,31 @@ +# QLike + +QLike 是一个实验性项目,专注于探索和实现先进的泛型混入(mixin)解决方案及相关元编程技术。该项目旨在提供一种更安全、更高效的属性反射实现方式,同时解决传统字符串混入所带来的各种限制。 + +## 特性 + +- **纯编译时函数执行(CTFE)属性反射**:利用 D 语言的编译时计算能力来实现类型安全的属性访问。 +- **无字符串混入**:避免使用字符串混入,从而提高代码的安全性和可维护性。 +- **直接特征访问**:允许直接访问结构体成员,简化了属性收集过程。 +- **泛型信号处理**:支持在运行时动态处理对象属性。 + +## 文档 + +有关详细的设计决策和技术实现,请参阅以下文档: + +- [`PROPERTYINFO_REFACTORING.md`](PROPERTYINFO_REFACTORING.md) - 属性访问器重构说明。 +- [`PURE_CTFE_IMPLEMENTATION.md`](PURE_CTFE_IMPLEMENTATION.md) - 纯 CTFE 属性反射实现细节。 +- [`REFLECTION_IMPLEMENTATION.md`](REFLECTION_IMPLEMENTATION.md) - 泛型属性反射实现概述。 +- [`SOLUTION_SUMMARY.md`](SOLUTION_SUMMARY.md) - 解决方案总结与架构优势。 + +## 使用验证 + +所有关键功能都已通过构建测试和运行时验证确认有效,并且没有引入破坏性变更。 + +## 许可证 + +本项目遵循与仓库一致的许可证协议。请查看 [LICENSE](LICENSE) 文件以获取更多信息。 + +## 贡献 + +如果您有兴趣为 QLike 做出贡献,请先查阅当前的问题列表或联系项目维护者了解如何参与。 \ No newline at end of file