rename method for registering with derived root span (#30)

Author: BugenZhao

src/lib.rs

@@ -88,7 +88,7 @@ pub use registry::{AnyKey, Config, ConfigBuilder, ConfigBuilderError, Key, Regis
 pub use root::TreeRoot;
 pub use span::{Span, SpanExt};
 #[cfg(feature = "tokio")]
-pub use spawn::{spawn, spawn_anonymous, spawn_root};
+pub use spawn::{spawn, spawn_anonymous, spawn_derived_root};
 
 #[doc(hidden)]
 pub mod __private {

src/registry.rs

@@ -23,7 +23,7 @@ use weak_table::WeakValueHashMap;
 
 use crate::context::{ContextId, Tree, TreeContext};
 use crate::obj_utils::{DynEq, DynHash};
-use crate::{Span, TreeRoot};
+use crate::{span, Span, TreeRoot};
 
 /// Configuration for an await-tree registry, which affects the behavior of all await-trees in the
 /// registry.
@@ -59,6 +59,12 @@ pub trait ToRootSpan {
     fn to_root_span(&self) -> Span;
 }
 
+impl<T: Display> ToRootSpan for T {
+    fn to_root_span(&self) -> Span {
+        span!("{self}")
+    }
+}
+
 /// Key type for anonymous await-trees.
 #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
 struct AnonymousKey(ContextId);
@@ -232,7 +238,7 @@ impl Registry {
     ///
     /// This is a convenience method for `self.register(key, key.to_root_span())`. See
     /// [`Registry::register`] for more details.
-    pub fn register_root(&self, key: impl Key + ToRootSpan) -> TreeRoot {
+    pub fn register_derived_root(&self, key: impl Key + ToRootSpan) -> TreeRoot {
         let root_span = key.to_root_span();
         self.register(key, root_span)
     }

src/spawn.rs

@@ -45,7 +45,11 @@ impl Registry {
     /// The spawned task will be registered in the this registry.
     ///
     /// This is a convenience method for `self.spawn(key, key.to_root_span(), future)`.
-    pub fn spawn_root<T>(&self, key: impl Key + ToRootSpan, future: T) -> JoinHandle<T::Output>
+    pub fn spawn_derived_root<T>(
+        &self,
+        key: impl Key + ToRootSpan,
+        future: T,
+    ) -> JoinHandle<T::Output>
     where
         T: Future + Send + 'static,
         T::Output: Send + 'static,
@@ -94,7 +98,7 @@ where
 ///
 /// This is a convenience function for `spawn(key, key.to_root_span(), future)`. See [`spawn`] for
 /// more details.
-pub fn spawn_root<T>(key: impl Key + ToRootSpan, future: T) -> JoinHandle<T::Output>
+pub fn spawn_derived_root<T>(key: impl Key + ToRootSpan, future: T) -> JoinHandle<T::Output>
 where
     T: Future + Send + 'static,
     T::Output: Send + 'static,