{
  "schema": "https://ai-atoms.com/schemas/skill-v1.json",
  "type": "skill",
  "id": "skill/azure-servicebus-py",
  "version": "1.0.1",
  "name": "Azure Servicebus Py",
  "description": "Azure Service Bus SDK for Python messaging. Use for queues, topics, subscriptions, and enterprise messaging patterns.\nTriggers: \"service bus\", \"ServiceBusClient\", \"queue\", \"topic\", \"subscription\", \"message broker\".",
  "system_prompt_fragment": "# Azure Service Bus SDK for Python\n\nEnterprise messaging for reliable cloud communication with queues and pub/sub topics.\n\n## Installation\n\n```bash\npip install azure-servicebus azure-identity\n```\n\n## Environment Variables\n\n```bash\nSERVICEBUS_FULLY_QUALIFIED_NAMESPACE=<namespace>.servicebus.windows.net\nSERVICEBUS_QUEUE_NAME=myqueue\nSERVICEBUS_TOPIC_NAME=mytopic\nSERVICEBUS_SUBSCRIPTION_NAME=mysubscription\n```\n\n## Authentication\n\n```python\nfrom azure.identity import DefaultAzureCredential\nfrom azure.servicebus import ServiceBusClient\n\ncredential = DefaultAzureCredential()\nnamespace = \"<namespace>.servicebus.windows.net\"\n\nclient = ServiceBusClient(\n    fully_qualified_namespace=namespace,\n    credential=credential\n)\n```\n\n## Client Types\n\n| Client | Purpose | Get From |\n|--------|---------|----------|\n| `ServiceBusClient` | Connection management | Direct instantiation |\n| `ServiceBusSender` | Send messages | `client.get_queue_sender()` / `get_topic_sender()` |\n| `ServiceBusReceiver` | Receive messages | `client.get_queue_receiver()` / `get_subscription_receiver()` |\n\n## Send Messages (Async)\n\n```python\nimport asyncio\nfrom azure.servicebus.aio import ServiceBusClient\nfrom azure.servicebus import ServiceBusMessage\nfrom azure.identity.aio import DefaultAzureCredential\n\nasync def send_messages():\n    credential = DefaultAzureCredential()\n    \n    async with ServiceBusClient(\n        fully_qualified_namespace=\"<namespace>.servicebus.windows.net\",\n        credential=credential\n    ) as client:\n        sender = client.get_queue_sender(queue_name=\"myqueue\")\n        \n        async with sender:\n            # Single message\n            message = ServiceBusMessage(\"Hello, Service Bus!\")\n            await sender.send_messages(message)\n            \n            # Batch of messages\n            messages = [ServiceBusMessage(f\"Message {i}\") for i in range(10)]\n            await sender.send_messages(messages)\n            \n            # Message batch (for size control)\n            batch = await sender.create_message_batch()\n            for i in range(100):\n                try:\n                    batch.add_message(ServiceBusMessage(f\"Batch message {i}\"))\n                except ValueError:  # Batch full\n                    await sender.send_messages(batch)\n                    batch = await sender.create_message_batch()\n                    batch.add_message(ServiceBusMessage(f\"Batch message {i}\"))\n            await sender.send_messages(batch)\n\nasyncio.run(send_messages())\n```\n\n## Receive Messages (Async)\n\n```python\nasync def receive_messages():\n    credential = DefaultAzureCredential()\n    \n    async with ServiceBusClient(\n        fully_qualified_namespace=\"<namespace>.servicebus.windows.net\",\n        credential=credential\n    ) as client:\n        receiver = client.get_queue_receiver(queue_name=\"myqueue\")\n        \n        async with receiver:\n            # Receive batch\n            messages = await receiver.receive_messages(\n                max_message_count=10,\n                max_wait_time=5  # seconds\n            )\n            \n            for msg in messages:\n                print(f\"Received: {str(msg)}\")\n                await receiver.complete_message(msg)  # Remove from queue\n\nasyncio.run(receive_messages())\n```\n\n## Receive Modes\n\n| Mode | Behavior | Use Case |\n|------|----------|----------|\n| `PEEK_LOCK` (default) | Message locked, must complete/abandon | Reliable processing |\n| `RECEIVE_AND_DELETE` | Removed immediately on receive | At-most-once delivery |\n\n```python\nfrom azure.servicebus import ServiceBusReceiveMode\n\nreceiver = client.get_queue_receiver(\n    queue_name=\"myqueue\",\n    receive_mode=ServiceBusReceiveMode.RECEIVE_AND_DELETE\n)\n```\n\n## Message Settlement\n\n```python\nasync with receiver:\n    messages = await receiver.receive_messages(max_message_count=1)\n    \n    for msg in messages:\n        try:\n            # Process message...\n            await receiver.complete_message(msg)  # Success - remove from queue\n        except ProcessingError:\n            await receiver.abandon_message(msg)  # Retry later\n        except PermanentError:\n            await receiver.dead_letter_message(\n                msg,\n                reason=\"ProcessingFailed\",\n                error_description=\"Could not process\"\n            )\n```\n\n| Action | Effect |\n|--------|--------|\n| `complete_message()` | Remove from queue (success) |\n| `abandon_message()` | Release lock, retry immediately |\n| `dead_letter_message()` | Move to dead-letter queue |\n| `defer_message()` | Set aside, receive by sequence number |\n\n## Topics and Subscriptions\n\n```python\n# Send to topic\nsender = client.get_topic_sender(topic_name=\"mytopic\")\nasync with sender:\n    await sender.send_messages(ServiceBusMessage(\"Topic message\"))\n\n# Receive from subscription\nreceiver = client.get_subscription_receiver(\n    topic_name=\"mytopic\",\n    subscription_name=\"mysubscription\"\n)\nasync with receiver:\n    messages = await receiver.receive_messages(max_message_count=10)\n```\n\n## Sessions (FIFO)\n\n```python\n# Send with session\nmessage = ServiceBusMessage(\"Session message\")\nmessage.session_id = \"order-123\"\nawait sender.send_messages(message)\n\n# Receive from specific session\nreceiver = client.get_queue_receiver(\n    queue_name=\"session-queue\",\n    session_id=\"order-123\"\n)\n\n# Receive from next available session\nfrom azure.servicebus import NEXT_AVAILABLE_SESSION\nreceiver = client.get_queue_receiver(\n    queue_name=\"session-queue\",\n    session_id=NEXT_AVAILABLE_SESSION\n)\n```\n\n## Scheduled Messages\n\n```python\nfrom datetime import datetime, timedelta, timezone\n\nmessage = ServiceBusMessage(\"Scheduled message\")\nscheduled_time = datetime.now(timezone.utc) + timedelta(minutes=10)\n\n# Schedule message\nsequence_number = await sender.schedule_messages(message, scheduled_time)\n\n# Cancel scheduled message\nawait sender.cancel_scheduled_messages(sequence_number)\n```\n\n## Dead-Letter Queue\n\n```python\nfrom azure.servicebus import ServiceBusSubQueue\n\n# Receive from dead-letter queue\ndlq_receiver = client.get_queue_receiver(\n    queue_name=\"myqueue\",\n    sub_queue=ServiceBusSubQueue.DEAD_LETTER\n)\n\nasync with dlq_receiver:\n    messages = await dlq_receiver.receive_messages(max_message_count=10)\n    for msg in messages:\n        print(f\"Dead-lettered: {msg.dead_letter_reason}\")\n        await dlq_receiver.complete_message(msg)\n```\n\n## Sync Client (for simple scripts)\n\n```python\nfrom azure.servicebus import ServiceBusClient, ServiceBusMessage\nfrom azure.identity import DefaultAzureCredential\n\nwith ServiceBusClient(\n    fully_qualified_namespace=\"<namespace>.servicebus.windows.net\",\n    credential=DefaultAzureCredential()\n) as client:\n    with client.get_queue_sender(\"myqueue\") as sender:\n        sender.send_messages(ServiceBusMessage(\"Sync message\"))\n    \n    with client.get_queue_receiver(\"myqueue\") as receiver:\n        for msg in receiver:\n            print(str(msg))\n            receiver.complete_message(msg)\n```\n\n## Best Practices\n\n1. **Use async client** for production workloads\n2. **Use context managers** (`async with`) for proper cleanup\n3. **Complete messages** after successful processing\n4. **Use dead-letter queue** for poison messages\n5. **Use sessions** for ordered, FIFO processing\n6. **Use message batches** for high-throughput scenarios\n7. **Set `max_wait_time`** to avoid infinite blocking\n\n## Reference Files\n\n| File | Contents |\n|------|----------|\n| references/patterns.md | Competing consumers, sessions, retry patterns, request-response, transactions |\n| references/dead-letter.md | DLQ handling, poison messages, reprocessing strategies |\n| scripts/setup_servicebus.py | CLI for queue/topic/subscription management and DLQ monitoring |\n\n## When to Use\nThis skill is applicable to execute the workflow or actions described in the overview.",
  "applicable_domains": [
    "devops"
  ],
  "category": "devops",
  "invocation": [
    "/azure-servicebus-py"
  ],
  "authored_by": "claudeskills.in community",
  "source_url": "https://claudeskills.in/skill/azure-servicebus-py",
  "provenance": {
    "source": "claudeskills.in",
    "source_url": "https://claudeskills.in/skill/azure-servicebus-py",
    "license": "unknown",
    "imported_at": "2026-09-03",
    "notes": "Aggregated by claudeskills.in from community GitHub lists."
  },
  "tags": [
    "claudeskills",
    "devops"
  ],
  "lifecycle": "draft"
}