Add optional progress reporting via ProgressQueue

[zfsguy]

Exposes sparrow's existing SolutionListener mechanism to Python via a new ProgressQueue class and ReportType enum.

When passed to solve(), the queue collects (ReportType, strip_width, density) tuples that can be drained from another thread for progress bars, logging, or monitoring. ReportType mirrors sparrow's 5 report variants (ExplFeas, ExplInfeas, ExplImproving, CmprFeas, Final), with a phase_name() convenience method for grouped labels.

solve() works exactly as before when no queue is passed.

queue = spyrrow.ProgressQueue()
result = [None]

def run():
    result[0] = instance.solve(config, progress=queue)

thread = threading.Thread(target=run)
thread.start()
while thread.is_alive():
    for report_type, strip_width, density in queue.drain():
        print(f"{report_type.phase_name()}: width={strip_width:.1f}, density={density:.1%}")
    thread.join(timeout=0.5)

solution = result[0]

[PaulDL-RS]

I can't look at your Pull Request today, i will looked into it tommorow.
Due to some unrelated issue, I need to release a fix as 0.8.4 today. I guess your PR will be 0.8.5

[zfsguy]

No worries. I'm in no hurry.

…

On Wed, Mar 11, 2026 at 1:44 AM, PaulDL-RS < ***@***.*** > wrote: *PaulDL-RS* left a comment (PaulDL-RS/spyrrow#14) ( #14 (comment) ) I can't look at your Pull Request today, i will looked into it tommorow. Due to some unrelated issue, I need to release a fix as 0.8.4 today. I guess your PR will be 0.8.5 — Reply to this email directly, view it on GitHub ( #14 (comment) ) , or unsubscribe ( https://github.com/notifications/unsubscribe-auth/ADX6N3EZFA7VB7BMQ6CX7534QERO7AVCNFSM6AAAAACWNT2Z4SVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHM2DAMZXGQ4DQMBTHE ). You are receiving this because you authored the thread. Message ID: <PaulDL-RS/spyrrow/pull/14/c4037488039 @ github. com>

[JeroenGar]

Hi @zfsguy,

I like the idea and think this is a value contribution.
Is there a specific reason you do not also include a full solution into your progress messages?

When I look at the custom ProgressListener you wrote, it seems you almost have everything in place to support this.
You already export a solution out of jagua-rs, so passing it along should not be to hard?

[PaulDL-RS]

I reviewed was is now implemented. It's good. I will wait until you decide about Jeroen suggestion by either implementing it or postponing it and then I will merge.

[zfsguy]

@JeroenGar - Good suggestion. drain() now returns (ReportType, StripPackingSolution) tuples with the full solution including placed items.