alexinea / magic-wand

Mysterious project, code-named "MagicWand", is a mentor and friend that helps people improve their development efficiency.

Hi there 👋

I'm Alex LEWIS. You can contact me through these platforms: Weibo, Twitter, Blog, Douban, Bangumi and Telegram

magic-wand's Issues

[proposal] magic-wand: The vision of this project

Getting or setting object properties or fields is an essential feature in any object-oriented programming language, although the implementation and usage can vary. In the case of C#, is there a way to manipulate objects similar to how dictionaries are manipulated? The answer is yes, and there are several options available, such as FastMember, Leo, Newbee ObjectVisitor, or Cosmos ObjectVisitors.

Here is a brief comparison of these four projects:

• FastMember is based on IL and does not support .NET Core / .NET Next.
  • Based on the contributions #85 and #86, I forked the project alexinea-fast-member to add support for .NET Core / .NET Next.
  • Based on the experience of developing NMS Leo, I created alexinea-fast-member-extensions to enhance the usability of FastMember.
• Leo is developed based on NCC Natasha and does not support value types, dynamic types, collections, arrays, dictionaries, etc.
• Newbee ObjectVisitor is implemented based on expression trees but the project has been archived.
• Cosmos ObjectVisitor supports value types, dynamic types, partially supports collections, arrays, dictionaries, but it only supports .NET 6+ projects and depends on cosmos-stack.
• Additionally, the L, N, and C projects all have highly complete features such as Repeat and Validate, and it seems that providing implementations as extension packages would be better.

With careful consideration of the comparison results from the aforementioned four projects and taking into account the functional architecture requirements of Project Hana, a new project named "Project Magic Wand" has emerged.

Project Magic Wand should offer the following capabilities:

• It should be backward compatible with .NET Framework 4.6.1 and support NFX/Core/Next,
• It should support various types, including value types (primitive types and structs), reference types, dynamic types, collections, arrays, and dictionaries,
• It should enable reading and writing of public/private instance members and static members (properties or fields), as well as reading of read-only members (properties or fields),
• It should support accessing "nested members" and "members of a collection", and
• Non-core functionalities like Repeat and Validate should be excluded from the project and left to the community ecosystem for implementation through extension packages.

The aforementioned goals will be progressively implemented and optimized through multiple iterations. We will closely follow and refine the project based on the standards proposed by Cosmos CEP and the requirements and goals expressed by the user group.