#94 — Minimal example: hello-mailbox

[ggmaldo]

Description

Created the MailBox example at examples/hello-mailbox

Related Issue

• Add minimal example: hello-mailbox #94 — Minimal example: hello-mailbox

How to test

cargo run -p hello-mailbox

Expected output

=== hello-mailbox: Mailbox buffer demo ===

   Round 1
1. Firing three rapid commands BEFORE consumer exists: Red → Green → Blue
2. Consumer created AFTER the burst — reads once:
   ✓ Got: Blue  ← only the latest survived
   (Red and Green were overwritten before anyone could read them)

   Round 2
1. Firing two rapid commands BEFORE consumer exists: Red → Green
2. Consumer created AFTER the burst — reads once:
   ✓ Got: Green  ← only the latest survived (Green)
3. Shutting down...
   ✓ Done.

[lxsaah]

Great first contribution! Works correctly, all checks pass on the example itself. Verified locally that make check and make all are both green once the Makefile is wired up for the new crate.

Left inline suggestions you can apply with one click each. They cover:

1. Example polish — broken README link, unused deps, minor wording.
2. Cargo.toml — workspace member formatting + description convention.

One thing I couldn't add as inline suggestions: the Makefile isn't part of your PR diff, so GitHub blocks suggestion comments on it. Could you add hello-mailbox to the Makefile manually? Three spots:

• The make fmt for-loop on line ~122: append hello-mailbox to the package list, right before ; do \
• The make fmt-check for-loop on line ~131: same
• The examples target around line 277: add a new build step right before the success printf:

	@printf "$(YELLOW)  → Building hello-mailbox (minimal Mailbox buffer demo)$(NC)\n"
	cargo build --package hello-mailbox

Once those Makefile changes plus the inline suggestions are in, we're good to merge.

We're planning to file a follow-up issue for an async sibling (hello-mailbox-async) as a separate crate, so your sync version stays exactly as it is. If you'd like to take the async version next, let me know and I'll assign it to you.

[ggmaldo]

Hi, Done! Applied all the inline suggestions and updated the Makefile

[ggmaldo]

I'd love to take the async version, but I want to make sure I understand async Rust better first. I'll follow up once I feel ready.

[lxsaah]

I'd love to take the async version, but I want to make sure I understand async Rust better first. I'll follow up once I feel ready.

Sure, take your time. I'll file the issue and keep it in the backlog. Just take it as soon as you feel ready.

[lxsaah]

thanks @ggmaldo, this is the first community contribution to AimDB 🎉

[ggmaldo]

No problem, Thanks you, I'll try to help this proyect the best as i can