blob-az 0.1.2

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

Azure Blob

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 azb

azb.client() # just works!

API

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

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