/**
  * merge data from a container, using dot.notation.support to identify
  * the data to remove
  *
  * @param  mixed $container
  *         the container we want to remove from
  * @param  string $path
  *         the dot.notation.support path to the data to remove
  * @return void
  */
 public static function from(&$container, $path)
 {
     // defensive programming!
     RequireAnyOneOf::check([new IsAssignable(), new IsIndexable()], [$container], E4xx_UnsupportedType::class);
     RequireDotNotationPath::check($path);
     // find the point where we want to remove the data from
     list($firstPart, $finalPart) = self::splitPathInTwo($path);
     $leaf =& DescendDotNotationPath::into($container, $firstPart);
     // remove it
     RemoveProperty::from($leaf, $finalPart);
 }
 /**
  * @covers ::check
  * @dataProvider provideNonStrings
  * @expectedException GanbaroDigital\DataContainers\Exceptions\E4xx_UnsupportedType
  */
 public function testRejectsNonStringsWhenCalledStatically($item)
 {
     // ----------------------------------------------------------------
     // setup your test
     // ----------------------------------------------------------------
     // perform the change
     RequireDotNotationPath::check($item);
 }
 /**
  * merge their data into our object, using dot.notation.support to
  * find the point where the merge starts
  *
  * @param  object $obj
  *         the object that we want to merge into
  * @param  string $path
  *         the dot.notation.support path to where the merge should start
  * @param  mixed $value
  *         the data that we want to merge from
  * @param  array|callable|string|null
  *         if $path goes beyond what exists in $ours, how do we want to
  *         extend $ours?
  * @return void
  */
 public static function intoObject($obj, $path, $value, $extendingItem = null)
 {
     // robustness!
     RequireAssignable::check($obj, E4xx_UnsupportedType::class);
     RequireDotNotationPath::check($path);
     // find the point where we want to merge
     list($firstPart, $finalPart) = self::splitPathInTwo($path);
     if ($firstPart !== null) {
         $leaf =& DescendDotNotationPath::intoObject($obj, $firstPart, $extendingItem);
     } else {
         $leaf = $obj;
     }
     // merge it
     MergeIntoProperty::of($leaf, $finalPart, $value);
 }