blob-az 0.1.9

Async Python SDK for Azure Blob Storage (Block and Append blocks supported)

Azure Blob

Installation

pip install blob-az

Authorization

Both required fields can be obtained from the Azure Portal, within the Storage account, "Access keys" tab:

• BLOB_CONN_STR (Connection string in the portal)
• BLOB_KEY (KEY in the portal): <random base64 string>

Environment (.env)

For convenience, you can set os.environ["BLOB_CONN_STR"] and os.environ["BLOB_KEY"]. If you do, you can skip specifying them on every call.

E.g., create a .env file:

BLOB_CONN_STR="<BLOB_CONN_STR>"
BLOB_KEY="<BLOB_KEY>"

Then load it before importing

from dotenv import load_dotenv
load_dotenv()
import blob_az as bz

bz.client() # just works!

API

• Asynchronous (everything is a coroutine)
• Single calls or multiple using a same client:

  # single call
  await bz.list.containers(conn_str=CONN_STR) # ain't necessary with a .env file
  
  # multiple calls
  async with bz.client() as client: # idem.
      await bz.container.create("<container-name>", client=client)
      cs = await bz.list.containers(client=client)
  

Functions

az_blob
    def client(...) -> BlobServiceClient
    list
        async def containers(...) -> list[dict]
        async def blobs(...) -> list[dict]
    container
        async def create(...)
        async def delete(...)
    blob
        async def upload(...)
        async def download(...) -> bytes
        def url(...) -> str # generate SAS url for blob