⚡ Bolt: Optimize yEnc decoding

[xbmc4lyfe]

💡 What: Replaced the manual byte-by-byte yEnc decoding loop in _decode_yenc_lines with C-backed byte operations using bytes.find() and bytearray.translate().

🎯 Why: Python's bytecode evaluation for single-byte iteration is extremely slow. yEnc decoding is heavy on byte processing and was a noticeable bottleneck.

📊 Impact: Expected performance improvement is massive for the decoding phase. Benchmarking 1MB of yEnc dummy data showed speed improvements from ~0.18s to ~0.02s (an ~8.4x speedup).

🔬 Measurement: Verify by running deep checks on large NZB bodies or by benchmarking the _decode_yenc_lines standalone. All existing unittests pass identically.

---

PR created automatically by Jules for task 10776233080090682422 started by @xbmc4lyfe

[google-labs-jules]

👋 Jules, reporting for duty! I'm here to lend a hand with this pull request.

When you start a review, I'll add a 👀 emoji to each comment to let you know I've read it. I'll focus on feedback directed at me and will do my best to stay out of conversations between you and other bots or reviewers to keep the noise down.

I'll push a commit with your requested changes shortly after. Please note there might be a delay between these steps, but rest assured I'm on the job!

For more direct control, you can switch me to Reactive Mode. When this mode is on, I will only act on comments where you specifically mention me with @jules. You can find this option in the Pull Request section of your global Jules UI settings. You can always switch back!

New to Jules? Learn more at jules.google/docs.

---

For security, I will only act on instructions from the user who triggered this task.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: ce47a586-b53e-47b1-aba1-203b02d7fb92

📥 Commits

Reviewing files that changed from the base of the PR and between 0de7ede and 6c6cc41.

📒 Files selected for processing (2)

• .jules/bolt.md
• verify_nzb.py

📜 Recent review details

🔇 Additional comments (2)

verify_nzb.py (1)

118-139: LGTM!

.jules/bolt.md (1)

1-3: LGTM!

---

📝 Walkthrough

Summary by CodeRabbit

• Documentation

  • Added performance optimization guidance documentation.

• Refactor

  • Optimized yEnc decoding implementation for faster processing using more efficient byte operations.

Walkthrough

_YENC_DECODE_TRANSLATION, a precomputed 256-byte lookup table, is introduced in verify_nzb.py. _decode_yenc_lines is rewritten to locate yEnc escape sequences via bytes.find, accumulate segments into a bytearray, and apply a final bytes.translate call, replacing the previous per-byte loop. A matching note is added to .jules/bolt.md.

Changes

yEnc Bulk-Decode Optimization

Layer / File(s)	Summary
Precomputed translation table and rewritten _decode_yenc_lines verify_nzb.py, .jules/bolt.md	Introduces _YENC_DECODE_TRANSLATION (256-entry table) and replaces the per-byte decode loop with bytes.find-driven segment accumulation into a bytearray followed by a bytes.translate call. The bolt.md note records the C-backed bulk-operation approach and correctness guidance for shift transformations.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐇 Byte by byte is oh so slow,
A table of 256 will steal the show!
I find the escape, I slice, I glide,
With translate() hopping on the inside.
No more loops — just C-speed pride! 🥕

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 33.33% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title directly describes the main change: optimizing yEnc decoding in the bolt module, which aligns with the changeset's focus on replacing manual byte-by-byte iteration with C-backed operations.
Description check	✅ Passed	The description clearly explains what was changed (replaced manual yEnc decoding loop with C-backed byte operations), why (performance bottleneck), and impact (8.4x speedup), all directly related to the changeset.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ 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 bolt-yenc-opt-10776233080090682422

✨ Simplify code

• Create PR with simplified code
• Commit simplified code in branch bolt-yenc-opt-10776233080090682422

Warning

Billing warning: we have not been able to collect payment for this subscription for more than 72 hours. Please update the payment method or pay any pending invoices in Billing to avoid service interruption.

---

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