Add move_from/move_bundle_from

Author: hlbarber

crates/bevy_ecs/src/system/commands/mod.rs

@@ -512,7 +512,7 @@ impl<'w, 's, 'a> EntityCommands<'w, 's, 'a> {
         self
     }
 
-    /// Moves a [`Bundle`] from the entity to another.
+    /// Moves a [`Bundle`] to a target entity.
     ///
     /// # Example
     ///
@@ -552,7 +552,7 @@ impl<'w, 's, 'a> EntityCommands<'w, 's, 'a> {
         self
     }
 
-    /// Moves a [`Component`] from the entity to another.
+    /// Moves a [`Component`] to a target entity.
     ///
     /// # Example
     ///
@@ -575,6 +575,32 @@ impl<'w, 's, 'a> EntityCommands<'w, 's, 'a> {
         self.move_bundle_to::<(C,)>(target)
     }
 
+    /// Moves a [`Bundle`] from a source entity.
+    ///
+    /// See [`move_bundle_to`](EntityCommands::move_bundle_to).
+    pub fn move_bundle_from<T: Bundle>(&mut self, source: Entity) -> &mut Self {
+        assert!(
+            self.commands.entities.contains(self.entity),
+            "Attempting to move bundle {:?} from entity {:?} to entity {:?}, which doesn't exist.",
+            std::any::type_name::<T>(),
+            source,
+            self.entity
+        );
+        self.commands.add(MoveBundleTo::<T> {
+            source,
+            target: self.entity,
+            _bundle: PhantomData,
+        });
+        self
+    }
+
+    /// Moves a [`Component`] from a source entity.
+    ///
+    /// See [`move_to`](EntityCommands::move_to).
+    pub fn move_from<C: Component>(&mut self, source: Entity) -> &mut Self {
+        self.move_bundle_from::<(C,)>(source)
+    }
+
     /// Despawns the entity.
     ///
     /// See [`World::despawn`] for more details.