Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/MailCore/mailcore2
MailCore 2 provide a simple and asynchronous API to work with e-mail protocols IMAP, POP and SMTP. The API has been redesigned from ground up.
https://github.com/MailCore/mailcore2
Last synced: about 1 month ago
JSON representation
MailCore 2 provide a simple and asynchronous API to work with e-mail protocols IMAP, POP and SMTP. The API has been redesigned from ground up.
- Host: GitHub
- URL: https://github.com/MailCore/mailcore2
- Owner: MailCore
- License: other
- Created: 2013-01-09T19:35:49.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2023-02-13T11:47:32.000Z (over 1 year ago)
- Last Synced: 2024-04-24T20:02:32.732Z (5 months ago)
- Language: C++
- Homepage:
- Size: 37.9 MB
- Stars: 2,568
- Watchers: 97
- Forks: 616
- Open Issues: 225
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - Mail Core 2 - MailCore 2 provide a simple and asynchronous API to work with e-mail protocols IMAP, POP and SMTP. (Networking / Email)
- awesome-ios-star - Mail Core 2 - MailCore 2 provide a simple and asynchronous API to work with e-mail protocols IMAP, POP and SMTP. (Networking / Email)
- awesome-starred - MailCore/mailcore2 - MailCore 2 provide a simple and asynchronous API to work with e-mail protocols IMAP, POP and SMTP. The API has been redesigned from ground up. (others)
README
## MailCore 2: Introduction ##
MailCore 2 provides a simple and asynchronous Objective-C API to work with the e-mail protocols **IMAP**, **POP** and **SMTP**. The API has been redesigned from the ground up. It features:
- **POP**, **IMAP** and **SMTP** support
- **[RFC822](http://www.ietf.org/rfc/rfc0822.txt)** parser and generator
- **Asynchronous** APIs
- **HTML** rendering of messages
- **iOS** and **Mac** support
[](https://travis-ci.org/MailCore/mailcore2)
## Installation ##
### Build for iOS/OSX ###
Read [instructions for iOS/OSX](https://github.com/MailCore/mailcore2/blob/master/build-mac/README.md).
### Build for Android ###
Read [instructions for Android](https://github.com/MailCore/mailcore2/blob/master/build-android/README.md).
### Build for Windows ###
Read [instructions for Windows](https://github.com/MailCore/mailcore2/blob/master/build-windows/README.md).
### Build for Linux ###
Read [instructions for Linux](https://github.com/MailCore/mailcore2/blob/master/build-linux/README.md).
## Basic IMAP Usage ##
Using MailCore 2 is just a little more complex conceptually than the original MailCore. All fetch requests in MailCore 2 are made asynchronously through a queue. What does this mean? Well, let's take a look at a simple example:
```swift
let session = MCOIMAPSession()
session.hostname = "imap.gmail.com"
session.port = 993
session.username = "[email protected]"
session.password = "123456"
session.connectionType = .TLS
let folder = "INBOX"
let uids = MCOIndexSet(range: MCORange(location: 1, length: UInt64.max))
if let fetchOperation = session.fetchMessagesOperation(withFolder: folder, requestKind: .headers, uids: uids) {
fetchOperation.start { error, fetchedMessages, vanishedMessages in
// We've finished downloading the messages!
// Let's check if there was an error
if let error = error {
print("Error downloading message headers: \(error.localizedDescription)")
}
// And, let's print out the messages:
print("The post man delivereth: \(fetchedMessages.debugDescription)")
}
}
```
(You can also read an [Objective-C Version](https://github.com/MailCore/mailcore2/wiki/IMAP-Examples))
In this sample, we retrieved and printed a list of email headers from an IMAP server. In order to execute the fetch, we request an asynchronous operation object from the `MCOIMAPSession` instance with our parameters (more on this later). This operation object is able to initiate a connection to Gmail when we call the `start` method. Now here's where things get a little tricky. We call the `start` function with a block, which is executed on the main thread when the fetch operation completes. The actual fetching from IMAP is done on a **background thread**, leaving your UI and other processing **free to use the main thread**.
## Documentation ##
* Class documentation [Obj-C](http://libmailcore.com/api/objc/index.html) / [Java](http://libmailcore.com/api/java/index.html)
* [Wiki](https://github.com/MailCore/mailcore2/wiki)
## License ##
MailCore 2 is BSD-Licensed.
## MailCore Supporters ##
[
](https://triage.cc?ref=mailcore)