deltachat-core

mirror of https://github.com/deltachat/deltachat-core.git synced 2025-10-04 02:09:17 +02:00

History

holger krekel 75f8169072 address #273 -- introduce attr for contact/chat/message/EventHandler also refine the GC-handling of contact and message pointers. free-ing dc_context pointers currently does not work because the threads are keeping a reference and not shutting down. help on this shutdown issue from @r10s or @flub welcome. I think fixing the context GC/shutdown issue should not hold up merging this branch.		2018-09-13 12:17:31 +02:00
..
src/deltachat	address #273 -- introduce attr for contact/chat/message/EventHandler	2018-09-13 12:17:31 +02:00
tests	address #273 -- introduce attr for contact/chat/message/EventHandler	2018-09-13 12:17:31 +02:00
conftest.py	make _logid a public argument, critique from @flub accepted	2018-09-09 13:51:54 +02:00
README.rst	add and check a simple readme, remove minversion, add some python/vim patterns to .gitignore	2018-09-09 17:42:59 +02:00
setup.cfg	add and check a simple readme, remove minversion, add some python/vim patterns to .gitignore	2018-09-09 17:42:59 +02:00
setup.py	address #273 -- introduce attr for contact/chat/message/EventHandler	2018-09-13 12:17:31 +02:00
tox.ini	address #273 -- introduce attr for contact/chat/message/EventHandler	2018-09-13 12:17:31 +02:00

README.rst

deltachat python bindings
=========================

This package provides bindings to the delta-core_ C-library
which provides imap/smtp/crypto handling as well as chat/group/messages
handling to Android, Desktop and IO user interfaces.

Install
-------

.. note::

    Currently the install instructions exist only for Debian based systems (Ubuntu etc.).

First you need to execute all the build steps to install the delta-core C-library,
see https://github.com/deltachat/deltachat-core/blob/master/README.md#build

Next, you need to do perform::

    pip install -e .

Afterwards you should be able to successfully import the bindings::

    python -c "import deltachat"


Running tests
-------------

Install the delta-core C-library (see _Install) and then
type the following to execute tests::

    pip install tox
    tox

If you want to run functional tests that run against real
e-mail accounts, generate a "liveconfig" file where each
lines contains account settings, for example::

    # liveconfig file for specifying real-life accounts
    addr=some-email@example.org mail_pw=password
    addr=other-email@example.org mail_pw=otherpassword

And then run the tests with this live-accounts config file::

    tox -- --liveconfig liveconfig


.. _`delta-core`: https://github.com/deltachat/deltachat-core