Skip to main content

A wrapper for select object operations using boto3 on Ceph which confirms integrity of reads and heals intermittent connectivity.

Project description


A wrapper for the following boto3 s3 client operations below the multipart upload threshold of 5 GB:

  • get_object
  • head_object
  • upload_fileobj
  • copy_object
  • delete_object


  • Retry connection failures
  • Confirm checksum of uploaded and retrieved objects
  • Constrained interface to support simple CRUD operations for objects in existing buckets


pip install object-clerk



clerk = ObjectClerk(host=, port=8080, access_key=12342, secret_key=12342, retry_delay=1, retry_backoff=1, retry_jitter=(1, 3), retry_max_delay=5, retry_tries=3, use_ssl=False)'

Get Object

# with checksum verified

bytes_response = clerk.get_object("bucket", "object_key")

# without checksum verified

bytes_response = clerk.get_object("bucket", "object_key", verify_checksum=False)

Delete Object

clerk.delete_object("bucket", "object_key")

Get Object Info

dict_response = clerk.get_object_info("bucket", "object_key")

Copy Object

# with checksum verified


# without checksum verified


Upload Object

# with checksum verified

with open("file", mode='rb') as f:

    clerk.upload_object(f, "bucket", "object_key")

# without checksum verified

with open("file", mode='rb') as f:

    clerk.upload_object(f, "bucket", "object_key", verify_checksum=False)


git clone

pip install -e .

export HOST=<host>

export PORT=<port>

export ACCESS_KEY=<access_key>

export SECRET_KEY=<secret_key>

pytest -v object_clerk

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 object-clerk, version 0.0.3
Filename, size File type Python version Upload date Hashes
Filename, size object-clerk-0.0.3.tar.gz (11.1 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page