Skip to main content

Python client library for EteSync

Project description

EteSync - Secure Data Sync

This is a python client library for EteSync

GitHub tag PyPI Build Status Chat on freenode

This module provides a python API to interact with an EteSync server. It currently implements AddressBook and Calendar access, and supports two-way sync (both push and pull) to the server. It doesn't currently implement pushing raw journal entries which are needed for people implementing new EteSync journal types which will be implemented soon.

To install, please run:

pip install etesync

The module works and the API is tested (see tests/), however there still may be some oddities, so please report if you encounter any.

There is one Authenticator endpoint, and one endpoint for the rest of the API interactions.

The way it works is that you run "sync", which syncs local cache with server. Afterwards you can either access the journal directly, or if you prefer, you can access a collection, for example a Calendar, and interact with the entries themselves, which are already in sync with the journal.

Check out for a basic usage example, or the tests for a more complete example.

While this is stable enough for usage, it still may be subject to change, so please watch out for the changelog when updating version. Docs are currently missing but are planned.

Running the example script

You may also need to make sure you have the OpenSSL development package installed (e.g. openssl-dev).

Check out this repository:

git clone
cd pyetesync

Setup the environment:

python3 -m venv venv
source venv/bin/activate
pip install -r

Run to export your data:

python3 <email> <auth password> <encryption password>

You may need to surround your passwords in quotes and you may need to escape special characters with a \. Please note, that depending on your setup, passing your passwords as command line parameters may not be completely secure, so it would be better if you manually edit the file.

And all of your data will be copied to a local database located at ~/.etesync/data.db.

Running the tests

Some to the tests are unit tests, but some are integration tests who need an actual EteSync service with a few user names set up in order for them to work.

You'd need to run your local server:

And then add two users:

  • test@localhost
  • test2@localhost

Password for both: SomePassword

That's it.

Project details

Download files

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

Source Distribution

etesync-0.10.0.tar.gz (20.0 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page