pyaescbc

Description

AES-CBC encryption tools based on crytography package !

The package pyaescbc provides functions to encrypt and decrypt data using the AES-CBC encryption mode. The package is written in Python and uses the cryptography library for the AES encryption and decryption. The package also provides functions to generate a derived key from a password and a pin, and to create an HMAC value from the derived key, IV, and ciphertext. The package is designed to be easy to use and secure, and it is suitable for encrypting sensitive data.

General usage of the package includes:

import pyaescbc

# Encryption
cleardata = bytearray("Hello, World!", 'utf-8')
pin = bytearray("1234", 'utf-8')
password = bytearray("password", 'utf-8')
iterations = pyaescbc.generate_pin_iterations(pin, delete_keys=True)
authdata = bytearray("user=toto", 'utf-8') # Optional authentication data (can be None)
encrypted_bundle = pyaescbc.encrypt(
    cleardata, 
    password, 
    iterations, 
    authdata=authdata, 
    delete_keys=True, 
    delete_data=True
)

# Decryption
pin = bytearray("1234", 'utf-8')
password = bytearray("password", 'utf-8')
iterations = pyaescbc.generate_pin_iterations(pin, delete_keys=True)
authdata = bytearray("user=toto", 'utf-8') # Optional authentication data (can be None)
decrypted_data = pyaescbc.decrypt(
    encrypted_bundle, 
    password, 
    iterations, 
    authdata=authdata, 
    delete_keys=True
)

print(decrypted_data)

Authors

• Artezaru artezaru.github@proton.me

• Git Plateform: https://github.com/Artezaru/pyaescbc.git

• Online Documentation: https://Artezaru.github.io/pyaescbc

Installation

Install with pip

pip install pyaescbc

pip install git+https://github.com/Artezaru/pyaescbc.git

Clone with git

git clone https://github.com/Artezaru/pyaescbc.git

License

Copyright 2025 Artezaru

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.