Support for required and partial (#14)

* partial and required support

Author: shmax

README.md

@@ -117,6 +117,36 @@ If the value is valid, return `0`, otherwise `1`.
 ])
 ```
 
+### The `required` property
+You can mark any field as `required`, and if the value is not provided, then an automatic validation will happen for you (thus removing the need for you to weaken your validation callback with `null` types). You can set it to `true`, or you can provide an error array similar to the one returned by your validate callback:
+
+```php
+//...
+'updateThing' => new ValidatedFieldDefinition([
+  'type' => Types::thing(),
+  'args' => [
+    'foo' => [
+      'required' => true, // if not provided, then an error of the form [1, 'foo is required'] will be returned.
+      'validate' => function(string $foo) {
+        if(Foo::find($foo)) {
+          return 0;
+        }
+        return 1;
+      }
+    ],
+    'bar' => [
+      'required' => [1, 'Oh, where is the bar?!'],
+      'validate' => function(string $bar) {
+        if(Bar::find($bar)) {
+          return 0;
+        }
+        return 1;
+      }
+    ]
+  ]	  
+])
+```
+
 If you want to return an error message, return an array with the message in the second bucket:
 ```php
 //...

examples/01-basic-scalar-validation/README.md

@@ -1,38 +1,38 @@
-# Simple scalar validation
-The simplest possible type of user input validation. Mutation expects an `authorId` arg, and will respond with a nicely formatted error code and message if an author by that id doesn't exist.
-
-### Run locally
-```
-php -S localhost:8000 ./index.php
-```
-
-### Install ChromeiQL plug-in for Chrome
-1. Install from [here](https://chrome.google.com/webstore/detail/chromeiql/fkkiamalmpiidkljmicmjfbieiclmeij?hl=en)
-2. Enter "http://localhost:8000" in the text field at the top and press the "Set Endpoint" button
-3. Be sure to inspect the "Docs" flyout to get familiar with the dynamically-generated types
-
-### Try mutation with valid input
-```
-mutation {
-  deleteAuthor(id: 1) {
-    valid
-    result
-  }
-}
-```
-
-### Try mutation with invalid input
-```
-mutation {
-  deleteAuthor(id: 3) {
-    valid
-    result
-    suberrors {
-      id {
-        code
-        msg
-      }
-    }
-  }
-}
+# Simple scalar validation
+The simplest possible type of user input validation. Mutation expects an `authorId` arg, and will respond with a nicely formatted error code and message if an author by that id doesn't exist.
+
+### Run locally
+```
+php -S localhost:8000 ./index.php
+```
+
+### Install ChromeiQL plug-in for Chrome
+1. Install from [here](https://chrome.google.com/webstore/detail/chromeiql/fkkiamalmpiidkljmicmjfbieiclmeij?hl=en)
+2. Enter "http://localhost:8000" in the text field at the top and press the "Set Endpoint" button
+3. Be sure to inspect the "Docs" flyout to get familiar with the dynamically-generated types
+
+### Try mutation with valid input
+```
+mutation {
+  deleteAuthor(id: 1) {
+    valid
+    result
+  }
+}
+```
+
+### Try mutation with invalid input
+```
+mutation {
+  deleteAuthor(id: 3) {
+    valid
+    result
+    suberrors {
+      id {
+        code
+        msg
+      }
+    }
+  }
+}
 ```

examples/02-custom-error-codes/README.md

@@ -1,44 +1,44 @@
-# Simple scalar validation
-If you supply an `errorCodes` property on your `fields` or `args` definitions, then a custom, unique error code type will be created.
-
-### Run locally
-```
-php -S localhost:8000 ./index.php
-```
-
-### Install ChromeiQL plug-in for Chrome
-1. Install from [here](https://chrome.google.com/webstore/detail/chromeiql/fkkiamalmpiidkljmicmjfbieiclmeij?hl=en)
-2. Enter "http://localhost:8000" in the text field at the top and press the "Set Endpoint" button
-3. Be sure to inspect the "Docs" flyout to get familiar with the dynamically-generated types
-
-### Try mutation with valid input
-```
-mutation {
-  deleteAuthor(id: 1) {
-    valid
-    result
-    suberrors {
-      id {
-        code
-        msg
-      }
-    }
-  }
-}
-```
-
-### Try mutation with invalid input
-```
-mutation {
-  deleteAuthor(id: 3) {
-    valid
-    result
-    suberrors {
-      id {
-        code
-        msg
-      }
-    }
-  }
-}
+# Simple scalar validation
+If you supply an `errorCodes` property on your `fields` or `args` definitions, then a custom, unique error code type will be created.
+
+### Run locally
+```
+php -S localhost:8000 ./index.php
+```
+
+### Install ChromeiQL plug-in for Chrome
+1. Install from [here](https://chrome.google.com/webstore/detail/chromeiql/fkkiamalmpiidkljmicmjfbieiclmeij?hl=en)
+2. Enter "http://localhost:8000" in the text field at the top and press the "Set Endpoint" button
+3. Be sure to inspect the "Docs" flyout to get familiar with the dynamically-generated types
+
+### Try mutation with valid input
+```
+mutation {
+  deleteAuthor(id: 1) {
+    valid
+    result
+    suberrors {
+      id {
+        code
+        msg
+      }
+    }
+  }
+}
+```
+
+### Try mutation with invalid input
+```
+mutation {
+  deleteAuthor(id: 3) {
+    valid
+    result
+    suberrors {
+      id {
+        code
+        msg
+      }
+    }
+  }
+}
 ```

examples/03-input-object-validation/README.md

@@ -1,82 +1,82 @@
-# Validation of InputObjects (or Objects) 
-
-You can add `validate` properties to the fields of nested Objects or InputObjects (and those fields can themselves be of complex types with their own fields, and so on). This library will sniff them out and recursively build up a result type with a similarly nested structure.
-
-
-### Run locally
-```
-php -S localhost:8000 ./index.php
-```
-
-### Install ChromeiQL plug-in for Chrome
-1. Install from [here](https://chrome.google.com/webstore/detail/chromeiql/fkkiamalmpiidkljmicmjfbieiclmeij?hl=en)
-2. Enter "http://localhost:8000" in the text field at the top and press the "Set Endpoint" button
-3. Be sure to inspect the "Docs" flyout to get familiar with the dynamically-generated types
-
-### Try mutation with valid input
-```
-mutation {
-	updateAuthor(
-    authorId: 1
-  	attributes: {
-      name: "Stephen King",
-      age: 47
-    }
-  ) {
-		result {
-      id
-      name
-    }
-    suberrors {
-      attributes {
-        code
-        msg
-        suberrors {
-          age {
-            code
-            msg
-          }
-          name {
-            code
-            msg
-          }
-        }
-      }
-    }
-  }
-}
-```
-
-### Try mutation with invalid input
-```
-mutation {
-	updateAuthor(
-    authorId: 1
-  	attributes: {
-      name: "Edward John Moreton Drax Plunkett, 18th Baron of Dunsany",
-      age: -3
-    }
-  ) {
-		result {
-      id
-      name
-    }
-    suberrors {
-      attributes {
-        code
-        msg
-        suberrors {
-          age {
-            code
-            msg
-          }
-          name {
-            code
-            msg
-          }
-        }
-      }
-    }
-  }
-}
+# Validation of InputObjects (or Objects) 
+
+You can add `validate` properties to the fields of nested Objects or InputObjects (and those fields can themselves be of complex types with their own fields, and so on). This library will sniff them out and recursively build up a result type with a similarly nested structure.
+
+
+### Run locally
+```
+php -S localhost:8000 ./index.php
+```
+
+### Install ChromeiQL plug-in for Chrome
+1. Install from [here](https://chrome.google.com/webstore/detail/chromeiql/fkkiamalmpiidkljmicmjfbieiclmeij?hl=en)
+2. Enter "http://localhost:8000" in the text field at the top and press the "Set Endpoint" button
+3. Be sure to inspect the "Docs" flyout to get familiar with the dynamically-generated types
+
+### Try mutation with valid input
+```
+mutation {
+	updateAuthor(
+    authorId: 1
+  	attributes: {
+      name: "Stephen King",
+      age: 47
+    }
+  ) {
+		result {
+      id
+      name
+    }
+    suberrors {
+      attributes {
+        code
+        msg
+        suberrors {
+          age {
+            code
+            msg
+          }
+          name {
+            code
+            msg
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+### Try mutation with invalid input
+```
+mutation {
+	updateAuthor(
+    authorId: 1
+  	attributes: {
+      name: "Edward John Moreton Drax Plunkett, 18th Baron of Dunsany",
+      age: -3
+    }
+  ) {
+		result {
+      id
+      name
+    }
+    suberrors {
+      attributes {
+        code
+        msg
+        suberrors {
+          age {
+            code
+            msg
+          }
+          name {
+            code
+            msg
+          }
+        }
+      }
+    }
+  }
+}
 ```