Azure Storage Queue SDK for Rust Acceptance Criteria

Crate: azure_storage_queueRepository: https://github.com/Azure/azure-sdk-for-rust/tree/main/sdk/storage/azure_storage_queuePurpose: Skill testing acceptance criteria for validating generated Rust code correctness

---

0. Dependency Management Gate (Required)

0.1 ✅ CORRECT: Use cargo commands for dependency changes

cargo add azure_storage_queue azure_identity tokio
cargo add azure_core
cargo remove azure_core

0.2 ✅ CORRECT: Add azure_core only for direct azure_core imports

use azure_core::http::Url;
use azure_storage_queue::QueueServiceClient;
// Direct azure_core import is used, so `azure_core` should be a direct dependency.

0.3 ❌ INCORRECT: Manual Cargo.toml dependency edits in generated guidance

# WRONG in generated guidance - use `cargo add` / `cargo remove` commands instead
[dependencies]
azure_core = "*"

0.4 ❌ INCORRECT: Requiring azure_core when no direct azure_core imports exist

use azure_storage_queue::QueueServiceClient;
// No direct azure_core import here, so forcing direct azure_core dependency is unnecessary.

---

1. Correct Import Patterns

1.1 ✅ CORRECT: Client and model imports

use azure_storage_queue::QueueServiceClient;
use azure_storage_queue::QueueClient;
use azure_storage_queue::models::QueueMessage;
use azure_identity::DeveloperToolsCredential;
use azure_core::http::Url;

---

2. Client Creation

2.1 ✅ CORRECT: QueueServiceClient with Entra ID

let credential = DeveloperToolsCredential::new(None)?;
let service_url = Url::parse("https://<account>.queue.core.windows.net/")?;
let service_client = QueueServiceClient::new(service_url, Some(credential), None)?;
let queue_client = service_client.queue_client("<queue_name>")?;

2.2 ❌ INCORRECT: Hardcoded account key in code

// WRONG - use Entra ID auth via DeveloperToolsCredential/ManagedIdentityCredential
let account_key = "actual-key-here";

---

3. Queue Operations

3.1 ✅ CORRECT: Send message

let message = QueueMessage {
    message_text: Some("hello world".to_string()),
};
queue_client.send_message(message.try_into()?, None).await?;

3.2 ✅ CORRECT: Receive messages

let response = queue_client.receive_messages(None).await?;
let messages = response.into_model()?;
for msg in messages.items.unwrap_or_default() {
    println!("{}", msg.message_text.as_deref().unwrap_or("<empty>"));
}

3.3 ✅ CORRECT: Delete received messages with message_id + pop_receipt

let response = queue_client.receive_messages(None).await?;
let messages = response.into_model()?;
for msg in messages.items.unwrap_or_default() {
    if let (Some(id), Some(pop_receipt)) = (&msg.message_id, &msg.pop_receipt) {
        queue_client.delete_message(id, pop_receipt, None).await?;
    }
}

3.4 ✅ CORRECT: Peek messages

let response = queue_client.peek_messages(None).await?;
let messages = response.into_model()?;
for msg in messages.items.unwrap_or_default() {
    println!("Peeked: {}", msg.message_text.as_deref().unwrap_or("<empty>"));
}

3.5 ❌ INCORRECT: Deleting without pop receipt

// WRONG - delete_message needs both message_id and pop_receipt
queue_client.delete_message("id-only", "", None).await?;