-
Notifications
You must be signed in to change notification settings - Fork 198
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
Pin to recent breathe, to prevent getting an unsupported sphinx version. #1495
Conversation
There are some warnings in CI that I don't know how to fix. https://github.com/rapidsai/rmm/actions/runs/8158164146/job/22300050680?pr=1495#step:9:1013
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I like it. Thanks!
python_names_to_skip = [x for x in dir(int) if not x.startswith("__")] | ||
if ( | ||
node["refdomain"] == "py" | ||
and (reftarget := node.get("reftarget")) is not None | ||
and any(toskip in reftarget for toskip in python_names_to_skip) | ||
): |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Nit: Could you just concatenate all the python names_to_skip
that satisfy the refdomain/reftarget conditions with the C++ names to skip and have a single final any(toskip...)
condition? Not sure if that would be more or less coherent.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
There is a difference in node["refdomain"] == "py"
and node["refdomain"] == "cpp"
. I think that's enough reason to separate these.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Ah, I missed the C++ side conditions because the any
is inside the outer if
on the Python side but in a nested one on the C++ side.
/merge |
Description
The RMM nightly docs builds failed. https://github.com/rapidsai/rmm/actions/runs/8151286975/job/22279173933#step:9:973
It ran into an error reported in sphinx-doc/sphinx#11490. It seems like a viable fix (that is also minimal and somewhat future-proof) is to pin to a recent version of
breathe
, which in turn forces a compatible version of sphinx. This is the same pinning used by cudf.Checklist