Permitting strings for some inputs for convenience.

Author: fabiankessler

src/org/nameapi/ontology/input/context/ContextBuilder.php

@@ -20,10 +20,14 @@ function place($place) {
     }
 
     /**
-     * @param Priority $priority
+     * @param $priority
+     *        either an instance of Priority, or a string in upper case.
      * @return ContextBuilder
      */
     function priority($priority) {
+        if (is_string($priority)) {
+            $priority = new Priority($priority);
+        }
         $this->priority = $priority;
         return $this;
     }

src/org/nameapi/ontology/input/entities/person/NaturalInputPersonBuilder.php

@@ -82,10 +82,14 @@ public function name(InputPersonName $personName) {
     }
 
     /**
-     * @param StoragePersonGender $gender
+     * @param $gender
+     *        either an instance of StoragePersonGender, or a string in upper case like 'MALE'.
      * @return NaturalInputPersonBuilder
      */
     public function gender($gender) {
+        if (is_string($gender)) {
+            $gender = new StoragePersonGender($gender);
+        }
         $this->gender = $gender;
         return $this;
     }

tests/functional/PersonNameParserServiceTest.php

@@ -32,7 +32,7 @@ public function testParse() {
             ->name(InputPersonName::westernBuilder()
                 ->fullname( "John Doe" )
                 ->build())
-            ->gender(new org\nameapi\ontology\input\entities\person\gender\StoragePersonGender("FEMALE"))
+            ->gender("FEMALE")
             ->build();
         $parseResult = $personNameParser->parse($inputPerson);