#![warn(rust_2018_idioms)] #![cfg(all(feature = "rt", tokio_unstable))] use tokio::sync::oneshot; use tokio::time::Duration; use tokio_util::task::JoinMap; use futures::future::FutureExt; fn rt() -> tokio::runtime::Runtime { tokio::runtime::Builder::new_current_thread() .build() .unwrap() } #[tokio::test(start_paused = true)] async fn test_with_sleep() { let mut map = JoinMap::new(); for i in 0..10 { map.spawn(i, async move { i }); assert_eq!(map.len(), 1 + i); } map.detach_all(); assert_eq!(map.len(), 0); assert!(matches!(map.join_next().await, None)); for i in 0..10 { map.spawn(i, async move { tokio::time::sleep(Duration::from_secs(i as u64)).await; i }); assert_eq!(map.len(), 1 + i); } let mut seen = [false; 10]; while let Some((k, res)) = map.join_next().await { seen[k] = true; assert_eq!(res.expect("task should have completed successfully"), k); } for was_seen in &seen { assert!(was_seen); } assert!(matches!(map.join_next().await, None)); // Do it again. for i in 0..10 { map.spawn(i, async move { tokio::time::sleep(Duration::from_secs(i as u64)).await; i }); } let mut seen = [false; 10]; while let Some((k, res)) = map.join_next().await { seen[k] = true; assert_eq!(res.expect("task should have completed successfully"), k); } for was_seen in &seen { assert!(was_seen); } assert!(matches!(map.join_next().await, None)); } #[tokio::test] async fn test_abort_on_drop() { let mut map = JoinMap::new(); let mut recvs = Vec::new(); for i in 0..16 { let (send, recv) = oneshot::channel::<()>(); recvs.push(recv); map.spawn(i, async { // This task will never complete on its own. futures::future::pending::<()>().await; drop(send); }); } drop(map); for recv in recvs { // The task is aborted soon and we will receive an error. assert!(recv.await.is_err()); } } #[tokio::test] async fn alternating() { let mut map = JoinMap::new(); assert_eq!(map.len(), 0); map.spawn(1, async {}); assert_eq!(map.len(), 1); map.spawn(2, async {}); assert_eq!(map.len(), 2); for i in 0..16 { let (_, res) = map.join_next().await.unwrap(); assert!(res.is_ok()); assert_eq!(map.len(), 1); map.spawn(i, async {}); assert_eq!(map.len(), 2); } } #[tokio::test(start_paused = true)] async fn abort_by_key() { let mut map = JoinMap::new(); let mut num_canceled = 0; let mut num_completed = 0; for i in 0..16 { map.spawn(i, async move { tokio::time::sleep(Duration::from_secs(i as u64)).await; }); } for i in 0..16 { if i % 2 != 0 { // abort odd-numbered tasks. map.abort(&i); } } while let Some((key, res)) = map.join_next().await { match res { Ok(()) => { num_completed += 1; assert_eq!(key % 2, 0); assert!(!map.contains_key(&key)); } Err(e) => { num_canceled += 1; assert!(e.is_cancelled()); assert_ne!(key % 2, 0); assert!(!map.contains_key(&key)); } } } assert_eq!(num_canceled, 8); assert_eq!(num_completed, 8); } #[tokio::test(start_paused = true)] async fn abort_by_predicate() { let mut map = JoinMap::new(); let mut num_canceled = 0; let mut num_completed = 0; for i in 0..16 { map.spawn(i, async move { tokio::time::sleep(Duration::from_secs(i as u64)).await; }); } // abort odd-numbered tasks. map.abort_matching(|key| key % 2 != 0); while let Some((key, res)) = map.join_next().await { match res { Ok(()) => { num_completed += 1; assert_eq!(key % 2, 0); assert!(!map.contains_key(&key)); } Err(e) => { num_canceled += 1; assert!(e.is_cancelled()); assert_ne!(key % 2, 0); assert!(!map.contains_key(&key)); } } } assert_eq!(num_canceled, 8); assert_eq!(num_completed, 8); } #[test] fn runtime_gone() { let mut map = JoinMap::new(); { let rt = rt(); map.spawn_on("key", async { 1 }, rt.handle()); drop(rt); } let (key, res) = rt().block_on(map.join_next()).unwrap(); assert_eq!(key, "key"); assert!(res.unwrap_err().is_cancelled()); } // This ensures that `join_next` works correctly when the coop budget is // exhausted. #[tokio::test(flavor = "current_thread")] async fn join_map_coop() { // Large enough to trigger coop. const TASK_NUM: u32 = 1000; static SEM: tokio::sync::Semaphore = tokio::sync::Semaphore::const_new(0); let mut map = JoinMap::new(); for i in 0..TASK_NUM { map.spawn(i, async move { SEM.add_permits(1); i }); } // Wait for all tasks to complete. // // Since this is a `current_thread` runtime, there's no race condition // between the last permit being added and the task completing. let _ = SEM.acquire_many(TASK_NUM).await.unwrap(); let mut count = 0; let mut coop_count = 0; loop { match map.join_next().now_or_never() { Some(Some((key, Ok(i)))) => assert_eq!(key, i), Some(Some((key, Err(err)))) => panic!("failed[{}]: {}", key, err), None => { coop_count += 1; tokio::task::yield_now().await; continue; } Some(None) => break, } count += 1; } assert!(coop_count >= 1); assert_eq!(count, TASK_NUM); } #[tokio::test(start_paused = true)] async fn abort_all() { let mut map: JoinMap = JoinMap::new(); for i in 0..5 { map.spawn(i, futures::future::pending()); } for i in 5..10 { map.spawn(i, async { tokio::time::sleep(Duration::from_secs(1)).await; }); } // The join map will now have 5 pending tasks and 5 ready tasks. tokio::time::sleep(Duration::from_secs(2)).await; map.abort_all(); assert_eq!(map.len(), 10); let mut count = 0; let mut seen = [false; 10]; while let Some((k, res)) = map.join_next().await { seen[k] = true; if let Err(err) = res { assert!(err.is_cancelled()); } count += 1; } assert_eq!(count, 10); assert_eq!(map.len(), 0); for was_seen in &seen { assert!(was_seen); } }