Skip to content

Add documentation for rust for release#242

Open
leekeiabstraction wants to merge 2 commits intoapache:mainfrom
leekeiabstraction:rust-release-doc
Open

Add documentation for rust for release#242
leekeiabstraction wants to merge 2 commits intoapache:mainfrom
leekeiabstraction:rust-release-doc

Conversation

@leekeiabstraction
Copy link
Contributor

Purpose

Linked issue: close #241

Also ensure that LATEST_OFFSET const is exported

Tests

Manually tested individual sections

@leekeiabstraction
Copy link
Contributor Author

@luoyuxia Appreciate your review here.

LMK how this format of doc is OK, if so, I can proceed to python and c++ docs as well.

@leekeiabstraction
Copy link
Contributor Author

@luoyuxia Are you OK to trigger the workflow again? Thank you

@luoyuxia
Copy link
Contributor

luoyuxia commented Feb 7, 2026

@leekeiabstraction Hi, I think after #263 , the document should be updated

@leekeiabstraction
Copy link
Contributor Author

@luoyuxia The PR has been updated following API changes. PTAL!

@fresh-borzoni
Copy link
Contributor

fresh-borzoni commented Feb 8, 2026

@leekeiabstraction Looks good, just add a note about result handle users can opt to await or fire-and-forget, otherwise it's good 👍

it was the main idea of #263

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 Rust client ahead of release, and exposes a LATEST_OFFSET constant for log scanning APIs.

Changes:

  • Added a comprehensive Rust client guide (docs/rust-client.md) covering setup, admin ops, reads/writes, partitioning, and data types.
  • Exported LATEST_OFFSET alongside EARLIEST_OFFSET for scan subscriptions.

Reviewed changes

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

File Description
docs/rust-client.md New Rust client guide content and usage examples (currently contains several API/compilation mismatches).
crates/fluss/src/client/table/mod.rs Exposes LATEST_OFFSET constant for consumers (re-exported via fluss::client::*).

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

@leekeiabstraction
Copy link
Contributor Author

@luoyuxia Addressed comments, most came up because I didn't rebase changes from main. PTAL!

@leekeiabstraction
Copy link
Contributor Author

Another round of Copilot review would be good as the previous one had a lot of noise from not rebasing from main.

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

Copilot reviewed 1 out of 1 changed files in this pull request and generated 1 comment.


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

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@leekeiabstraction
Copy link
Contributor Author

Addressed copilot comment

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.

@leekeiabstraction Thanks for the pr. Left some comments. PTAL


This guide covers how to use the Fluss Rust client for reading and writing data to log tables and primary key tables.

## Prerequisites
Copy link
Contributor

Choose a reason for hiding this comment

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

we can move this part to build from source?


Available features:
- `storage-memory` (default) - In-memory storage
- `storage-fs` (default) - Filesystem storage
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
- `storage-fs` (default) - Filesystem storage
- `storage-fs` (default) - Local Filesystem storage

cargo build --workspace --all-targets
```

### 4. Run Tests
Copy link
Contributor

Choose a reason for hiding this comment

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

I think we can remove this part.

| `double` | `f64` | `get_double()`, `set_field(idx, f64)` |
| `string` | `&str` | `get_string()`, `set_field(idx, &str)` |
| `boolean` | `bool` | `get_boolean()`, `set_field(idx, bool)` |
| `bytes` | `&[u8]` | `get_bytes()`, `set_field(idx, &[u8])` |
Copy link
Contributor

Choose a reason for hiding this comment

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

seem some Fluss types are missing.

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 documentation for rust

3 participants