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

python: Add typing to RPC server and Messenger #4639

Merged
merged 32 commits into from
Nov 3, 2024

Conversation

echoix
Copy link
Member

@echoix echoix commented Nov 2, 2024

The common denominator here were all places that used connection objects from multiprocessing.Pipe. The documentation comment was wrong, as it isn't the pipe that is used, but one of the two Connection objects.

For the multiprocessing.Lock objects used, the acquire() and release() were changed to use a context manager, making sure (to the extents possible) that the resource is released even on errors. This was tested more than a month ago, in the same work where for the PR that did some profiling and benchmarking with hyperfine. (I was trying alternatives to this kind of RPC server, but I wasn't satisfied with what I got). However, the context manager and locks are a good practice that is valuable to include.

While I did try to completely type the messages class and file, I reverted it as it wasn't that much clearer, only correctly understood with very new Python syntax, and changed lists to tuples. Nevertheless, type checking of the possible data received highlighted the fact that the docs (which I wrote the typing from) didn't include the "INFORMATION" level, as it was "unused". That is what is nice when type checking and using Literal[] for expected values. So the docstring is updated in consequence.

…hey would be released when unlocked (RuntimeError: release unlocked lock)
…it is a multiprocessing.Connection object obtained from multiprocessing.Pipe
…Connection object obtained from multiprocessing.Pipe
…connection.Connection object obtained from multiprocessing.Pipe
@echoix echoix requested a review from ninsbl November 2, 2024 14:11
@github-actions github-actions bot added Python Related code is in Python libraries tests Related to Test Suite labels Nov 2, 2024
Copy link
Member

@ninsbl ninsbl left a comment

Choose a reason for hiding this comment

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

Looks good to me!

I do not have a deeper understanding of this area of the code or library functions though...

@echoix echoix merged commit 35ebcb3 into OSGeo:main Nov 3, 2024
26 checks passed
@github-actions github-actions bot added this to the 8.5.0 milestone Nov 3, 2024
@a0x8o a0x8o mentioned this pull request Nov 6, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
libraries Python Related code is in Python tests Related to Test Suite
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants