Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Feat/allow passing answer from @on to @after hook #683

Open
wants to merge 4 commits into
base: master
Choose a base branch
from

Conversation

OSkrk
Copy link
Collaborator

@OSkrk OSkrk commented Nov 26, 2024

This PR addresses the feature discussed here, allowing the response sent inside the @on to be passed to the @after hook for further processing (avoiding the use of temp variables). The feature enables the @after decorator to accept an inject_response parameter, which can be used to control whether the response from the _on_action handler is passed to the _after_action handler, and guarantees backwards compatibility.

@OrangeTux , @tropxy, @HugoJP1, @mdwcrft would like to know you guy's feedback on this.

tests/test_charge_point.py Outdated Show resolved Hide resolved
Copy link
Contributor

@astrand astrand left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for working on this!

**snake_case_payload, on_response=response_payload
)
else:
response = handler(**snake_case_payload)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not so "elegant" to have 4 calls to handler(). My suggestion is to use keyword arguments instead, like I did in #264 (comment) .

Copy link
Collaborator Author

@OSkrk OSkrk Dec 1, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This approach was suggested by @tropxy in this comment and clarified by @OrangeTux in a later comment (both authors of this repo). There is no 4 calls to the handler, the handler is only called once depending on the parameters.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@OSkrk what @astrand is suggesting is something like this (right @astrand ?):

if "call_unique_id" in handler_signature.parameters:
    snake_case_payload["call_unique_id"] = msg.unique_id
if  inject_response:
    snake_case_payload["on_response"] = response_payload

response = handler(**snake_case_payload)

May you try that and see if it works?

Note: I have used your current nomenclature, but if you change the code then "on_response" will be "call_response"

@@ -356,10 +356,25 @@ async def _handle_call(self, msg):
call_unique_id_required = "call_unique_id" in handler_signature.parameters
# call_unique_id should be passed as kwarg only if is defined explicitly
# in the handler signature
inject_response = getattr(handler, "_inject_response", False)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why check attribute on the handler, instead of checking signature parameters? This opens up for some corner cases, like if inject_response is True but after handler does not accept "on_response" kwarg. Also it is different from how call_unique_id is handled.

Copy link
Collaborator Author

@OSkrk OSkrk Dec 1, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@astrand , thanks for your comment. Why would you set the flag to True (which defaults to False) to pass the reponse and do not accept it in the @after ?

@@ -56,7 +56,7 @@ def inner(*args, **kwargs):
return decorator


def after(action):
def after(action, inject_response=False):
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

can you include notes in the doc strings in respect to the new argument and its purpose?

response = handler(
**snake_case_payload,
call_unique_id=msg.unique_id,
on_response=response_payload,
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It would be better the term "call_response". The "on" prefix is given to functions/callbacks as an action will be performed via that callback function. Here we want to pass an argument..

**snake_case_payload, on_response=response_payload
)
else:
response = handler(**snake_case_payload)
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@OSkrk what @astrand is suggesting is something like this (right @astrand ?):

if "call_unique_id" in handler_signature.parameters:
    snake_case_payload["call_unique_id"] = msg.unique_id
if  inject_response:
    snake_case_payload["on_response"] = response_payload

response = handler(**snake_case_payload)

May you try that and see if it works?

Note: I have used your current nomenclature, but if you change the code then "on_response" will be "call_response"

@OrangeTux
Copy link
Contributor

I don't have anything against this PR. I leave it up to the new maintainers to approve and merge it.

I'll have a call with the new maintainers this Friday and I'll bring this PR to the table.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Development

Successfully merging this pull request may close these issues.

4 participants