Skip to content

docs(vendored): update bam_codec comments to reflect noodles#364 closure - #182

Merged
nh13 merged 1 commit into
mainfrom
nh/docs-vendored-codec-phase1
Mar 23, 2026
Merged

nh13 merged 1 commit into
mainfrom
nh/docs-vendored-codec-phase1

Conversation

@nh13

@nh13 nh13 commented Mar 23, 2026

Copy link
Copy Markdown
Member

Summary

  • Remove noodles#364 from the pending-upstream-PR list since it was closed (not merged)
  • Update vendored bam_codec module docs to explain why the vendored code is retained: encode_record_buf is still needed for the raw-byte-mode optimization path
  • Clarify that the vendored codec can be removed once refactor(sort): demote algorithm-internal info! logs to debug #367 (optimized RecordBuf encoding) lands upstream

Test plan

  • cargo build --release passes
  • Pre-commit hooks (ci-fmt, ci-lint) pass
  • Doc-only changes — no behavioral impact

@nh13
nh13 temporarily deployed to github-actions March 23, 2026 18:50 — with GitHub Actions Inactive
@codecov

codecov Bot commented Mar 23, 2026 •

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 85.65%. Comparing base (e9a9040) to head (6ae4650).
⚠️ Report is 3 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff             @@
##             main     #182      +/-   ##
==========================================
- Coverage   85.65%   85.65%   -0.01%     
==========================================
  Files         128      128              
  Lines       51983    52001      +18     
==========================================
+ Hits        44526    44541      +15     
- Misses       7457     7460       +3     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@coderabbitai

coderabbitai Bot commented Mar 23, 2026 •

Copy link
Copy Markdown

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 1ba1eaf3-0347-44c7-a89f-4cc0148b2979

📥 Commits

Reviewing files that changed from the base of the PR and between 45201e8 and 6ae4650.

📒 Files selected for processing (4)
  • crates/fgumi-consensus/src/vendored/bam_codec/mod.rs
  • crates/fgumi-consensus/src/vendored/mod.rs
  • src/lib/vendored/bam_codec/mod.rs
  • src/lib/vendored/mod.rs
✅ Files skipped from review due to trivial changes (4)
  • crates/fgumi-consensus/src/vendored/mod.rs
  • src/lib/vendored/bam_codec/mod.rs
  • crates/fgumi-consensus/src/vendored/bam_codec/mod.rs
  • src/lib/vendored/mod.rs

📝 Walkthrough

Walkthrough

Module-level documentation updated in four files across two crate locations. Changes state the BAM codec is vendored from noodles-bam, note that the upstream encode-expose PR was closed, recommend Reader::from(src) for decoding, and retain encode_record_buf for a raw-byte-mode optimization path with a clear removal criterion tied to an upstream API for optimized RecordBuf encoding. No functional code, API signatures, or control flow were modified.

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately and specifically describes the main change: updating documentation to reflect the closure of noodles#364.
Description check ✅ Passed The description clearly explains the documentation updates: removing noodles#364 from pending PRs, explaining why vendored code is retained, and clarifying removal criteria.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch nh/docs-vendored-codec-phase1

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

PR #364 (expose record codec encode/decode) was closed upstream — the
maintainer recommended Reader::from(src) for decoding instead. Update
vendored module docs to remove #364 from the pending-PR list and explain
why the vendored bam_codec is retained: encode_record_buf is still
needed for the raw-byte-mode optimization path.
@nh13
nh13 force-pushed the nh/docs-vendored-codec-phase1 branch from 45201e8 to 6ae4650 Compare March 23, 2026 20:14
@nh13
nh13 temporarily deployed to github-actions March 23, 2026 20:14 — with GitHub Actions Inactive
@nh13
nh13 merged commit 2d93cc2 into main Mar 23, 2026
7 checks passed
@nh13
nh13 deleted the nh/docs-vendored-codec-phase1 branch March 23, 2026 20:21
@nh13 nh13 mentioned this pull request Mar 23, 2026
nh13 added a commit that referenced this pull request Mar 23, 2026
Replace the vendored bam_codec::decode with noodles' public
Reader::from(src).read_record_buf() API, as recommended by the noodles
maintainer when closing PR #364.

The vendored decoder was only used in the non-raw-byte-mode path of
decode_records(), which is not exercised by any production command (all
use raw_byte_mode=true). Removing it eliminates 20 vendored files
(~1850 lines) that would need to be diffed on every noodles version
bump.

The vendored encoder (encode_record_buf) is retained — it provides
~30% CPU savings in the raw-byte-mode write path and has no upstream
equivalent until noodles#367 lands.

Follows up on #182.
nh13 added a commit that referenced this pull request Mar 23, 2026
Replace the vendored bam_codec::decode with noodles' public
Reader::from(src).read_record_buf() API, as recommended by the noodles
maintainer when closing PR #364.

The vendored decoder was only used in the non-raw-byte-mode path of
decode_records(), which is not exercised by any production command (all
use raw_byte_mode=true). Removing it eliminates 20 vendored files
(~1850 lines) that would need to be diffed on every noodles version
bump.

The vendored encoder (encode_record_buf) is retained — it provides
~30% CPU savings in the raw-byte-mode write path and has no upstream
equivalent until noodles#367 lands.

Follows up on #182.
nh13 added a commit that referenced this pull request Mar 23, 2026
Replace the vendored bam_codec::decode with noodles' public
Reader::from(src).read_record_buf() API, as recommended by the noodles
maintainer when closing PR #364.

The vendored decoder was only used in the non-raw-byte-mode path of
decode_records(), which is not exercised by any production command (all
use raw_byte_mode=true). Removing it eliminates 20 vendored files
(~1850 lines) that would need to be diffed on every noodles version
bump.

The vendored encoder (encode_record_buf) is retained — it provides
~30% CPU savings in the raw-byte-mode write path and has no upstream
equivalent until noodles#367 lands.

Follows up on #182.
nh13 added a commit that referenced this pull request Mar 24, 2026
Replace the vendored bam_codec::decode with noodles' public
Reader::from(src).read_record_buf() API, as recommended by the noodles
maintainer when closing PR #364.

The vendored decoder was only used in the non-raw-byte-mode path of
decode_records(), which is not exercised by any production command (all
use raw_byte_mode=true). Removing it eliminates 20 vendored files
(~1850 lines) that would need to be diffed on every noodles version
bump.

The vendored encoder (encode_record_buf) is retained — it provides
~30% CPU savings in the raw-byte-mode write path and has no upstream
equivalent until noodles#367 lands.

Follows up on #182.
nh13 added a commit that referenced this pull request Mar 24, 2026
…PI (#185)

Replace the vendored bam_codec::decode with noodles' public
Reader::from(src).read_record_buf() API, as recommended by the noodles
maintainer when closing PR #364.

The vendored decoder was only used in the non-raw-byte-mode path of
decode_records(), which is not exercised by any production command (all
use raw_byte_mode=true). Removing it eliminates 20 vendored files
(~1850 lines) that would need to be diffed on every noodles version
bump.

The vendored encoder (encode_record_buf) is retained — it provides
~30% CPU savings in the raw-byte-mode write path and has no upstream
equivalent until noodles#367 lands.

Follows up on #182.

This branch was previously deployed

1 inactive deployment
github-actions — 6ae46504 Deployed Mar 23, 2026 by nh13 via coverage #685
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.

1 participant