Hello community, here is the log from the commit of package offlineimap for openSUSE:Factory checked in at 2012-01-19 16:56:10 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Comparing /work/SRC/openSUSE:Factory/offlineimap (Old) and /work/SRC/openSUSE:Factory/.offlineimap.new (New) ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Package is "offlineimap", Maintainer is "[email protected]" Changes: -------- --- /work/SRC/openSUSE:Factory/offlineimap/offlineimap.changes 2012-01-09 16:01:23.000000000 +0100 +++ /work/SRC/openSUSE:Factory/.offlineimap.new/offlineimap.changes 2012-01-19 16:56:12.000000000 +0100 @@ -1,0 +2,19 @@ +Tue Jan 17 09:26:40 UTC 2012 - [email protected] + +- update to version 6.5.2 + * user documentation is now integrated in + http://docs.offlineimap.org + * Gmail "realdelete" option is considered harmful and has the + potential for data loss (see + http://article.gmane.org/gmane.mail.imap.offlineimap.general/5265) + * rather than write out the nametrans'lated folder names for + mbnames, we now write out the local untransformed box names, + this became relevant since we support nametrans rules on the + local side since only a short time + * some sanity checks and improved error messages + * revert 6.5.1.1 change to use public imaplib2 function, it was + reported to not always work + * don't fail when ~/netrc is not readable by us + * don't emit noisy regular sleeping announcements in Basic UI + +------------------------------------------------------------------- Old: ---- offlineimap-v6.5.1.2.tar.gz New: ---- offlineimap-v6.5.2.tar.gz ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Other differences: ------------------ ++++++ offlineimap.spec ++++++ --- /var/tmp/diff_new_pack.QzQLxN/_old 2012-01-19 16:56:13.000000000 +0100 +++ /var/tmp/diff_new_pack.QzQLxN/_new 2012-01-19 16:56:13.000000000 +0100 @@ -16,7 +16,7 @@ # Name: offlineimap -Version: 6.5.1.2 +Version: 6.5.2 Release: 0 Summary: Powerful IMAP/Maildir Synchronization Tool License: GPL-2.0+ @@ -47,7 +47,7 @@ %prep -%setup -q -n spaetz-offlineimap-36080ac +%setup -q -n spaetz-offlineimap-091272d sed -i '/^#!\/usr\/bin\/env/d' offlineimap/imaplib2.py %build ++++++ offlineimap-v6.5.1.2.tar.gz -> offlineimap-v6.5.2.tar.gz ++++++ diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/spaetz-offlineimap-36080ac/Changelog.rst new/spaetz-offlineimap-091272d/Changelog.rst --- old/spaetz-offlineimap-36080ac/Changelog.rst 2012-01-07 23:34:00.000000000 +0100 +++ new/spaetz-offlineimap-091272d/Changelog.rst 2012-01-17 01:40:41.000000000 +0100 @@ -11,6 +11,28 @@ on releases. And because I'm lazy, it will also be used as a draft for the releases announces. +OfflineIMAP v6.5.2 (2012-01-17) +=============================== + +* Gmail "realdelete" option is considered harmful and has the potential + for data loss. Analysis at + http://article.gmane.org/gmane.mail.imap.offlineimap.general/5265 + Warnings were added to offlineimap.conf + +* Rather than write out the nametrans'lated folder names for mbnames, we + now write out the local untransformed box names. This is generally + what we want. This became relevant since we support nametrans rules on + the local side since only a short time. Reported by Paul Collignan. + +* Some sanity checks and improved error messages. + +* Revert 6.5.1.1 change to use public imaplib2 function, it was reported to + not always work. + +* Don't fail when ~/netrc is not readable by us. + +* Don't emit noisy regular sleeping announcements in Basic UI. + OfflineIMAP v6.5.1.2 (2012-01-07) - "Baby steps" ================================================ diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/spaetz-offlineimap-36080ac/docs/INSTALL.rst new/spaetz-offlineimap-091272d/docs/INSTALL.rst --- old/spaetz-offlineimap-36080ac/docs/INSTALL.rst 2012-01-07 23:34:00.000000000 +0100 +++ new/spaetz-offlineimap-091272d/docs/INSTALL.rst 2012-01-17 01:40:41.000000000 +0100 @@ -1,81 +1,90 @@ .. -*- coding: utf-8 -*- +.. _OfflineIMAP: https://github.com/spaetz/offlineimap +.. _OLI_git_repo: git://github.com/spaetz/offlineimap.git -.. _OfflineIMAP: https://github.com/nicolas33/offlineimap +============ +Installation +============ .. contents:: -.. sectnum:: +.. .. sectnum:: -============= +------------- Prerequisites -============= +------------- In order to use `OfflineIMAP`_, you need to have these conditions satisfied: -1. Your mail server must support IMAP. Most Internet Service Providers and - corporate networks do, and most operating systems have an IMAP implementation - readily available. A special Gmail mailbox type is available to interface with - Gmail's IMAP front-end. - -2. You must have Python version 2.6 or above installed. If you are running on - Debian GNU/Linux, this requirement will automatically be taken care of for you. - If you do not have Python already, check with your system administrator or - operating system vendor; or, download it from the Python website. If you intend - to use the SSL interface, your Python must have been built with SSL support. - -3. Have a mail reader that supports the Maildir mailbox format. Most modern - mail readers have this support built-in, so you can choose from a wide variety - of mail servers. This format is also known as the "qmail" format, so any mail - reader compatible with it will work with `OfflineIMAP`_. If you do not have a - mail reader that supports Maildir, you can often install a local IMAP server and - point both `OfflineIMAP`_ and your mail reader at it. +1. Your mail server must support IMAP. Mail access via POP is not + supported. A special Gmail mailbox type is available to interface + with Gmail's IMAP front-end, although Gmail has a very peculiar and + non-standard implementation of its IMAP interface. + +2. You must have Python version 2.6 or above installed. If you are + running on Debian GNU/Linux, this requirement will automatically be + taken care of for you. If you intend to use the SSL interface, + your Python must have been built with SSL support. + +3. If you use OfflineImap as an IMAP<->Maildir synchronizer, you will + obviously need to have a mail reader that supports the Maildir + mailbox format. Most modern mail readers have this support built-in, + so you can choose from a wide variety of mail servers. This format + is also known as the "qmail" format, so any mail reader compatible + with it will work with `OfflineIMAP`_. -============ +------------ Installation -============ +------------ -You have three options: +Installing OfflineImap should usually be quite easy, as you can simply unpack and run OfflineImap in place if you wish to do so. There are a number of options though: -1. a system-wide installation with Debian -2. a system-wide installation with other systems -3. a single-user installation. You can checkout the latest version of - `OfflineIMAP`_ from official `OfflineIMAP`_ repository. +#. system-wide :ref:`installation via your distribution package manager <inst_pkg_man>` +#. system-wide or single user :ref:`installation from the source package <inst_src_tar>` +#. system-wide or single user :ref:`installation from a git checkout <inst_git>` +Having installed OfflineImap, you will need to configure it, to be actually useful. Please check the :ref:`Configuration` section in the :doc:`MANUAL` for more information on the configuration step. -System-Wide Installation, Debian -================================ +.. _inst_pkg_man: -If you are tracking Debian unstable, you may install `OfflineIMAP`_ by simply -running the following command as root:: +System-Wide Installation via distribution +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +The easiest way to install OfflineIMAP is via your distribution's package manager. OfflineImap is available under the name `offlineimap` in most Linux and BSD distributions. - apt-get install offlineimap -If you are not tracking Debian unstable, download the Debian `.deb` package from -the `OfflineIMAP`_ website and then run ``dpkg -i`` to install the downloaded -package. Then, skip to below. You will type offlineimap to invoke the -program. +.. _inst_src_tar: -System-Wide Installation, Other -=============================== +Installation from source package +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Download the latest source archive from our `download page <https://github.com/spaetz/offlineimap/downloads>`_. Simply click the "Download as .zip" or "Download as .tar.gz" buttons to get the latest "stable" code from the master branch. If you prefer command line, you will want to use: + wget https://github.com/spaetz/offlineimap/tarball/master -Check your distribution packaging tool, OfflineIMAP may already be packaged for -you. +Unpack and continue with the :ref:`system-wide installation <system_wide_inst>` or the :ref:`single-user installation <single_user_inst>` section. -System-Wide Installation, From source -===================================== -Get your own copy of the official git repository at `OfflineIMAP`_:: +.. _inst_git: - git clone git://github.com/nicolas33/offlineimap.git +Installation from git checkout +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -This will download all the sources with history. By default, git set up the -local master branch up which is most likely what you want. If not, you can -checkout a particular release:: +Get your own copy of the `official git repository <OLI_git_repo>`_ at `OfflineIMAP`_:: + + git clone git://github.com/spaetz/offlineimap.git + +This will download the source with history. By default, git sets up the +`master` branch up, which is most likely what you want. If not, you can +checkout a particular release like this:: cd offlineimap - git checkout -b local_version v6.3.3 + git checkout v6.5.2.1 + +You have now a source tree available and proceed with either the :ref:`system-wide installation <system_wide_inst>` or the :ref:`single-user installation <single_user_inst>`. + + +.. _system_wide_inst: -The latter creates a local branch called "local_version" of the v6.3.3 release. +System-wide installation +++++++++++++++++++++++++ Then run these commands, to build the python package:: @@ -86,47 +95,38 @@ python setup.py install -Next, proceed to below. You will type offlineimap to invoke the program. +Next, proceed to below. You tofflineimap to invoke the program. -Single-Account Installation -=========================== + +.. _single_user_inst: + +Single-user installation +++++++++++++++++++++++++ Download the git repository as described above. Instead of installing the program as root, you type `./offlineimap.py`; there is no installation step necessary. -============= -Configuration -============= - -`OfflineIMAP`_ is regulated by a configuration file that is normally stored in -`~/.offlineimaprc`. `OfflineIMAP`_ ships with a file named `offlineimap.conf` -that you should copy to that location and then edit. This file is vital to -proper operation of the system; it sets everything you need to run -`OfflineIMAP`_. Full documentation for the configuration file is included -within the sample file. - - -`OfflineIMAP`_ also ships a file named `offlineimap.conf.minimal` that you can -also try. It's useful if you want to get started with the most basic feature -set, and you can read about other features later with `offlineimap.conf`. - - -=============== +--------- Uninstall -=============== +--------- If you installed a system-wide installation via "python setup.py -install", there are a few files to purge to uninstall it again. I assume -that /usr/local is the standard prefix that your system and you use -python 2.7. Adapt to your system. In that case you need to: +install", there are a few files to purge to cleanly uninstall +`OfflineImap`_ again. Assuming that `/usr/local` is the standard prefix of +your system and that you use python 2.7, you need to: + +#) Delete the OfflineImap installation itself:: -1) Delete: /usr/local/lib/python2.7/dist-packages/offlineimap-6.4.4.egg-info /usr/local/lib/python2.7/dist-packages/offlineimap -2) Delete the cache at (default location) ~/.offlineimap - Delete your manually created (default loc) ~/.offlineimaprc + In case, you did the single-user installation, simply delete your + offlineimap directory. + +#) Delete all files that OfflineImap creates during its operation. + - The cache at (default location) ~/.offlineimap + - Your manually created (default loc) ~/.offlineimaprc (It is possible that you created those in different spots) That's it. Have fun without OfflineImap. diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/spaetz-offlineimap-36080ac/docs/MANUAL.rst new/spaetz-offlineimap-091272d/docs/MANUAL.rst --- old/spaetz-offlineimap-36080ac/docs/MANUAL.rst 2012-01-07 23:34:00.000000000 +0100 +++ new/spaetz-offlineimap-091272d/docs/MANUAL.rst 2012-01-17 01:40:41.000000000 +0100 @@ -43,6 +43,23 @@ OfflineImap is well suited to be frequently invoked by cron jobs, or can run in daemon mode to periodically check your email (however, it will exit in some error situations). +.. _configuration: + +Configuration +============= + +`OfflineIMAP`_ is regulated by a configuration file that is normally stored in +`~/.offlineimaprc`. `OfflineIMAP`_ ships with a file named `offlineimap.conf` +that you should copy to that location and then edit. This file is vital to +proper operation of the system; it sets everything you need to run +`OfflineIMAP`_. Full documentation for the configuration file is included +within the sample file. + + +`OfflineIMAP`_ also ships a file named `offlineimap.conf.minimal` that you can +also try. It's useful if you want to get started with the most basic feature +set, and you can read about other features later with `offlineimap.conf`. + Check out the `Use Cases`_ section for some example configurations. diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/spaetz-offlineimap-36080ac/docs/dev-doc-src/API.rst new/spaetz-offlineimap-091272d/docs/dev-doc-src/API.rst --- old/spaetz-offlineimap-36080ac/docs/dev-doc-src/API.rst 1970-01-01 01:00:00.000000000 +0100 +++ new/spaetz-offlineimap-091272d/docs/dev-doc-src/API.rst 2012-01-17 01:40:41.000000000 +0100 @@ -0,0 +1,55 @@ +.. OfflineImap API documentation + +.. currentmodule:: offlineimap + +Welcome to :mod:`offlineimaps`'s documentation +============================================== + +Within :mod:`offlineimap`, the classes :class:`OfflineImap` provides the high-level functionality. The rest of the classes should usually not needed to be touched by the user. Email repositories are represented by a :class:`offlineimap.repository.Base.BaseRepository` or derivatives (see :mod:`offlineimap.repository` for details). A folder within a repository is represented by a :class:`offlineimap.folder.Base.BaseFolder` or any derivative from :mod:`offlineimap.folder`. + +This page contains the main API overview of OfflineImap |release|. + +OfflineImap can be imported as:: + + from offlineimap import OfflineImap + +:mod:`offlineimap` -- The OfflineImap module +============================================= + +.. module:: offlineimap + +.. autoclass:: offlineimap.OfflineImap(cmdline_opts = None) + + + .. automethod:: run + + .. automethod:: parse_cmd_options + +.. .. autoattribute:: ui + + :todo: Document + +:class:`offlineimap.account` +============================ + +An :class:`accounts.Account` connects two email repositories that are to be synced. It comes in two flavors, normal and syncable. + +.. autoclass:: offlineimap.accounts.Account + +.. autoclass:: offlineimap.accounts.SyncableAccount + :members: + :inherited-members: + + .. autodata:: ui + + Contains the current :mod:`offlineimap.ui`, and can be used for logging etc. + +:exc:`OfflineImapError` -- A Notmuch execution error +-------------------------------------------------------- + +.. autoexception:: offlineimap.error.OfflineImapError + :members: + + This execption inherits directly from :exc:`Exception` and is raised + on errors during the offlineimap execution. It has an attribute + `severity` that denotes the severity level of the error. diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/spaetz-offlineimap-36080ac/docs/dev-doc-src/FAQ.rst new/spaetz-offlineimap-091272d/docs/dev-doc-src/FAQ.rst --- old/spaetz-offlineimap-36080ac/docs/dev-doc-src/FAQ.rst 1970-01-01 01:00:00.000000000 +0100 +++ new/spaetz-offlineimap-091272d/docs/dev-doc-src/FAQ.rst 2012-01-19 16:56:13.000000000 +0100 @@ -0,0 +1 @@ +symbolic link to ../FAQ.rst diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/spaetz-offlineimap-36080ac/docs/dev-doc-src/INSTALL.rst new/spaetz-offlineimap-091272d/docs/dev-doc-src/INSTALL.rst --- old/spaetz-offlineimap-36080ac/docs/dev-doc-src/INSTALL.rst 1970-01-01 01:00:00.000000000 +0100 +++ new/spaetz-offlineimap-091272d/docs/dev-doc-src/INSTALL.rst 2012-01-19 16:56:13.000000000 +0100 @@ -0,0 +1 @@ +symbolic link to ../INSTALL.rst diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/spaetz-offlineimap-36080ac/docs/dev-doc-src/MANUAL.rst new/spaetz-offlineimap-091272d/docs/dev-doc-src/MANUAL.rst --- old/spaetz-offlineimap-36080ac/docs/dev-doc-src/MANUAL.rst 1970-01-01 01:00:00.000000000 +0100 +++ new/spaetz-offlineimap-091272d/docs/dev-doc-src/MANUAL.rst 2012-01-19 16:56:13.000000000 +0100 @@ -0,0 +1 @@ +symbolic link to ../MANUAL.rst diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/spaetz-offlineimap-36080ac/docs/dev-doc-src/conf.py new/spaetz-offlineimap-091272d/docs/dev-doc-src/conf.py --- old/spaetz-offlineimap-36080ac/docs/dev-doc-src/conf.py 2012-01-07 23:34:00.000000000 +0100 +++ new/spaetz-offlineimap-091272d/docs/dev-doc-src/conf.py 2012-01-17 01:40:41.000000000 +0100 @@ -94,7 +94,7 @@ # The theme to use for HTML and HTML Help pages. Major themes that come with # Sphinx are currently 'default' and 'sphinxdoc'. html_theme = 'default' - +#html_style = '' # Theme options are theme-specific and customize the look and feel of a theme # further. For a list of options available for each theme, see the # documentation. diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/spaetz-offlineimap-36080ac/docs/dev-doc-src/index.rst new/spaetz-offlineimap-091272d/docs/dev-doc-src/index.rst --- old/spaetz-offlineimap-36080ac/docs/dev-doc-src/index.rst 2012-01-07 23:34:00.000000000 +0100 +++ new/spaetz-offlineimap-091272d/docs/dev-doc-src/index.rst 2012-01-17 01:40:41.000000000 +0100 @@ -1,69 +1,42 @@ .. OfflineImap documentation master file +.. _OfflineImap: http://offlineimap.org -.. currentmodule:: offlineimap Welcome to :mod:`offlineimaps`'s documentation ============================================== -The :mod:`offlineimap` module provides the user interface for synchronization between IMAP servers and MailDirs or between IMAP servers. The homepage containing the source code repository can be found at the `offlineimap homepage <http://offlineimap.org>`_. The following provides the developer documentation for those who are interested in modifying the source code or otherwise peek into the OfflineImap internals. End users might want to check the MANUAL, our INSTALLation instructions, and the FAQ. +`OfflineImap`_ synchronizes email between an IMAP server and a MailDir or between two IMAP servers. It offers very powerful and flexible configuration options, that allow things such as the filtering of folders, transposing of names via static configuration or python scripting. It plays well with mutt and other MailDir consuming email clients. -Within :mod:`offlineimap`, the classes :class:`OfflineImap` provides the high-level functionality. The rest of the classes should usually not needed to be touched by the user. Email repositories are represented by a :class:`offlineimap.repository.Base.BaseRepository` or derivatives (see :mod:`offlineimap.repository` for details). A folder within a repository is represented by a :class:`offlineimap.folder.Base.BaseFolder` or any derivative from :mod:`offlineimap.folder`. +The documentation contains the end user documentation in a first part. It also contains use cases and example configurations. It is followed by the internal :doc:`API documentation <API>` for those interested in modifying the source code or otherwise peek into the OfflineImap internals in a second part. -.. moduleauthor:: John Goerzen, and many others. See AUTHORS and the git history for a full list. - -:License: This module is covered under the GNU GPL v2 (or later). -This page contains the main API overview of OfflineImap |release|. - -OfflineImap can be imported as:: - - from offlineimap import OfflineImap +If you just want to get started with minimal fuzz, have a look at our `online quick start guide <http://offlineimap.org/#ref-quick-start>`_. Do note though, that our configuration options are many and powerful. Perusing our precious documentation does often pay off! More information on specific topics can be found on the following pages: +**User documentation** + * :doc:`installation/uninstall <INSTALL>` + * :doc:`user manual/Configuration <MANUAL>` + * :doc:`command line options <offlineimap>` + * :doc:`Frequently Asked Questions <FAQ>` + +**Developer documentation** + * :doc:`API documentation <API>` for internal details on the + :mod:`offlineimap` module + .. toctree:: - :maxdepth: 1 + :hidden: - repository - ui + INSTALL + MANUAL offlineimap + FAQ -:mod:`offlineimap` -- The OfflineImap module -============================================= - -.. module:: offlineimap - -.. autoclass:: offlineimap.OfflineImap(cmdline_opts = None) - - .. automethod:: lock - - .. automethod:: run - -.. .. autoattribute:: ui - - :todo: Document - -:class:`offlineimap.account` -============================ - -An :class:`accounts.Account` connects two email repositories that are to be synced. It comes in two flavors, normal and syncable. - -.. autoclass:: offlineimap.accounts.Account - -.. autoclass:: offlineimap.accounts.SyncableAccount - :members: - :inherited-members: - - .. autodata:: ui - - Contains the current :mod:`offlineimap.ui`, and can be used for logging etc. + API + repository + ui -:exc:`OfflineImapError` -- A Notmuch execution error --------------------------------------------------------- -.. autoexception:: offlineimap.error.OfflineImapError - :members: +.. moduleauthor:: John Goerzen, and many others. See AUTHORS and the git history for a full list. - This execption inherits directly from :exc:`Exception` and is raised - on errors during the offlineimap execution. It has an attribute - `severity` that denotes the severity level of the error. +:License: This module is covered under the GNU GPL v2 (or later). diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/spaetz-offlineimap-36080ac/offlineimap/__init__.py new/spaetz-offlineimap-091272d/offlineimap/__init__.py --- old/spaetz-offlineimap-36080ac/offlineimap/__init__.py 2012-01-07 23:34:00.000000000 +0100 +++ new/spaetz-offlineimap-091272d/offlineimap/__init__.py 2012-01-17 01:40:41.000000000 +0100 @@ -1,7 +1,7 @@ __all__ = ['OfflineImap'] __productname__ = 'OfflineIMAP' -__version__ = "6.5.1.2" +__version__ = "6.5.2" __copyright__ = "Copyright 2002-2012 John Goerzen & contributors" __author__ = "John Goerzen" __author_email__= "[email protected]" diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/spaetz-offlineimap-36080ac/offlineimap/accounts.py new/spaetz-offlineimap-091272d/offlineimap/accounts.py --- old/spaetz-offlineimap-36080ac/offlineimap/accounts.py 2012-01-07 23:34:00.000000000 +0100 +++ new/spaetz-offlineimap-091272d/offlineimap/accounts.py 2012-01-17 01:40:41.000000000 +0100 @@ -372,7 +372,7 @@ % localfolder) return # Write the mailboxes - mbnames.add(account.name, localfolder.getvisiblename()) + mbnames.add(account.name, localfolder.getname()) # Load status folder. statusfolder = statusrepos.getfolder(remotefolder.getvisiblename().\ diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/spaetz-offlineimap-36080ac/offlineimap/folder/IMAP.py new/spaetz-offlineimap-091272d/offlineimap/folder/IMAP.py --- old/spaetz-offlineimap-36080ac/offlineimap/folder/IMAP.py 2012-01-07 23:34:00.000000000 +0100 +++ new/spaetz-offlineimap-091272d/offlineimap/folder/IMAP.py 2012-01-17 01:40:41.000000000 +0100 @@ -42,19 +42,19 @@ self.randomgenerator = random.Random() #self.ui is set in BaseFolder - def selectro(self, imapobj): + def selectro(self, imapobj, force = False): """Select this folder when we do not need write access. Prefer SELECT to EXAMINE if we can, since some servers (Courier) do not stabilize UID validity until the folder is selected. .. todo: Still valid? Needs verification - + :param: Enforce new SELECT even if we are on that folder already. :returns: raises :exc:`OfflineImapError` severity FOLDER on error""" try: - imapobj.select(self.getfullname()) + imapobj.select(self.getfullname(), force = force) except imapobj.readonly: - imapobj.select(self.getfullname(), readonly = True) + imapobj.select(self.getfullname(), readonly = True, force = force) def suggeststhreads(self): return 1 @@ -70,8 +70,12 @@ try: # SELECT receives UIDVALIDITY response self.selectro(imapobj) - typ, uidval = imapobj.response('UIDVALIDITY') - return long(uidval[0]) + # note: we would want to use .response() here but that + # often seems to return [None], even though we have + # data. TODO + uidval = imapobj._get_untagged_response('UIDVALIDITY') + assert uidval != [None], "response('UIDVALIDITY') returned [None]!" + return long(uidval[-1]) finally: self.imapserver.releaseconnection(imapobj) @@ -566,8 +570,11 @@ if use_uidplus or imapobj._get_untagged_response('APPENDUID', True): # get new UID from the APPENDUID response, it could look # like OK [APPENDUID 38505 3955] APPEND completed with - # 38505 bein folder UIDvalidity and 3955 the new UID - typ, resp = imapobj.response('APPENDUID') + # 38505 bein folder UIDvalidity and 3955 the new UID. + # note: we would want to use .response() here but that + # often seems to return [None], even though we have + # data. TODO + resp = imapobj._get_untagged_response('APPENDUID') if resp == [None]: self.ui.warn("Server supports UIDPLUS but got no APPENDUID " "appending a message.") diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/spaetz-offlineimap-36080ac/offlineimap/folder/UIDMaps.py new/spaetz-offlineimap-091272d/offlineimap/folder/UIDMaps.py --- old/spaetz-offlineimap-36080ac/offlineimap/folder/UIDMaps.py 2012-01-07 23:34:00.000000000 +0100 +++ new/spaetz-offlineimap-091272d/offlineimap/folder/UIDMaps.py 2012-01-17 01:40:41.000000000 +0100 @@ -191,7 +191,8 @@ newluid = self._mb.savemessage(-1, content, flags, rtime) if newluid < 1: - raise ValueError("Backend could not find uid for message") + raise ValueError("Backend could not find uid for message, returned " + "%s" % newluid) self.maplock.acquire() try: self.diskl2r[newluid] = uid diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/spaetz-offlineimap-36080ac/offlineimap/imaplibutil.py new/spaetz-offlineimap-091272d/offlineimap/imaplibutil.py --- old/spaetz-offlineimap-36080ac/offlineimap/imaplibutil.py 2012-01-07 23:34:00.000000000 +0100 +++ new/spaetz-offlineimap-091272d/offlineimap/imaplibutil.py 2012-01-17 01:40:41.000000000 +0100 @@ -40,7 +40,7 @@ return self.mailbox return None - def select(self, mailbox='INBOX', readonly=False, force = 0): + def select(self, mailbox='INBOX', readonly=False, force = False): """Selects a mailbox on the IMAP server :returns: 'OK' on success, nothing if the folder was already diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/spaetz-offlineimap-36080ac/offlineimap/repository/IMAP.py new/spaetz-offlineimap-091272d/offlineimap/repository/IMAP.py --- old/spaetz-offlineimap-36080ac/offlineimap/repository/IMAP.py 2012-01-07 23:34:00.000000000 +0100 +++ new/spaetz-offlineimap-091272d/offlineimap/repository/IMAP.py 2012-01-17 01:40:41.000000000 +0100 @@ -138,7 +138,7 @@ try: netrcentry = netrc.netrc('/etc/netrc').authenticators(self.gethost()) except IOError, inst: - if inst.errno != errno.ENOENT: + if inst.errno not in (errno.ENOENT, errno.EACCES): raise else: if netrcentry: @@ -235,7 +235,7 @@ try: netrcentry = netrc.netrc('/etc/netrc').authenticators(self.gethost()) except IOError, inst: - if inst.errno != errno.ENOENT: + if inst.errno not in (errno.ENOENT, errno.EACCES): raise else: if netrcentry: diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/spaetz-offlineimap-36080ac/offlineimap/ui/TTY.py new/spaetz-offlineimap-091272d/offlineimap/ui/TTY.py --- old/spaetz-offlineimap-36080ac/offlineimap/ui/TTY.py 2012-01-07 23:34:00.000000000 +0100 +++ new/spaetz-offlineimap-091272d/offlineimap/ui/TTY.py 2012-01-17 01:40:41.000000000 +0100 @@ -84,3 +84,19 @@ else: UIBase.mainException(self) + def sleeping(self, sleepsecs, remainingsecs): + """Sleep for sleepsecs, display remainingsecs to go. + + Does nothing if sleepsecs <= 0. + Display a message on the screen if we pass a full minute. + + This implementation in UIBase does not support this, but some + implementations return 0 for successful sleep and 1 for an + 'abort', ie a request to sync immediately. + """ + if sleepsecs > 0: + if remainingsecs//60 != (remainingsecs-sleepsecs)//60: + self.logger.info("Next refresh in %.1f minutes" % ( + remainingsecs/60.0)) + time.sleep(sleepsecs) + return 0 diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/spaetz-offlineimap-36080ac/offlineimap/ui/UIBase.py new/spaetz-offlineimap-091272d/offlineimap/ui/UIBase.py --- old/spaetz-offlineimap-36080ac/offlineimap/ui/UIBase.py 2012-01-07 23:34:00.000000000 +0100 +++ new/spaetz-offlineimap-091272d/offlineimap/ui/UIBase.py 2012-01-17 01:40:41.000000000 +0100 @@ -493,7 +493,7 @@ """ if sleepsecs > 0: if remainingsecs//60 != (remainingsecs-sleepsecs)//60: - self.logger.info("Next refresh in %.1f minutes" % ( + self.logger.debug("Next refresh in %.1f minutes" % ( remainingsecs/60.0)) time.sleep(sleepsecs) return 0 diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/spaetz-offlineimap-36080ac/offlineimap.conf new/spaetz-offlineimap-091272d/offlineimap.conf --- old/spaetz-offlineimap-36080ac/offlineimap.conf 2012-01-07 23:34:00.000000000 +0100 +++ new/spaetz-offlineimap-091272d/offlineimap.conf 2012-01-17 01:40:41.000000000 +0100 @@ -546,16 +546,20 @@ # Specify the Gmail user name. This is the only mandatory parameter. remoteuser = [email protected] -# Deleting a message from a Gmail folder via the IMAP interface will -# just remove that folder's label from the message: the message will -# continue to exist in the '[Gmail]/All Mail' folder. If `realdelete` -# is set to `True`, then deleted messages will really be deleted -# during `offlineimap` sync, by moving them to the '[Gmail]/Trash' -# folder. BEWARE: this will delete a messages from *all folders* it -# belongs to! -# -# See http://mail.google.com/support/bin/answer.py?answer=77657&topic=12815 -realdelete = no +# WARNING: READ THIS BEFORE CONSIDERING TO CHANGE IT! Deleting a +# message from a Gmail folder via the IMAP interface will just remove +# that folder's label from the message: the message will continue to +# exist in the '[Gmail]/All Mail' folder. If `realdelete` is set to +# `True`, then deleted messages will be moved to the '[Gmail]/Trash' +# folder. BEWARE: this will immediately delete a messages from *all +# folders* it belongs to! AS OFFLINEIMAP IMPLEMENTS FOLDER MOVES AS 1) +# AN ADD and 2) A DELETE (the order can vary), THIS MEANS THAT A FOLDER +# MOVE CAN CAUSE DATALOSS. DO NOT USE IT AND MOVE MAIL TO +# "[Gmail]/Trash" TO DELETE MAIL FROM "[Gmail]/All Mail"! See the +# analysis at +# http://article.gmane.org/gmane.mail.imap.offlineimap.general/5265 See +# http://mail.google.com/support/bin/answer.py?answer=77657&topic=12815 +# realdelete = no !!!READ ABOVE BEFORE USING # The trash folder name may be different from [Gmail]/Trash # for example on german googlemail, this setting should be -- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
