[andy-stark-redis]

Seventh slice of DOC-7226: three small bugs found while verifying the earlier PRs. None of them is a deprecation; each is a snippet or demo that doesn't run.

Ruby job-queue and streaming demos on Ruby 4.0

• Both parsed form bodies with CGI.parse, which Ruby 4.0 removed, so every form POST returned 500. They now use URI.decode_www_form, as the feature-store and recommendation-engine Ruby demos already do, returning a hash of arrays that reads a missing key as an empty array (what CGI.parse did). require 'cgi' becomes require 'uri'; CGI was used nowhere else in those files.
• The streaming demo had a second bug that the first one hid. send_json(res, payload, status: 200) takes keyword arguments, and its seven success responses passed the payload as a braceless hash (send_json(res, 'produced' => n, ...)). Ruby 4.0 reads that as keywords and fails with wrong number of arguments (given 1, expected 2). The error responses were already in braces; the success ones now are too. (Ruby 2.6 accepts the old form; I couldn't test Ruby 3.x.)
• Checked the other Ruby demos (cache-aside, leaderboard, session-store, recommendation-engine, feature-store) for the same braceless pattern: none.

check_index_readiness on the index management page

• It imported re instead of redis, and its return statement stopped at expected_d.
• Fixing those still left it broken on current redis-py, where execute_command('FT.INFO') returns a dict (so info.index(...) raises). It now reads r.ft(index_name).info()['num_docs'].

Verification

• Ruby 4.0.6, no shim: the job-queue demo completed 8 of 8 jobs. Every streaming endpoint (/produce, /add-worker, /remove-worker, /state, /replay, /crash, /autoclaim, /trim, /reset) returned 200, including an empty-body POST.
• The Python snippet was extracted from the published page text and run against a real index (5 documents) on redis-py 8.1.0 and 5.2.1: "still populating" at a 100,000 threshold and "fully populated" at 3, on both.
• This PR touches job-queue/ruby/demo_server.rb, which the open DOC-7226 Move the job-queue Jedis, PHP, redis-py and Ruby ports to BLMOVE #4384 also edits (different lines); git merge-tree shows no conflict.

🤖 Generated with Claude Code

---

Note

Low Risk
Documentation and local demo-server fixes only; no production services or security-sensitive paths.

Overview
Restores runnable docs and demos that broke on current Ruby and redis-py, without changing product behavior.

Index management best practices — The check_index_readiness Python example now imports redis, completes the expected_docs comparison, and reads document count via r.ft(index_name).info()['num_docs'] instead of raw FT.INFO list parsing.

Ruby job-queue and streaming demo servers (Ruby 4.0) — Form POST bodies no longer use removed stdlib CGI.parse; both demos parse application/x-www-form-urlencoded with URI.decode_www_form and a hash-of-arrays helper (missing keys → empty arrays). The streaming demo also wraps success send_json payloads in explicit { ... } hashes so Ruby 4 does not treat hash rockets as keyword arguments to send_json(..., status: 200).

^{Reviewed by Cursor Bugbot for commit 1780145. Bugbot is set up for automated code reviews on this repo. Configure here.}

[github-actions]

DOC-7226

[github-actions]

🧠 Redis Memory

Found 7 related items from repository history (2 new this commit):

• Commit — DOC-7226 Fix the Ruby job-queue and streaming demos on Ruby 4.0 and the index-readiness snippet

  DOC-7226 Fix the Ruby job-queue and streaming demos on Ruby 4.0 and the index-readiness snippet

• PR — DOC-7226 Move the Rust use cases to redis-rs 1.8

  Fourth slice of DOC-7226 (deprecated client API calls in example code): move the Rust use cases to redis-rs 1.x.

• PR — DOC-7015 Stop HSCAN/HVALS examples depending on hash field order

  DOC-7015

• PR — DOC-6909 Fix pre-existing broken links across the docs

  Part 1 of 4 of a stack that splits DOC-6909 Add link render hook to replace relref (investigation) #3732 into independently reviewable pieces, after @paoloredis noted the single PR was too much to review

• Commit — DOC-7226 Move the Rust use cases to redis-rs 1.8

  DOC-7226 Move the Rust use cases to redis-rs 1.8

• Commit — DOC-7226 Fix the Ruby job-queue and streaming demos on Ruby 4.0 and the index-readiness snippet 🆕

  DOC-7226 Fix the Ruby job-queue and streaming demos on Ruby 4.0 and the index-readiness snippet

• PR — DOC-7226 Replace deprecated node-redis quit()/disconnect() and fix harness-exposed examples 🆕

  First slice of DOC-7226 (deprecated client API calls in example code): the node-redis items.

Memory updated at 1780145

[github-actions]

Staging links:
https://redis.io/docs/staging/DOC-7226-ruby-python-bugs/develop/ai/search-and-query/best-practices/index-mgmt-best-practices/

[dwdougherty]

LGTM.