io-msgraph 0.9.0

Microsoft Graph API client library for Rust
Documentation

I/O Microsoft Graph Documentation Matrix Mastodon Sponsor

Microsoft Graph API client library for Rust

This library is composed of 3 feature-gated layers:

  • Low-level I/O-free coroutines: no_std-compatible state machines containing the whole Microsoft Graph REST logic, usable anywhere
  • Mid-level light client: a standard, blocking client wrapping a stream you opened yourself
  • High-level full client: the light client plus TCP connections and TLS negotiations handled for you

Table of contents

Features

  • Mail: folders, messages and attachments, raw MIME downloads, drafts and sending.
  • Contacts, calendars and To Do: contact folders, calendars and events, task lists and their tasks.
  • Incremental sync: delta queries return only what changed since the last round.
  • Batching: up to 20 requests in one HTTP call.
  • iCalendar and vCard (ical, vcard features): events and tasks as iCalendar, contacts as vCard, and back.
  • Full client: TLS via Rustls (rustls-ring default, rustls-aws) or Native TLS (native-tls).

[!TIP] I/O Microsoft Graph is written in Rust and uses cargo features to gate the client layers. The default feature set is declared in Cargo.toml or on docs.rs.

API coverage

Microsoft Graph is a single API spanning many domains; io-msgraph covers it incrementally, mirroring the Microsoft Graph v1.0 reference. Every operation below is an I/O-free coroutine.

Resource Operations
$batch send up to 20 requests in one HTTP call
users get the signed-in user profile; sendMail action (JSON and MIME form)
users.mailFolders list, get, create, update, delete, move, copy, list child folders
users.messages list, get, get raw MIME, create draft from JSON or MIME, update, delete, move, copy, send, track changes with delta
users.messages.attachments list, create, get raw content, delete
users.contactFolders list, get, create, update, delete, list child folders
users.contacts list, get, create, update, delete, track changes with delta
users.calendars list, get, create, update, delete
users.events list, get, create, update, delete, list instances, calendar view, track changes with delta
users.todo.lists list, get, create, update, delete, track changes with delta
users.todo.lists.tasks list, get, create, update, delete, track changes with delta, list checklist items

Usage

See documentation at docs.rs.

Examples

See complete examples at ./tests.

Have also a look at real-world projects built on top of this library:

License

This project is licensed under either of:

Social

Sponsoring

nlnet

Special thanks to the NLnet foundation and the European Commission that have been financially supporting the project for years:

This program is part of Pimalaya, free software funded entirely by grants and donations. If you find it useful, consider sponsoring its development:

GitHub Ko-fi Buy Me a Coffee Liberapay thanks.dev PayPal