From f4baef7f0a1c88e46683c101b738f2c2b7e7e430 Mon Sep 17 00:00:00 2001 From: Adam Coddington Date: Sat, 30 Jun 2012 22:38:58 -0700 Subject: [PATCH 1/9] Updating documentation, bumping version number. --- .hgignore | 1 + readme.rst | 9 ++++----- setup.py | 4 ++-- 3 files changed, 7 insertions(+), 7 deletions(-) diff --git a/.hgignore b/.hgignore index 5aab31a..aee46ca 100644 --- a/.hgignore +++ b/.hgignore @@ -1,2 +1,3 @@ .*\.pyc .*egg-info.* +dist/.* diff --git a/readme.rst b/readme.rst index 2665f9e..6f489f6 100644 --- a/readme.rst +++ b/readme.rst @@ -1,11 +1,11 @@ Introduction ~~~~~~~~~~~~ -How many times have you had to consume some sort of POP3 or IMAP mailbox for incoming content? One too many times for me. +How many times have you had to consume some sort of POP3, IMAP, or local mailbox for incoming content? One too many times for me. -This small Django application will allow you to specify IMAP or POP3 mailboxes that you would like consumed for incoming content; the e-mail will be stored, and you can process it at will (or, if you're in a hurry, by subscribing to a signal). +This small Django application will allow you to specify mailboxes that you would like consumed for incoming content; the e-mail will be stored, and you can process it at will (or, if you're in a hurry, by subscribing to a signal). -WARNING! This app will delete any messages it can find in the inbox you specify-- please make sure you don't have anything important in there. +WARNING! This will delete any messages it can find in the inbox you specify-- please make sure you don't have anything important in there. Setting up your mailbox ======================= @@ -49,8 +49,7 @@ If you happen to want to consume a file-based mailbox like an Maildir, Mbox, Bab maildir:///var/mail -.. important:: - Note that there are three slashes in the above URI. +Note that there is an additional ``/`` in the above URI after the protocol; this is important. Subscribing to the incoming mail signal ======================================= diff --git a/setup.py b/setup.py index aabc8ac..4c021bc 100644 --- a/setup.py +++ b/setup.py @@ -2,9 +2,9 @@ from setuptools import setup, find_packages setup( name='django_mailbox', - version='1.0', + version='1.0.1', url='http://bitbucket.org/latestrevision/django-mailbox/', - description='Automatically import mail from POP3 or IMAP into Django', + description='Automatically import mail from POP3, IMAP, or a local mailbox into Django', author='Adam Coddington', author_email='me@adamcoddington.net', classifiers=[ From 6609cf19a5ef7c0dacae0afcf79abd16fa6d34c3 Mon Sep 17 00:00:00 2001 From: Adam Coddington Date: Sat, 30 Jun 2012 22:39:07 -0700 Subject: [PATCH 2/9] Added tag 1.0.1 for changeset 9041cea29068 --- .hgtags | 1 + 1 file changed, 1 insertion(+) diff --git a/.hgtags b/.hgtags index 291669e..467f780 100755 --- a/.hgtags +++ b/.hgtags @@ -1,2 +1,3 @@ c4a9d1fff0bb66431a582cd93767422f377b33e6 0.2 c89f77b8f60331e81c1a6e48d7bf94ecc6897a65 1.0 +9041cea2906864dc6b10d82e97239a9310d9c526 1.0.1 From eb39ca4c8476aff6c92b3c58682349893654eb05 Mon Sep 17 00:00:00 2001 From: Adam Coddington Date: Wed, 18 Jul 2012 21:25:26 -0700 Subject: [PATCH 3/9] Although I love randomly-selected names, passwords, etc, as it turns out, this is a real e-mail address, and I feel like I should pick something less likely to cause somebody to receive spam. --- readme.rst | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/readme.rst b/readme.rst index 6f489f6..d5d7d98 100644 --- a/readme.rst +++ b/readme.rst @@ -15,7 +15,7 @@ Django Mailbox supports both common internet mailboxes like POP3 and IMAP as wel .. table:: Protocol Options ============ ============== ========================================= - Mailbox Type 'Protocol' Notes + Mailbox Type 'Protocol':// Notes ============ ============== ========================================= POP3 ``pop3://`` Can also specify SSL with ``pop3+ssl://`` IMAP ``imap://`` Can also specify SSL with ``imap+ssl://`` @@ -34,13 +34,14 @@ Mailbox URIs are in the normal URI format:: protocol://username:password@domain Basic IMAP Example: ``imap://username:password@server`` + Basic POP3 Example: ``pop3://username:password@server`` Most mailboxes these days are SSL-enabled; if yours is, add ``+ssl`` to your URI. Also, if your username or password include any non-ascii characters, they should be URL-encoded (for example, if your username includes an ``@``, it should be changed to ``%40`` in your URI). -If you have an account named 'contemporanea@gmail.com' with a password of '1234' on GMail (which I happen to know uses the POP3 server of 'pop.gmail.com' and requires SSL), you would enter the following as your URI:: +If you have an account named 'youremailaddress@gmail.com' with a password of '1234' on GMail (which I happen to know uses the POP3 server of 'pop.gmail.com' and requires SSL), you would enter the following as your URI:: - pop3+ssl://contemporanea%40gmail.com:1234@pop.gmail.com + pop3+ssl://youremailaddress%40gmail.com:1234@pop.gmail.com Local File-based Mailboxes -------------------------- From 47d66df310f564984d9f02fd809ecb688c211d72 Mon Sep 17 00:00:00 2001 From: Adam Coddington Date: Wed, 18 Jul 2012 21:34:44 -0700 Subject: [PATCH 4/9] Documentation changes (for clarity). --- readme.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/readme.rst b/readme.rst index d5d7d98..ae56a0e 100644 --- a/readme.rst +++ b/readme.rst @@ -12,7 +12,7 @@ Setting up your mailbox Django Mailbox supports both common internet mailboxes like POP3 and IMAP as well as local file-based mailboxes. -.. table:: Protocol Options +.. table:: 'Protocol' Options ============ ============== ========================================= Mailbox Type 'Protocol':// Notes @@ -39,14 +39,14 @@ Basic POP3 Example: ``pop3://username:password@server`` Most mailboxes these days are SSL-enabled; if yours is, add ``+ssl`` to your URI. Also, if your username or password include any non-ascii characters, they should be URL-encoded (for example, if your username includes an ``@``, it should be changed to ``%40`` in your URI). -If you have an account named 'youremailaddress@gmail.com' with a password of '1234' on GMail (which I happen to know uses the POP3 server of 'pop.gmail.com' and requires SSL), you would enter the following as your URI:: +If you have an account named ``youremailaddress@gmail.com`` with a password of ``1234`` on GMail (which I happen to know uses the POP3 server of 'pop.gmail.com' and requires SSL), you would enter the following as your URI:: pop3+ssl://youremailaddress%40gmail.com:1234@pop.gmail.com Local File-based Mailboxes -------------------------- -If you happen to want to consume a file-based mailbox like an Maildir, Mbox, Babyl, MH, or MMDF mailbox, you can use this too by entering the appropriate 'protocol' in the URI. If you had a maildir, for example, at @/var/mail/@, you would enter a URI like:: +If you happen to want to consume a file-based mailbox like an Maildir, Mbox, Babyl, MH, or MMDF mailbox, you can use this too by entering the appropriate 'protocol' in the URI. If you had a maildir, for example, at ``/var/mail/``, you would enter a URI like:: maildir:///var/mail From 6ec371f9e3c095d883287cc772b6ab7336d44dcd Mon Sep 17 00:00:00 2001 From: Adam Coddington Date: Wed, 18 Jul 2012 21:38:31 -0700 Subject: [PATCH 5/9] Bumping version number; removing extra transports.py file. --- django_mailbox/transports.py | 1 - setup.py | 2 +- 2 files changed, 1 insertion(+), 2 deletions(-) delete mode 100644 django_mailbox/transports.py diff --git a/django_mailbox/transports.py b/django_mailbox/transports.py deleted file mode 100644 index 8b13789..0000000 --- a/django_mailbox/transports.py +++ /dev/null @@ -1 +0,0 @@ - diff --git a/setup.py b/setup.py index 4c021bc..fd315ba 100644 --- a/setup.py +++ b/setup.py @@ -2,7 +2,7 @@ from setuptools import setup, find_packages setup( name='django_mailbox', - version='1.0.1', + version='1.0.2', url='http://bitbucket.org/latestrevision/django-mailbox/', description='Automatically import mail from POP3, IMAP, or a local mailbox into Django', author='Adam Coddington', From a51a33e049e43b0c1cace64e36b7afc2c093303a Mon Sep 17 00:00:00 2001 From: Adam Coddington Date: Wed, 18 Jul 2012 21:38:39 -0700 Subject: [PATCH 6/9] Added tag 1.0.2 for changeset 16d62ea16431 --- .hgtags | 1 + 1 file changed, 1 insertion(+) diff --git a/.hgtags b/.hgtags index 467f780..b998502 100755 --- a/.hgtags +++ b/.hgtags @@ -1,3 +1,4 @@ c4a9d1fff0bb66431a582cd93767422f377b33e6 0.2 c89f77b8f60331e81c1a6e48d7bf94ecc6897a65 1.0 9041cea2906864dc6b10d82e97239a9310d9c526 1.0.1 +16d62ea164318a451ae094f2a04ab5cbb5043faa 1.0.2 From 96455e272b02fa576413e8ded71622ed67165687 Mon Sep 17 00:00:00 2001 From: Adam Coddington Date: Wed, 18 Jul 2012 21:42:04 -0700 Subject: [PATCH 7/9] Removing pring message relic. --- django_mailbox/models.py | 1 - 1 file changed, 1 deletion(-) diff --git a/django_mailbox/models.py b/django_mailbox/models.py index 9c26d92..50ea5d8 100644 --- a/django_mailbox/models.py +++ b/django_mailbox/models.py @@ -92,7 +92,6 @@ class Mailbox(models.Model): new_mail = [] for message in connection.get_message(): msg = Message() - print msg msg.mailbox = self msg.subject = message['subject'][0:255] msg.message_id = message['message-id'][0:255] From 3d061d935722796e2c02f44b0028ed513957a851 Mon Sep 17 00:00:00 2001 From: Adam Coddington Date: Wed, 18 Jul 2012 21:44:58 -0700 Subject: [PATCH 8/9] Bumping version number. --- setup.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/setup.py b/setup.py index fd315ba..872faf1 100644 --- a/setup.py +++ b/setup.py @@ -2,7 +2,7 @@ from setuptools import setup, find_packages setup( name='django_mailbox', - version='1.0.2', + version='1.0.3', url='http://bitbucket.org/latestrevision/django-mailbox/', description='Automatically import mail from POP3, IMAP, or a local mailbox into Django', author='Adam Coddington', From 474ccb6efe90108c009057650baf1025842b58fb Mon Sep 17 00:00:00 2001 From: Adam Coddington Date: Wed, 18 Jul 2012 21:45:01 -0700 Subject: [PATCH 9/9] Added tag 1.0.3 for changeset 59f324257bc5 --- .hgtags | 1 + 1 file changed, 1 insertion(+) diff --git a/.hgtags b/.hgtags index b998502..17e0ac5 100755 --- a/.hgtags +++ b/.hgtags @@ -2,3 +2,4 @@ c4a9d1fff0bb66431a582cd93767422f377b33e6 0.2 c89f77b8f60331e81c1a6e48d7bf94ecc6897a65 1.0 9041cea2906864dc6b10d82e97239a9310d9c526 1.0.1 16d62ea164318a451ae094f2a04ab5cbb5043faa 1.0.2 +59f324257bc5d6b5decf08c965db901d6c01e2da 1.0.3