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

Improve PhysicalExpr documentation #9180

Merged
merged 1 commit into from
Feb 9, 2024
Merged

Conversation

alamb
Copy link
Contributor

@alamb alamb commented Feb 9, 2024

Which issue does this PR close?

Part of #7013

Rationale for this change

I was working on another example, and I wanted to create a PhysicalExpr but could not figure out how to do so easily from the docs (I had to go poking around in the code)

Thus I wanted to provide improved documentation for myself (and I suspect others)

What changes are included in this PR?

  1. Improved documentation on PhysicalExpr
  2. Examples of how to create a PhysicalExpr and how to execute it

Are these changes tested?

Are there any user-facing changes?

Docs

@alamb alamb added the documentation Improvements or additions to documentation label Feb 9, 2024
@github-actions github-actions bot added physical-expr Physical Expressions and removed documentation Improvements or additions to documentation labels Feb 9, 2024
///
/// # Example: Create `PhysicalExpr` from `Expr`
/// ```
/// # use arrow_schema::{DataType, Field, Schema};
Copy link
Contributor Author

Choose a reason for hiding this comment

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

This looks pretty terrible in source form, but it renders reasonably I think

Screenshot 2024-02-09 at 7 57 06 AM

Copy link
Contributor

@comphead comphead left a comment

Choose a reason for hiding this comment

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

lgtm thanks @alamb

Copy link
Contributor

@appletreeisyellow appletreeisyellow left a comment

Choose a reason for hiding this comment

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

Thank you for making a better datafusion world @alamb!

@alamb alamb merged commit cdc5d00 into apache:main Feb 9, 2024
43 checks passed
@alamb
Copy link
Contributor Author

alamb commented Feb 9, 2024

This is mostly annoyance driven development -- when I am annoyed about an API as a user, I want to fix / make it easier to use :)

@alamb alamb deleted the alamb/moar_docs branch February 9, 2024 20:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
physical-expr Physical Expressions
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants