Add some docs to README.md

README.md

@@ -1,6 +1,22 @@
 # SimplexMapper
 
-A simple PHP library to map data from one object to another.
+A simple PHP library to map data from a source (object or array) to an object.
+
+```php
+$dbData = [
+    'username' => 'pfazzi',
+    'email_address' => '[email protected]',
+    'is_enabled' => '1',
+];
+
+$mapper = new \Pfazzi\SimplexMapper\Mapper();
+
+$user = $mapper->map(
+    source: $dbData, 
+    target: User::class, 
+    nameConverter: new SnakeToCamel()
+);
+```
 
 ## Installation
 
@@ -21,28 +37,28 @@ $mapper = new \Pfazzi\SimplexMapper\Mapper();
 
 // From Array 
 
-$someClassInstance = $mapper->map(source: ['name' => 'patrick'], target: UserEntity::class);
+$userEntity = $mapper->map(source: ['name' => 'patrick'], target: UserEntity::class);
 
 // From stdClass 
 
 $rawData = new \stdClass();
 $rawData->name = 'Patrick';
 
-$someClassInstance = $mapper->map(source: $rawData, target: UserEntity::class);
+$userEntity = $mapper->map(source: $rawData, target: UserEntity::class);
 
 // From anonymous class
 
 $rawData = new class {
     public function __construct(private string $name = 'Patrick') {}
 };
 
-$someClassInstance = $mapper->map(source: $rawData, target: UserEntity::class);
+$userEntity = $mapper->map(source: $rawData, target: UserEntity::class);
 
 // From object
 
 $rawData = new UserDto('Patrick');
 
-$someClassInstance = $mapper->map(source: $rawData, target: UserEntity::class);
+$userEntity = $mapper->map(source: $rawData, target: UserEntity::class);
 ```
 
 ### Hydrate

test/MapperTest.php

@@ -17,6 +17,23 @@ protected function setUp(): void
         $this->mapper = new Mapper();
     }
 
+    public function test_demo(): void
+    {
+        $dbData = [
+            'username' => 'pfazzi',
+            'email_address' => '[email protected]',
+            'is_enabled' => '1',
+        ];
+
+        $user = $this->mapper->map(
+            source: $dbData,
+            target: User::class,
+            nameConverter: new SnakeToCamel()
+        );
+
+        self::assertEquals(new User('pfazzi', '[email protected]', true), $user);
+    }
+
     public function test_it_maps_an_array_to_an_object(): void
     {
         $source = [

test/User.php

@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Pfazzi\SimplexMapper\Test;
+
+class User
+{
+    public function __construct(
+        private string $username,
+        private string $emailAddress,
+        private bool $isEnabled,
+    ) {
+    }
+}