Azure / Azure/azure-sdk-for-rust
Migration guide: `azure_storage_queue` (from azure_storage_queues)
- Dominant language
- Rust
- Stars
- 884
- Forks
- 365
- Avg merge
- 2d 19h
- Merged PRs (30d)
- 109
Description
Part of #4228
## Migration guide: `azure_storage_queue`
### Official Crate
- **Name:** [`azure_storage_queue`](https://crates.io/crates/azure_storage_queue)
- **Current version:** 0.5.0
- **Service:** Azure Queue Storage
### Unofficial Predecessor(s)
| Predecessor | Version(s) | Relationship | crates.io |
|---|---|---|---|
| `azure_storage_queues` v0.21.0 | Era 2 (2022–2024, 362K downloads) | **Different crate** — plural → singular rename (`queues` → `queue`) | [crates.io](https://crates.io/crates/azure_storage_queues) |
| `azure_sdk_storage_queue` v0.1.0 | Era 1 (MindFlavor, 2017–2019, 2K downloads) | **Different crate** — community-era queue client | [crates.io](https://crates.io/crates/azure_sdk_storage_queue) |
> **Note:** `azure_storage_queue` is not part of the April 2026 GA wave.
### Migration Guide Should Cover
- Crate rename: `azure_storage_queues` → `azure_storage_queue` (drop the plural)
- New client builder pattern
- Message encoding/decoding changes
- Queue CRUD operations
- Base crate change: `azure_storage` → `azure_storage_common`
- Migration path for `azure_sdk_storage_queue` users (start from scratch)
- Cargo.toml dependency changes
### Acceptance Criteria
- [ ] Migration guide published in repo docs (e.g., `docs/migration/azure_storage_queue.md`)
- [ ] Code samples for key scenarios: creating a queue client, send/receive/delete messages, queue management
- [ ] FAQ section covering common migration pitfalls (especially the plural → singular rename)
- [ ] Linked from the `azure_storage_queue` crate README
- [ ] Reviewed by SDK team
Contributor guide
Research direction
Start by reading the azure_storage_queue crate README and the migration requirements in this issue, then inspect the documented predecessor crates azure_storage_queues and azure_sdk_storage_queue. Create docs/migration/azure_storage_queue.md with the requested migration details, samples, and FAQ, link it from the crate README, and ensure the acceptance checklist is covered for SDK team review.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- rust
- Domain
- cloud, documentation
- Issue type
- Documentation
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 52/100