{"library":"python-gnupg","title":"Python-GnuPG","description":"Python-GnuPG is a Python wrapper for the GNU Privacy Guard (GnuPG) command-line tool, enabling Python programs to perform cryptographic operations like encryption, decryption, digital signing, and key management. It provides a high-level, Pythonic interface to GnuPG's functionality. The library is actively maintained, with version 2.3.1 being the latest as of April 2026, and typically follows GnuPG's release cycle for compatibility updates.","language":"python","status":"active","last_verified":"Wed May 20","install":{"commands":["pip install python-gnupg"],"cli":null},"imports":["import gnupg\ngpg = gnupg.GPG()"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import gnupg\nimport os\n\n# Ensure the GnuPG home directory exists and has correct permissions\ngnupghome = os.path.expanduser('~/.gnupg_test')\nif not os.path.exists(gnupghome):\n    os.makedirs(gnupghome, mode=0o700)\n\ngpg = gnupg.GPG(gnupghome=gnupghome)\n# Ensure the GnuPG binary path is correct if not in system PATH\n# gpg = gnupg.GPG(gnupghome=gnupghome, gpgbinary='/usr/local/bin/gpg')\n\n# Generate a key pair (example, use stronger keys and secure passphrases in production)\npassphrase = os.environ.get('GPG_PASSPHRASE', 'mysecurepassphrase')\ninput_data = gpg.gen_key_input(\n    key_type=\"RSA\",\n    key_length=2048,\n    name_real=\"Test User\",\n    name_email=\"test@example.com\",\n    passphrase=passphrase\n)\nkey = gpg.gen_key(input_data)\n\nif key:\n    print(f\"Generated Key ID: {key.fingerprint}\")\n\n    # Encrypt a message\n    message = \"Hello, GnuPG! This is a secret message.\"\n    encrypted_data = gpg.encrypt(message, recipients=[key.fingerprint], passphrase=passphrase)\n\n    if encrypted_data.ok:\n        print(\"\\nEncrypted Message:\")\n        print(str(encrypted_data))\n\n        # Decrypt the message\n        decrypted_data = gpg.decrypt(str(encrypted_data), passphrase=passphrase)\n\n        if decrypted_data.ok:\n            print(\"\\nDecrypted Message:\")\n            print(str(decrypted_data))\n            assert str(decrypted_data) == message\n        else:\n            print(f\"\\nDecryption Failed: {decrypted_data.status}\")\n            print(f\"Stderr: {decrypted_data.stderr}\")\n    else:\n        print(f\"\\nEncryption Failed: {encrypted_data.status}\")\n        print(f\"Stderr: {encrypted_data.stderr}\")\nelse:\n    print(f\"Key generation failed: {gpg.gen_key(input_data).stderr}\")","lang":"python","description":"This quickstart demonstrates how to initialize the GPG object, generate a new key pair, encrypt a string using the generated public key, and then decrypt it using the corresponding private key and passphrase. It emphasizes the importance of setting a `gnupghome` directory for GnuPG operations.","tag":null,"tag_description":null,"last_tested":"2026-04-24","results":[{"runtime":"python:3.10-alpine","exit_code":1},{"runtime":"python:3.10-slim","exit_code":1},{"runtime":"python:3.11-alpine","exit_code":1},{"runtime":"python:3.11-slim","exit_code":1},{"runtime":"python:3.12-alpine","exit_code":1},{"runtime":"python:3.12-slim","exit_code":1},{"runtime":"python:3.13-alpine","exit_code":1},{"runtime":"python:3.13-slim","exit_code":1},{"runtime":"python:3.9-alpine","exit_code":1},{"runtime":"python:3.9-slim","exit_code":1}]},"compatibility":{"tag":"verified","tag_description":"installs cleanly on critical runtimes, fast import, recently tested","last_tested":"2026-05-20","installed_version":"0.5.6","pypi_latest":"0.5.6","is_stale":false,"summary":{"python_range":"3.10–3.9","success_rate":100,"avg_install_s":1.5,"avg_import_s":0.06,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"python-gnupg","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.05,"mem_mb":2.6,"disk_size":"17.9M"},{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"python-gnupg","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.06,"mem_mb":2.6,"disk_size":"17.9M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"python-gnupg","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.5,"import_time_s":0.03,"mem_mb":2.6,"disk_size":"18M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"python-gnupg","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.04,"mem_mb":2.6,"disk_size":"18M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"python-gnupg","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.09,"mem_mb":2.9,"disk_size":"19.8M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"python-gnupg","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.12,"mem_mb":2.9,"disk_size":"19.8M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"python-gnupg","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.6,"import_time_s":0.07,"mem_mb":2.9,"disk_size":"20M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"python-gnupg","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.08,"mem_mb":2.9,"disk_size":"20M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"python-gnupg","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.07,"mem_mb":2.9,"disk_size":"11.7M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"python-gnupg","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.07,"mem_mb":2.9,"disk_size":"11.7M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"python-gnupg","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.4,"import_time_s":0.07,"mem_mb":2.9,"disk_size":"12M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"python-gnupg","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.07,"mem_mb":2.9,"disk_size":"12M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"python-gnupg","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.06,"mem_mb":2.5,"disk_size":"11.4M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"python-gnupg","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.06,"mem_mb":2.5,"disk_size":"11.3M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"python-gnupg","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.4,"import_time_s":0.06,"mem_mb":2.3,"disk_size":"12M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"python-gnupg","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.06,"mem_mb":2.3,"disk_size":"12M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"python-gnupg","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.04,"mem_mb":2.5,"disk_size":"17.4M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"python-gnupg","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.06,"mem_mb":2.5,"disk_size":"17.4M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"python-gnupg","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.7,"import_time_s":0.04,"mem_mb":2.5,"disk_size":"18M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"python-gnupg","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.06,"mem_mb":2.5,"disk_size":"18M"}]}}