-
Notifications
You must be signed in to change notification settings - Fork 1.7k
Ruby: data flow docs #10932
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
Ruby: data flow docs #10932
Conversation
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.
Looks great!
@calumgrant requested that we make an early start on reviews, so I put in my comments for now
expr = call.getArgument(0).getALocalSource() | ||
select call, expr | ||
|
||
All these three queries give identical results. |
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.
FYI there's currently a discrepancy between localFlow
and flowsTo
as the latter does not include capture steps, but I aim to fix that in my PR. Hopefully it will be true around the time we merge this 😄
Just mentioning it in case anyone else stumbles across this and wonders what's going on.
docs/codeql/codeql-language-guides/analyzing-data-flow-in-ruby.rst
Outdated
Show resolved
Hide resolved
4218472
to
b1da636
Compare
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.
Some minor suggestions that can be safely ignored. Nice!
docs/codeql/codeql-language-guides/analyzing-data-flow-in-ruby.rst
Outdated
Show resolved
Hide resolved
👋 Docs first responder here! I've put this on our board for someone to pick up and review |
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.
@nickrolfe - thanks for writing this new article for people who want to explore data flow in Ruby code.
It's a while since I looked at any articles like this but it generally seems clear. I've made some suggestions that I hope will make the content easier to read.
docs/codeql/codeql-language-guides/analyzing-data-flow-in-ruby.rst
Outdated
Show resolved
Hide resolved
docs/codeql/codeql-language-guides/analyzing-data-flow-in-ruby.rst
Outdated
Show resolved
Hide resolved
docs/codeql/codeql-language-guides/analyzing-data-flow-in-ruby.rst
Outdated
Show resolved
Hide resolved
docs/codeql/codeql-language-guides/analyzing-data-flow-in-ruby.rst
Outdated
Show resolved
Hide resolved
docs/codeql/codeql-language-guides/analyzing-data-flow-in-ruby.rst
Outdated
Show resolved
Hide resolved
docs/codeql/codeql-language-guides/analyzing-data-flow-in-ruby.rst
Outdated
Show resolved
Hide resolved
docs/codeql/codeql-language-guides/analyzing-data-flow-in-ruby.rst
Outdated
Show resolved
Hide resolved
docs/codeql/codeql-language-guides/analyzing-data-flow-in-ruby.rst
Outdated
Show resolved
Hide resolved
docs/codeql/codeql-language-guides/analyzing-data-flow-in-ruby.rst
Outdated
Show resolved
Hide resolved
docs/codeql/codeql-language-guides/analyzing-data-flow-in-ruby.rst
Outdated
Show resolved
Hide resolved
Co-authored-by: Felicity Chapman <[email protected]>
Thanks for the review @felicitymay – your suggestions were all great. I think some of them would also apply to the Python version of this document. |
Many thanks for the updates @nickrolfe - especially the expanded explanations of the final examples 💖 |
I'd like to see the tests passing, so that I can see the generated output, before approving this PR. Possibly we can get #10957 merged today, so that we can update the PR to include the new article 🙂 |
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.
The Sphinx preview looks good and didn't reveal any formatting issues 🚀
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.
Great stuff!
No description provided.