{ "info": { "author": "gocept gmbh & co. kg", "author_email": "mail@gocept.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 2 - Pre-Alpha", "Intended Audience :: Developers", "Intended Audience :: System Administrators", "License :: OSI Approved :: Zope Public License", "Natural Language :: English", "Operating System :: OS Independent", "Programming Language :: Python", "Topic :: Communications :: Email :: Post-Office :: IMAP", "Topic :: Software Development :: Libraries :: Python Modules" ], "description": "==============\ngocept.imapapi\n==============\n\nThis package provides an object-oriented API for accessing IMAP servers. It\nwas written to provide an API that is simple to use while still maintaining\ngood performance.\n\n.. contents::\n\nAbout\n=====\n\n`gocept.imapapi` is sponsored by the `Technical University of Munich`_ as part\nof a research co-operation geared towards an integrated webmail system for the\nuniversity's student portal `MyTum`_. Other components of this project include\n`gocept.restmail` and `CMFWebmail`.\n\nThis project was initially developed by `gocept gmbh & co. kg`_.\n\nObject-oriented API\n===================\n\nOne of the first goals of the webmail project was to factor out the\nlower-level utilities to allow others to build on our efforts.\n\nThis library takes on to provide a better abstracted, more object-oriented,\nwell, more `pythonic` approach than the builtin `imaplib` does.\n\nLet us give you an example of what we feel a good API looks like:\n\n >>> from gocept.imapapi import Account\n >>> account = Account('localhost', 10143, 'tim', 'mightywizard')\n >>> account.folders.keys()\n ['INBOX']\n >>> account.folders['INBOX'].messages\n \n >>> for message in account.folders['INBOX'].messages.values():\n ... repr(message.headers['subject'])\n u'Re: your spell from last week'\n u'Enlarge your magic wand!'\n\nSome of the aspects that come to mind when looking at this example:\n\n- Object model on top of protocol specifics\n- Use of native Python data structures\n- Decode protocol-specific data as early as possible (see the unicode headers)\n\nWith this approach we try to make programming IMAP clients simpler and more\nconvenient.\n\nPerformance\n===========\n\nThe imapapi layer tries to keep the amount and size of communication as small\nas possible, only retrieving data when really needed and re-using data already\nretrieved.\n\nAs an examples, body content isn't downloaded until needed and even when\nlooking at the body structure we differentiate between metadata and content.\n\nStatus\n======\n\nThis package is still in early development and published for experimental\npurposes and to invite a wider community to join us developing an IMAP library\nthat is more convenient than Python's builtin `imaplib`.\n\nRunning the tests\n=================\n\nThe tests expect an IMAP server to be available on localhost:10143. The\ndefault buildout environment provides a `dovecot`_ installation for this.\n\nAs we aim to be compatible with as many IMAP servers as possible, you should\nbe able to provide any IMAP server on this port, as long as a user 'test' with\nthe password 'bsdf' is configured.\n\nWarning: Do not let the tests run against a production system. They *might*\nwreak havoc.\n\n\n.. _`Technical University of Munich`: http://www.tum.de\n\n.. _`MyTum`: http://portal.mytum.de\n\n.. _`gocept gmbh & co. kg`: http://www.gocept.com\n\n.. _`dovecot`: http://www.dovecot.org\n\n\n=======\nCHANGES\n=======\n\n\n0.5 (2011-01-31)\n================\n\n- Added Folder.unread_message_count.\n\n- Added some debug output to help with #6830 and #7769.\n\n- Made some recently introduced logging more useful, adapted tests.\n\n\n0.4.1 (2010-11-30)\n==================\n\n- Made the test infrastructure load test messages in a more stable order.\n\n\n0.4 (2010-09-24)\n================\n\n- Added filter criterion \"seen\" (#7263).\n\n\n0.3 (2010-08-09)\n================\n\n- Filter messages on the IMAP server. (#4699)\n\n\n0.2 (2010-08-04)\n================\n\n- Lots of changes (see svn log for details).\n\n\n0.1 (2008-07-22)\n================\n\n- initial release.", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "UNKNOWN", "keywords": null, "license": "ZPL 2.1", "maintainer": null, "maintainer_email": null, "name": "gocept.imapapi", "package_url": "https://pypi.org/project/gocept.imapapi/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/gocept.imapapi/", "project_urls": { "Download": "UNKNOWN", "Homepage": "UNKNOWN" }, "release_url": "https://pypi.org/project/gocept.imapapi/0.5/", "requires_dist": null, "requires_python": null, "summary": "Object-oriented API for accessing IMAP accounts.", "version": "0.5" }, "last_serial": 792560, "releases": { "0.1": [ { "comment_text": "", "digests": { "md5": "d2ec0c34a638d0690bbfeb9cbcb65f23", "sha256": "717c7841ae4df890ca437929861cd0bb46a8a5ff4e3daa0dc078c07982da0985" }, "downloads": -1, "filename": "gocept.imapapi-0.1.tar.gz", "has_sig": false, "md5_digest": "d2ec0c34a638d0690bbfeb9cbcb65f23", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 16137, "upload_time": "2008-07-22T14:57:58", "url": "https://files.pythonhosted.org/packages/21/aa/c266664aaaaf767f43cdc21066eb05c3d644fb6bad8d82aceb955ecfe1dc/gocept.imapapi-0.1.tar.gz" } ], "0.4": [ { "comment_text": "", "digests": { "md5": "40aa716b38b7ef5bef9d8f9f86eb0cfe", "sha256": "a4dfd312eaaef391dcf415d11bd17947231cb04727a3460c1daa296500fd9f3a" }, "downloads": -1, "filename": "gocept.imapapi-0.4.tar.gz", "has_sig": false, "md5_digest": "40aa716b38b7ef5bef9d8f9f86eb0cfe", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 526673, "upload_time": "2010-11-23T08:52:24", "url": "https://files.pythonhosted.org/packages/e0/38/c878af6702c144b4d9f292859d1839248585bd02b9e8c3cfe375441d9aca/gocept.imapapi-0.4.tar.gz" } ], "0.5": [ { "comment_text": "", "digests": { "md5": "97272b43917378afb415f6d9cfc18f1a", "sha256": "4cf915a3b0a9080709026f1111a13af0b90713456227572fe99de94b4e58da23" }, "downloads": -1, "filename": "gocept.imapapi-0.5.tar.gz", "has_sig": true, "md5_digest": "97272b43917378afb415f6d9cfc18f1a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 527264, "upload_time": "2011-01-31T14:56:43", "url": "https://files.pythonhosted.org/packages/85/f9/8bc99cb65ad6d3a86dea1df501731fcd266a574bb583aa13554ba7a76cbc/gocept.imapapi-0.5.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "97272b43917378afb415f6d9cfc18f1a", "sha256": "4cf915a3b0a9080709026f1111a13af0b90713456227572fe99de94b4e58da23" }, "downloads": -1, "filename": "gocept.imapapi-0.5.tar.gz", "has_sig": true, "md5_digest": "97272b43917378afb415f6d9cfc18f1a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 527264, "upload_time": "2011-01-31T14:56:43", "url": "https://files.pythonhosted.org/packages/85/f9/8bc99cb65ad6d3a86dea1df501731fcd266a574bb583aa13554ba7a76cbc/gocept.imapapi-0.5.tar.gz" } ] }