{"library":"pymacaroons","title":"PyMacaroons","description":"PyMacaroons is a Python implementation of Macaroons, a form of bearer credential similar to cookies but with embedded caveats defining authorization requirements. It is currently at version 0.13.0 and is described as stable with infrequent changes.","language":"python","status":"active","last_verified":"Sat May 16","install":{"commands":["pip install pymacaroons"],"cli":null},"imports":["from pymacaroons import Macaroon","from pymacaroons import Verifier"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"from pymacaroons import Macaroon, Verifier\n\n# Keys for signing macaroons are associated with some identifier for later\n# verification. This could be stored in a database, key-value store, memory, etc.\nkeys = {\n    'key-for-bob': 'asdfasdfas-a-very-secret-signing-key'\n}\n\n# Construct a Macaroon. The location and identifier will be visible after\n# construction, and identify which service and key to use to verify it.\nm = Macaroon(\n    location='cool-picture-service.example.com',\n    identifier='key-for-bob',\n    key=keys['key-for-bob']\n)\n\n# Add a caveat for the target service\nm.add_first_party_caveat('picture_id = bobs_cool_cat.jpg')\n\n# Serialize for transport in a cookie, url, OAuth token, etc\nserialized_macaroon = m.serialize()\nprint(f\"Serialized Macaroon: {serialized_macaroon}\")\n\n# --- Verification Process ---\n\n# A Verifier needs a callback to lookup keys and discharge caveats.\ndef get_key_for_identifier(identifier):\n    return keys.get(identifier)\n\ndef verify_caveat(caveat):\n    if caveat == 'picture_id = bobs_cool_cat.jpg':\n        # In a real application, you'd check against your actual data/context\n        return True\n    return False\n\n\n# Deserialize the macaroon on the receiving service\nd = Macaroon.deserialize(serialized_macaroon)\n\n# Create a Verifier instance and register the key lookup and caveat verification callbacks\nv = Verifier()\nv.satisfy_exact('picture_id = bobs_cool_cat.jpg') # Satisfy first-party caveats directly\nv.satisfy_third_party(lambda c: True) # Example: satisfy third-party caveats (not used in this example)\n\ntry:\n    # Verify the macaroon\n    verified = v.verify(d, get_key_for_identifier)\n    print(f\"Macaroon verified: {verified}\")\nexcept Exception as e:\n    print(f\"Macaroon verification failed: {e}\")","lang":"python","description":"This quickstart demonstrates how to create a Macaroon with a first-party caveat, serialize it, and then verify it using a Verifier with appropriate callbacks for key retrieval and caveat satisfaction.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-16","installed_version":"0.13.0","pypi_latest":"0.13.0","is_stale":false,"summary":{"python_range":"3.10–3.9","success_rate":100,"avg_install_s":2,"avg_import_s":0.06,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"pymacaroons","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.05,"mem_mb":1.8,"disk_size":"23.6M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"pymacaroons","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.9,"import_time_s":0.04,"mem_mb":1.8,"disk_size":"24M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"pymacaroons","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.08,"mem_mb":2.1,"disk_size":"25.9M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"pymacaroons","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":2,"import_time_s":0.07,"mem_mb":2.1,"disk_size":"26M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"pymacaroons","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.06,"mem_mb":1.7,"disk_size":"17.7M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"pymacaroons","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.8,"import_time_s":0.06,"mem_mb":1.7,"disk_size":"18M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"pymacaroons","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.05,"mem_mb":1.9,"disk_size":"17.4M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"pymacaroons","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.8,"import_time_s":0.06,"mem_mb":1.7,"disk_size":"18M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"pymacaroons","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.05,"mem_mb":1.9,"disk_size":"23.9M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"pymacaroons","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":2.3,"import_time_s":0.05,"mem_mb":1.9,"disk_size":"24M"}]}}