Added move utility method.

benedict/dicts/__init__.py

@@ -95,6 +95,9 @@ class benedict(IODict, KeypathDict, ParseDict):
         for d in dicts:
             dict_util.merge(self, d)
 
+    def move(self, key_src, key_dest):
+        self[key_dest] = self.pop(key_src)
+
     def remove(self, keys, *args):
         if isinstance(keys, string_types):
             keys = [keys]

tests/test_benedict.py

@@ -896,6 +896,39 @@ class BenedictTestCase(unittest.TestCase):
         }
         self.assertEqual(d, r)
 
+    def test_move(self):
+        d = {
+            'a': {
+                'x': 1,
+                'y': 1,
+            },
+            'b': {
+                'x': 2,
+                'y': 2,
+            },
+            'c': {
+                'x': 3,
+                'y': 3,
+            },
+        }
+        b = benedict(d)
+        b.move('a', 'c.z')
+        r = {
+            'b': {
+                'x': 2,
+                'y': 2,
+            },
+            'c': {
+                'x': 3,
+                'y': 3,
+                'z': {
+                    'x': 1,
+                    'y': 1,
+                },
+            },
+        }
+        self.assertEqual(b, r)
+
     def test_pop(self):
         d = {
             'a': 1,