v0.2.2 - Exceptions and folder reopening

Summary

Previously, users would hit specific JavaMail exceptions ; those have been abstracted behind Kourrier exceptions.
Moreover, one can now reopen a folder without any issue.

Changelog

• Abstracted AuthenticationFailedException and MailConnectException
  behind KourrierAuthenticationException and KourrierConnectionException respectively.
• Fixed a bug where one couldn't reopen a closed folder with a keep-alive.

Changelog since last major version

• Optimized message query
• Properly caught InterruptedException when closing a listened folder
• Update to Kotlin 1.5.31
• One can now set a keepAlive Boolean to true when opening a folder, to make sure the connection stays alive until explicitly closed.

Integration

To use it, you just need to import the attached kourrier-0.2.2.jar (optionally along with kourrier-0.2.2-sources.jar and kourrier-0.2.2-javadoc.jar if you want to be able to read the source and documentation code directly) OR to use your favorite dependency manager @com.notkamui.libs:kourrier:0.2.2

Usage

For further information on usage, please read README and Wiki.

Future plans

• SMTP connection

v0.2.1 - Improved internals

Summary

Gotta go fast, mmm'y'know

Changelog

• Optimized message query
• Properly caught InterruptedException when closing a listened folder
• Update to Kotlin 1.5.31

Changelog since last major version

• One can now set a keepAlive Boolean to true when opening a folder, to make sure the connection stays alive until explicitly closed.

Integration

To use it, you just need to import the attached kourrier-0.2.1.jar (optionally along with kourrier-0.2.1-sources.jar and kourrier-0.2.1-javadoc.jar if you want to be able to read the source and documentation code directly) OR to use your favorite dependency manager @com.notkamui.libs:kourrier:0.2.1

Usage

For further information on usage, please read README and Wiki.

Future plans

• SMTP connection

v0.2.0 - Folder keep-alive

Summary

In this new version, one can explicitly ask for a folder to be kept alive forever until closed manually. It's as simple as that !

Changelog

• One can now set a keepAlive Boolean to true when opening a folder, to make sure the connection stays alive until explicitly closed.

Integration

To use it, you just need to import the attached kourrier-0.2.0.jar (optionally along with kourrier-0.2.0-sources.jar and kourrier-0.2.0-javadoc.jar if you want to be able to read the source and documentation code directly) OR to use your favorite dependency manager @com.notkamui.libs:kourrier:0.2.0

Usage

For further information on usage, please read README and Wiki.

Future plans

• SMTP connection

v0.1.0 - IMAP engine rework and Folder listeners

Summary

Previously, Kourrier handled the closing of sessions and folders automatically. While it sounded good on paper, this made it less controllable by the user for not much. The user now has to manually close opened sessions and folders after using them.

On top of that, this allowed for a coherent folder listener engine. One can add a listener to a folder when opening it, to listen to what happens inside it !

Changelog

• Reworked the core IMAP engine: user now has to manually close sessions and folders. Kourrier.imap and KourrierIMAPSession.folder now return respectively the created KourrierIMAPSession and KourrierFolder than can (should) be closed.
• Added the ability to define a KourrierFolderListener to pass it to KourrierIMAPSession.folder when opening a folder, to listen to the messages. You can set a callback for 4 (four) events: on message received, on message removed (expunged != deleted), on message flags changed, and on message envelope changed.
• Updated documentation.
• Added the ability to reopen closed sessions and folders.
• Added new exceptions: KourrierSessionStateException and KourrierFolderStateException that extend IllegalStateException, and are thrown in case you're trying to do actions on an open/closed session/folder that you can't (e.g. closing an already closed session).

Changelog since last stable version

• Fixed search DSL where subject term was named "student"
• Able to connect to an IMAP server with credentials
• Able to open a IMAPFolder thanks to a DSL
• Able to use the search engine to fetch mails in a folder with a DSL
• Able to use the sort engine to fetch mails in a folder with order with a DSL

Integration

To use it, you just need to import the attached kourrier-0.1.0.jar (optionally along with kourrier-0.1.0-sources.jar and kourrier-0.1.0-javadoc.jar if you want to be able to read the source and documentation code directly) OR to use your favorite dependency manager @com.notkamui.libs:kourrier:0.1.0

Usage

For further information on usage, please read README and Wiki.

Future plans

• Keep alive
• SMTP connection

v0.0.2 - IMAP - Hotfix

Summary

This first release of Kourrier allows any user to connect to an IMAP session (providing correct credentials and server information).

When an IMAP connection is opened, one can open a folder and fetch its messages using the complete search engine and/or the sort engine (with a practical DSL !).

Changelog

• Fixed search DSL where subject term was name "student"

Changelog since last stable version

• Able to connect to an IMAP server with credentials
• Able to open a IMAPFolder thanks to a DSL
• Able to use the search engine to fetch mails in a folder with a DSL
• Able to use the sort engine to fetch mails in a folder with order with a DSL

Integration

To use it, you just need to import the attached kourrier-0.0.2.jar (optionally along with kourrier-0.0.2-sources.jar and kourrier-0.0.2-javadoc.jar if you want to be able to read the source and documentation code directly) OR to use your favorite dependency manager @com.notkamui.libs:kourrier:0.0.2

Usage

For further information on usage, please read README and Wiki.

Future plans

• Connection listener to call a callback function on message received
• Keep alive
• SMTP connection

v0.0.1 - First release: IMAP session

Summary

This first release of Kourrier allows any user to connect to an IMAP session (providing correct credentials and server information).

When an IMAP connection is opened, one can open a folder and fetch its messages using the complete search engine and/or the sort engine (with a practical DSL !).

Changelog

• Able to connect to an IMAP server with credentials
• Able to open a IMAPFolder thanks to a DSL
• Able to use the search engine to fetch mails in a folder with a DSL
• Able to use the sort engine to fetch mails in a folder with order with a DSL

Integration

To use it, you just need to import the attached kourrier-0.0.1.jar (optionally along with kourrier-0.0.1-sources.jar and kourrier-0.0.1-javadoc.jar if you want to be able to read the source and documentation code directly) OR to use your favorite dependency manager @com.notkamui.libs:kourrier:0.0.1

Usage

For further information on usage, please read README and Wiki.

Future plans

• Connection listener to call a callback function on message received
• Keep alive
• SMTP connection