Connector: Add IMAP source adapter

[amotl]

About

Connect to IMAP servers to read mailboxes.

Backlog

• Read from mailboxes other than the default INBOX
• Connect with other flavours than IMAPS (port 993) only
• Documentation
• More software tests

References

• Reading email #293

[coderabbitai]

Important

Review skipped

Auto reviews are limited based on label configuration.

🏷️ Required labels (at least one) (1)

• coderabbit-review

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 941ffee0-c08a-4eb5-a4f8-d879afb07b87

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[read-the-docs-community]

Documentation build overview

📚 omniload | 🛠️ Build #34152604 | 📁 Comparing 197014e against latest (fa6a032)

  🔍 Preview build  

1 file changed

± supported-sources/google-analytics.html

[codecov]

Codecov Report

❌ Patch coverage is 70.46632% with 57 lines in your changes missing coverage. Please review.
✅ Project coverage is 61.81%. Comparing base (4b5bed5) to head (197014e).
⚠️ Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
src/omniload/source/imap/helpers.py	64.36%	31 Missing ⚠️
src/omniload/source/imap/adapter.py	72.00%	21 Missing ⚠️
src/omniload/source/imap/api.py	81.48%	5 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #295      +/-   ##
==========================================
+ Coverage   61.66%   61.81%   +0.14%     
==========================================
  Files         235      239       +4     
  Lines       11408    11601     +193     
==========================================
+ Hits         7035     7171     +136     
- Misses       4373     4430      +57     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.