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

Fix python docstrings for dataframe APIs #7761

Merged
merged 12 commits into from
Oct 17, 2024
Merged

Conversation

jleibs
Copy link
Member

@jleibs jleibs commented Oct 16, 2024

What

  • Resolves: Python APIs need docstrings and generated docs #7760
  • Confirms that every item in rerun_bindings.pyi has a docstring
  • Validates that the docstrings from the .pyi actually match the __doc__ strings provided by pyo3
  • Updates griffe / mkdocstrings to get them to do the right thing

TODO:

  • Fix all the new issues this uncovers
  • Clean up some of the docstrings where necessary to include Param defs, etc.
  • Either get griffe to handle the missing .so or move doc tests to an environment with the built wheel

If anybody wants to tackle cleaning some of this up:

  • Write docstrings on things in the .pyi file
  • Add matching docstrings to the corresponding rust functions
  • Run pixi run py-build and then pixi run py-check-signatures to verify everything looks good

Checklist

  • I have read and agree to Contributor Guide and the Code of Conduct
  • I've included a screenshot or gif (if applicable)
  • I have tested the web demo (if applicable):
  • The PR title and labels are set such as to maximize their usefulness for the next release's CHANGELOG
  • If applicable, add a new check to the release checklist!
  • If have noted any breaking changes to the log API in CHANGELOG.md and the migration guide

To run all checks from main, comment on the PR with @rerun-bot full-check.

@jleibs jleibs added 🐍 Python API Python logging API feat-dataframe-api Everything related to the dataframe API exclude from changelog PRs with this won't show up in CHANGELOG.md labels Oct 16, 2024
Copy link

github-actions bot commented Oct 16, 2024

Deployed docs

Commit Link
5f68e78 https://landing-4pzjfwbzf-rerun.vercel.app/docs

@jleibs jleibs force-pushed the jleibs/validate_pyi_docstrings branch from b6a79fb to 592d464 Compare October 16, 2024 03:30
@jleibs jleibs force-pushed the jleibs/validate_pyi_docstrings branch from 4aca01b to 14ebd1a Compare October 16, 2024 14:53
@jleibs jleibs marked this pull request as ready for review October 16, 2024 15:27
@jleibs jleibs added this to the 0.19 - Dataframe and video milestone Oct 16, 2024
@jleibs jleibs changed the title Expand python_check_signatures.py to validate docstrings Fix python docstrings for dataframe APIs Oct 16, 2024
@emilk emilk self-requested a review October 17, 2024 05:45
Copy link
Member

@emilk emilk left a comment

Choose a reason for hiding this comment

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

⭐⭐⭐

@emilk emilk merged commit fedc962 into main Oct 17, 2024
41 checks passed
@emilk emilk deleted the jleibs/validate_pyi_docstrings branch October 17, 2024 05:51
emilk added a commit that referenced this pull request Oct 17, 2024
### What
- Needing to use `rr.dataframe.ColumnSelector(...)` is a pain.
- Allow the syntax: "entity/path:Component"

Based on top of: 
- #7761
to avoid conflicts. Rebase after mering 7761

### Checklist
* [x] I have read and agree to [Contributor
Guide](https://github.com/rerun-io/rerun/blob/main/CONTRIBUTING.md) and
the [Code of
Conduct](https://github.com/rerun-io/rerun/blob/main/CODE_OF_CONDUCT.md)
* [x] I've included a screenshot or gif (if applicable)
* [x] I have tested the web demo (if applicable):
* Using examples from latest `main` build:
[rerun.io/viewer](https://rerun.io/viewer/pr/7786?manifest_url=https://app.rerun.io/version/main/examples_manifest.json)
* Using full set of examples from `nightly` build:
[rerun.io/viewer](https://rerun.io/viewer/pr/7786?manifest_url=https://app.rerun.io/version/nightly/examples_manifest.json)
* [x] The PR title and labels are set such as to maximize their
usefulness for the next release's CHANGELOG
* [x] If applicable, add a new check to the [release
checklist](https://github.com/rerun-io/rerun/blob/main/tests/python/release_checklist)!
* [x] If have noted any breaking changes to the log API in
`CHANGELOG.md` and the migration guide

- [PR Build Summary](https://build.rerun.io/pr/7786)
- [Recent benchmark results](https://build.rerun.io/graphs/crates.html)
- [Wasm size tracking](https://build.rerun.io/graphs/sizes.html)

To run all checks from `main`, comment on the PR with `@rerun-bot
full-check`.

---------

Co-authored-by: Emil Ernerfeldt <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
exclude from changelog PRs with this won't show up in CHANGELOG.md feat-dataframe-api Everything related to the dataframe API 🐍 Python API Python logging API
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Python APIs need docstrings and generated docs
2 participants