refactor: implement active logic hooks

[sIHURs]

This PR implements on_setattr and on_getattr hook functionality for DataClass fields. Hooks and attribute changes are only allowed during the initialization stage. After the object is fully instantiated, static fields become strictly read-only (frozen).

In fdtdx/objects/object.py:

@autoinit
class SimulationObject(TreeClass, ABC):
    ...
    name: str = frozen_field(  # type: ignore
        default=None,
        on_setattr=[UniqueName()],
    )
    ...

and now adopt the drinx library:

class UniqueName(DataClass):
    def __call__(self, x: str | None) -> str:
        print("hello from uniquename")
        global _GLOBAL_COUNTER
        if x is None:
            name = f"Object_{_GLOBAL_COUNTER}"
            _GLOBAL_COUNTER += 1
            return name
        return x

class SimulationObject(DataClass, ABC):
    ...
    name: str = static_field(
        default=None,
        on_setattr=(UniqueName(),), 
    )
    ...

[ymahlau]

@cubic-dev-ai review

[ymahlau]

Hi @sIHURs, the code looks mostly good to me! Only the CI-pipeline is failing due to some small type errors, could you fix that please?

[ymahlau]

One minor comment regarding the example you provided, I dont think it is necessary to have UniqueName(DataClass) be a subclass of DataClass. This could just be a simple function when you implement this feature in fdtdx.

[codecov-commenter]

Codecov Report

❌ Patch coverage is 68.18182% with 28 lines in your changes missing coverage. Please review.
✅ Project coverage is 86.47%. Comparing base (6cb3e8f) to head (9639106).

Files with missing lines	Patch %	Lines
src/drinx/base.py	65.85%	23 Missing and 5 partials ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main       #7      +/-   ##
==========================================
- Coverage   91.03%   86.47%   -4.56%     
==========================================
  Files           6        6              
  Lines         368      451      +83     
  Branches       84       96      +12     
==========================================
+ Hits          335      390      +55     
- Misses         16       39      +23     
- Partials       17       22       +5     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.