From 10c3f634f5fc45dd6bc5fe48c6f772d1df927aa6 Mon Sep 17 00:00:00 2001
From: Michael Wallner <mike@php.net>
Date: Fri, 8 Mar 2013 16:08:48 +0100
Subject: [PATCH] README

---
 README.md | 41 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..8a75e67
--- /dev/null
+++ b/README.md
@@ -0,0 +1,41 @@
+ascertain
+=========
+
+Harmless validation.
+
+```php
+$user->assert()
+	->that("name")
+		->isNotNothing("a name is required")
+		->isLen(4, "must be at least 4 characters long")
+	->that("email")
+		->isEmail("is not valid")
+	->that("homepage")
+		->when($user->hasHomepage())
+		->isUrl("seems not to be a valid URL");
+
+# ...
+
+class User implements \ascertain\Testable
+{
+	use \ascertain\Validator;
+
+	protected $id;
+	protected $name;
+	protected $email;
+	protected $homepage;
+
+	function hasHomepage() {
+		return isset($this->homepage);
+	}
+
+	function export() {
+		return array(
+			"name"     => $this->name,
+			"email"    => $this->email,
+			"homepage" => $this->homepage.
+		);
+	}
+}
+```
+
-- 
2.30.2