Skip to content

[TASK-285] python docs and API reference#291

Open
fresh-borzoni wants to merge 3 commits intoapache:mainfrom
fresh-borzoni:python-docs
Open

[TASK-285] python docs and API reference#291
fresh-borzoni wants to merge 3 commits intoapache:mainfrom
fresh-borzoni:python-docs

Conversation

@fresh-borzoni
Copy link
Contributor

Summary

closes #285

Added docs and API reference for python bindings

@fresh-borzoni
Copy link
Contributor Author

@leekeiabstraction @luoyuxia PTAL 🙏

Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds end-user documentation for the Fluss Python bindings, including a usage guide and a standalone API reference, addressing issue #285.

Changes:

  • Added a Python Client Guide with end-to-end examples (connect/admin/write/read, PK tables, partitioned tables).
  • Added a Python API Reference enumerating classes, methods, constants, and basic type mappings.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 8 comments.

File Description
docs/python-client.md New Python client guide with conceptual overview and usage examples for admin, writers, scanners, PK + partitioned tables.
docs/python-api-reference.md New API reference page listing Python binding classes/methods/constants and data type mappings.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@fresh-borzoni
Copy link
Contributor Author

Addressed comments, fixed TableDecriptor to match rust

Copy link
Contributor

@leekeiabstraction leekeiabstraction left a comment

Choose a reason for hiding this comment

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

TY for the PR, left one comment

@fresh-borzoni
Copy link
Contributor Author

@leekeiabstraction TY for checking, rebased

Copy link
Contributor

@luoyuxia luoyuxia left a comment

Choose a reason for hiding this comment

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

@fresh-borzoni Thanks for the pr. LGTM overall. Just left comments for document structure:

  • move these docs to binding/python since it's mainly for python
  • rename binding/python/README to DEVELOPMENT.md since it's mainly focus on how to develop. We may rename python-api-reference.md or python-client.md to real readme?

@fresh-borzoni
Copy link
Contributor Author

@luoyuxia TY for the review.
Renamed, moved, updated links
PTAL 🙏

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add document for python client

3 participants