Added "Find" method, updated README

Author: louisevanderlith

Lith.DocStore.Tests/ModelContextTests.cs

@@ -2,6 +2,7 @@
 using Lith.DocStore.Models;
 using Lith.DocStore.Tests.SupportingUtils;
 using Microsoft.VisualStudio.TestTools.UnitTesting;
+using System;
 using System.Collections.Generic;
 using System.Linq;
 
@@ -164,5 +165,36 @@ public void UpdateModelInStore_MustHaveNewValue()
                 Assert.IsTrue(results.Any());
             }
         }
+
+        [TestMethod]
+        public void FindAndUpdateModel_MustFindObject()
+        {
+            var modelHelper = new JSONModelHelper();
+            var itemID = Guid.Empty;
+
+            using (var ctx = new ModelsContext(modelHelper))
+            {
+                var tops = ctx.Shops.FirstOrDefault(a => a.Name == "Tops");
+                itemID = tops.ID;
+            }
+
+            using (var ctx = new ModelsContext(modelHelper))
+            {
+                var item = ctx.Shops.Find(itemID);
+
+                if (item != null)
+                {
+                    item.Name += " 2nd";
+
+                    var result = ctx.Shops.Find(itemID);
+                    
+                    Assert.AreEqual("Tops 2nd", result.Name);
+                }
+                else
+                {
+                    Assert.Fail("Couldn't find Item by ID");
+                }
+            }
+        }
     }
 }

Lith.DocStore.sln

@@ -9,6 +9,11 @@ Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Lith.DocStore.Models", "Lit
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Lith.DocStore.Tests", "Lith.DocStore.Tests\Lith.DocStore.Tests.csproj", "{04A797D0-F196-47E2-A973-A1F99F1C4DD4}"
 EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{E4B4DD2F-37BC-44FA-A873-DDADCFC0BB3A}"
+	ProjectSection(SolutionItems) = preProject
+		README.md = README.md
+	EndProjectSection
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU

Lith.DocStore/ItemSet.cs

@@ -49,6 +49,23 @@ public void AddRange(IEnumerable<T> models)
             }
         }
 
+        public T Find(Guid ID)
+        {
+            var result = setItems.FirstOrDefault(a => !a.IsDeleted && a.ID == ID);
+
+            if (result == null)
+            {
+                var ctxResult = context.Entities.FirstOrDefault(a => !a.IsDeleted && a.ID == ID);
+
+                if (ctxResult is T)
+                {
+                    result = ctxResult as T;
+                }
+            }
+
+            return result;
+        }
+
         private List<T> GetFreshItems()
         {
             var manager = new Manager(context.ModelHelper);

README.md

@@ -7,11 +7,14 @@ Lith.DocStore provides interfaces that allow you to create physical data files w
 The idea behind this is that you can run unit tests against models and logic without commiting to a database or having a connection.
 
 # Benefits
-1.  Models live in a seperate project.
+1.  Models can live in a seperate project, which reduces the need for DTO project/objects.
 2.  No setup apart from Creating your models
 3.  Can be used instead of having the need to create a database when building a new project
 4.  Any other benefits I couldn't think of.
 
+# Installation
+nuget: [install-package lith.docstore](https://www.nuget.org/packages/Lith.DocStore)
+
 # Usage
 1. Create Models
 ```C#
@@ -41,7 +44,7 @@ The idea behind this is that you can run unit tests against models and logic wit
   public class ModelsContext : StoreContext
     {
         public ModelsContext()
-            : base(new YourModelSerializer())
+            : base(new JSONModelHelper())
         {
 
         }
@@ -54,7 +57,7 @@ The idea behind this is that you can run unit tests against models and logic wit
     }
 ```
 
-3. Add to your Model
+3. Add Record
 ```C#
   var shopA = new Shop
   {
@@ -69,7 +72,7 @@ The idea behind this is that you can run unit tests against models and logic wit
   }
 ```
 
-4. Query your Model
+4. Query Record
 ```C#
   using (var ctx = new ModelsContext())
   {
@@ -80,4 +83,15 @@ The idea behind this is that you can run unit tests against models and logic wit
   }
 ```
 
-5. Have a cold one ;)
+5. Find and Update Record
+```C#
+	using(var ctx = new ModelsContext())
+	{
+		var item = ctx.Shops.Find(id);
+		item.Name = "DEF";
+
+		ctx.Save();
+	}
+```
+
+6. Have a cold one ;)