Skip to main content

General purpose Python encrypted file-like object with random IO.

Project description

General purpose Python encrypted file-like object that facilitates random access IO. Uses AES encryption in CTR mode. Can be used with modules such as tarfile, zipfile, lzma, pickle, json and others that accept a file-like object as an alternative to a path. Supports binary IO modes only.


import cryptfile

with'data.bin', 'wb+', aes_key=b'256 bit key', block_num=5000) as f:
    f.write(b'Hello, World!')

b'Hello, World!'

Documentation, mode, aes_key=None, block_num=10000)

Returns a CryptFile object for a specified file.

  • file can either be a string containing a valid path, or a file-like object.
  • Supported mode values are: wb, wb+, rb, rb+, ab, ab+.
  • 256 bit binary aes_key is used for en/decryption, or if none is provided for a new file, a random key is generated and is retrievable with the .aeskey property.
  • block_num sets the number of 16 byte AES blocks per cryptfile block for new files. Each cryptfile block stores its own 8 byte nonce value, and is re-written in whole if any part of the block is altered. Larger block_num values optimize for more sequential IO, whereas smaller values optimize for smaller random IO that jumps around the file. This argument is not needed for opening existing files.


PyCryptodome for AES encryption


pip install cryptfile

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for cryptfile, version 1.0.4
Filename, size File type Python version Upload date Hashes
Filename, size cryptfile-1.0.4-py3-none-any.whl (17.8 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size cryptfile-1.0.4.tar.gz (5.6 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page