aes-bridge 2.0.0

AesBridge is a modern, secure and cross-language AES encryption library

AesBridge Python

AesBridge is a modern, secure and cross-language AES encryption library that supports GCM and CBC modes

This is the Python implementation of the core project.
👉 Main repository: https://github.com/mervick/aes-bridge

Features

• 🔒 AES-256 encryption in GCM and CBC modes
• 🌐 Unified cross-language design
• 📦 Compact binary format or base64 output
• 🐍 Pure Python with zero dependencies (except cryptography)

Quick Start

Installation

pip install aes-bridge

Usage

from aes_bridge import encrypt, decrypt

ciphertext = encrypt("My secret message", "MyStrongPass")
plaintext = decrypt(ciphertext, "MyStrongPass")

API Reference

Main Functions (GCM by default)

• encrypt(data, passphrase)
  Encrypts a string using AES-GCM (default).
  Returns: base64-encoded string.

• decrypt(ciphertext, passphrase)
  Decrypts a base64-encoded string encrypted with AES-GCM.

CBC Mode

• encrypt_cbc(data, passphrase)
  Encrypts a string using AES-CBC. HMAC is used for integrity verification.
  Returns: base64-encoded string.

• decrypt_cbc(ciphertext, passphrase)
  Decrypts a base64-encoded string encrypted with encrypt_cbc and verifies HMAC.

• encrypt_cbc_bin(data, passphrase)
  Returns encrypted binary data using AES-CBC with HMAC.

• decrypt_cbc_bin(ciphertext, passphrase)
  Decrypts binary data encrypted with encrypt_cbc_bin and verifies HMAC.

GCM Mode

• encrypt_gcm(data, passphrase)
  Encrypts a string using AES-GCM. Returns: base64-encoded string.

• decrypt_gcm(ciphertext, passphrase)
  Decrypts a base64-encoded string encrypted with encrypt_gcm.

• encrypt_gcm_bin(data, passphrase)
  Returns encrypted binary data using AES-GCM.

• decrypt_gcm_bin(ciphertext, passphrase)
  Decrypts binary data encrypted with encrypt_gcm_bin.

Legacy Compatibility

⚠️ These functions are kept for backward compatibility only. Their usage is strongly discouraged in new applications.

• encrypt_legacy(data, passphrase)
  Encrypts a string in the legacy AES Everywhere format.

• decrypt_legacy(ciphertext, passphrase)
  Decrypts a string encrypted in the legacy AES Everywhere format.