mtp-rs 0.30.0

//! High-level MTP (Media Transfer Protocol) API for Android devices and media players.
//!
//! This module provides a convenient, batteries-included API for common file transfer
//! operations. Use this module when:
//!
//! - Working with Android phones and tablets
//! - You want simple file listing, upload, and download
//! - You need storage enumeration and device info
//! - You don't need camera-specific features (capture, live view, etc.)
//!
//! ## When to use `ptp` instead
//!
//! Use the lower-level [`crate::ptp`] module when you need:
//! - Direct control over PTP operations and transactions
//! - Camera-specific functionality
//! - Custom protocol extensions
//! - Access to raw response codes and error details
//!
//! ## Quick example
//!
//! ```rust,no_run
//! use mtp_rs::mtp::MtpDevice;
//!
//! # async fn example() -> Result<(), mtp_rs::Error> {
//! let device = MtpDevice::open_first().await?;
//! for storage in device.storages().await? {
//!     for obj in storage.list_objects(None).await? {
//!         println!("{}", obj.filename);
//!     }
//! }
//! # Ok(())
//! # }
//! ```

pub(crate) mod backend;
mod device;
mod error;
mod event;
mod hotplug;
mod object;
mod storage;
mod stream;
mod types;

pub use backend::{Backend, ByteRange};
pub use device::{MtpDevice, MtpDeviceBuilder, MtpDeviceInfo};
pub use error::{Error, UploadError};
pub use event::DeviceEvent;
pub use hotplug::{
    watch_devices, DeviceWatch, DeviceWatchBuilder, HotplugEvent, DEFAULT_SETTLE_DELAY,
};
// Backend-neutral high-level types (see types.rs). These are the default vocabulary for `mtp::`.
pub use object::NewObjectInfo;
pub use storage::{ListingItem, ObjectCollection, ObjectListing, SkippedObject, Storage};
pub use stream::{
    FileDownload, Progress, WindowedDownload, DEFAULT_CANCEL_TIMEOUT, DEFAULT_DOWNLOAD_WINDOW,
};
pub use types::{
    Capabilities, DateTime, DeviceInfo, FilesystemType, ObjectFormat, ObjectHandle, ObjectInfo,
    StorageId, StorageInfo, StorageType,
};