Merge pull request #15 from marvinosswald/master

::create() - improve compliance with laravel model by providing static create method

Author: kitar

README.md

@@ -16,6 +16,7 @@ A DynamoDB based Eloquent model and Query builder for Laravel.
     + [Retrieving all models](#retrieving-all-models)
     + [Retrieving a model](#retrieving-a-model)
     + [save()](#save)
+    + [create()](#create)
     + [update()](#update)
     + [delete()](#delete)
     + [increment() / decrement()](#increment--decrement)
@@ -229,12 +230,21 @@ If the model has sort key and `sortKeyDefault` is defined:
 User::find('foo@bar.com'); // Partition key. sortKeyDefault will be used for Sort key.
 ```
 
+#### create()
+
+```php
+$user = User::create([
+    'email' => 'foo@bar.com',
+    'type' => 'profile' // Sort key. If we don't specify this, sortKeyDefault will be used.
+]);
+```
+
 #### save()
 
 ```php
 $user = new User([
     'email' => 'foo@bar.com',
-    'type' => 'profile' // Sort key. If we don't specify this, sortKeyDefault will be used.
+    'type' => 'profile'
 ]);
 
 $user->save();

src/Kitar/Dynamodb/Model/Model.php

@@ -129,6 +129,20 @@ public static function all($columns = [])
         return static::scan($columns);
     }
 
+    /**
+     * Save a new model and return the instance.
+     *
+     * @param  array  $fillables
+     * @param  array  $options
+     * @return \Kitar\Dynamodb\Model\Model|$this
+     */
+    public static function create(array $fillables = [], array $options = [])
+    {
+        $instance = new static($fillables);
+        $instance->save($options);
+        return $instance;
+    }
+
     /**
      * Save the model to the database.
      *

tests/Model/ModelTest.php

@@ -431,6 +431,29 @@ public function it_can_save_new_instance()
         $user->save();
     }
 
+    /** @test */
+    public function it_can_static_create_new_instance()
+    {
+        $params = [
+            'TableName' => 'User',
+            'Item' => [
+                'partition' => [
+                    'S' => 'p'
+                ]
+            ],
+            'ConditionExpression' => 'attribute_not_exists(#1)',
+            'ExpressionAttributeNames' => [
+                '#1' => 'partition'
+            ]
+        ];
+
+        $connection = $this->newConnectionMock();
+        $connection->shouldReceive('putItem')->with($params);
+        $this->setConnectionResolver($connection);
+
+        UserD::create(['partition' => 'p']);
+    }
+
     /** @test */
     public function it_cannot_save_new_instance_without_required_key()
     {

tests/Model/UserD.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace Kitar\Dynamodb\Tests\Model;
+
+use Kitar\Dynamodb\Model\Model;
+use Illuminate\Auth\Authenticatable;
+use Illuminate\Contracts\Auth\Authenticatable as AuthenticatableContract;
+
+class UserD extends Model implements AuthenticatableContract
+{
+    use Authenticatable;
+
+    protected $table = 'User';
+    protected $primaryKey = 'partition';
+    protected $fillable = [
+        'partition'
+    ];
+    public $timestamps = false;
+}