feat: MelleaSession.register for functional interface and MelleaSession.powerup for dynamic mixin (register all methods in a class)

[guicho271828]

No description provided.

[mergify]

Merge Protections

Your pull request matches the following merge protections and will not be merged until they are valid.

🟢 Enforce conventional commit

Wonderful, this rule succeeded.

Make sure that we follow https://www.conventionalcommits.org/en/v1.0.0/

• title ~= ^(fix|feat|docs|style|refactor|perf|test|build|ci|chore|revert|release)(?:\(.+\))?:

[jakelorocco]

Not sure if these are just issues with my type-hinter / the default one in VSCode.

It may not be possible to dynamically create these methods while retaining basic intellisense and type hinting.

[jakelorocco]

this works for me; but doesn't offer any intellisense / tab completes / type hinting.

I don't think there's an extendable solution that updates the type completion. The best we could do is force modules to export a single protocol; something like:

class ThisSpecificPowerup(Protocol):
  def hello():
      ...

class PoweredUp(ThisSpecificPowerup, MelleaSession):
    ...

def apply(m: MelleaSession) -> PowerdUp
    ... # do work here to apply
    return m

m.hello() # this is properly type hinted / etc...

But this only works for one set of power ups at a time.

[guicho271828]

Well, now this PR does not remove any feature (like the one with register commits which made docstrings invisible), only adds one which has a room of improvement for future revisions. Progress over Perfection, this should not preclude merging. I need this feature for internal va users.

[jakelorocco]

allows the methods to be called; I will give up on type-hinting / intellisense