Skip to content

docs: Add module docs #114

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

Merged
merged 4 commits into from
Jul 11, 2025
Merged

docs: Add module docs #114

merged 4 commits into from
Jul 11, 2025

Conversation

rklaehn
Copy link
Collaborator

@rklaehn rklaehn commented Jul 11, 2025

Description

Adds module docs and includes the README.md into the docs so the example in README.md is being tested.

Breaking Changes

None, I guess. The additional deref is not breaking.

Notes & open questions

There is an unrelated change, adding back lifetimes, the lack of which that make my local clippy unhappy (I only removed the lifetimes because of clippy in the first place).

Change checklist

  • Self-review.
  • Documentation updates following the style guide, if relevant.
  • Tests if relevant.
  • All breaking changes documented.

rklaehn added 3 commits July 11, 2025 16:39
Was broken by #112
clippy was the reason I changed this in the first place... :rollseyes:
Copy link

github-actions bot commented Jul 11, 2025

Documentation for this PR has been generated and is available at: https://n0-computer.github.io/iroh-blobs/pr/114/docs/iroh_blobs/

Last updated: 2025-07-11T15:01:47Z

@rklaehn rklaehn force-pushed the add-module-docs branch 2 times, most recently from 215b850 to 355a775 Compare July 11, 2025 14:42
@rklaehn rklaehn requested a review from matheus23 July 11, 2025 14:45
Copy link
Member

@matheus23 matheus23 left a comment

Choose a reason for hiding this comment

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

Just some nits

Comment on lines +72 to +74
fn deref(&self) -> &Self::Target {
&self.inner.store
}
Copy link
Member

Choose a reason for hiding this comment

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

Personally I'm not a huge fan of derefs, but also 🤷

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Personally I'm not a huge fan of derefs, but also 🤷

If we don't like derefs in public APIs, we would also have to remove the deref from MemStore and FsStore to the client API. But if we want to do this, it would have to be a separate PR since it would affect a lot of places.

Also add a missing Deref so you can use BlobsProtocol as a Store directly.
@rklaehn rklaehn merged commit 91459aa into main Jul 11, 2025
24 checks passed
@rklaehn rklaehn deleted the add-module-docs branch July 11, 2025 15:07
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.

2 participants