feat: Entity Framework Core YDB Quick Start

Author: KirillKurdyukov

.github/workflows/tests.yml

@@ -195,7 +195,11 @@ jobs:
         run: |
           cd ./examples/src/Topic
           dotnet run
-      - name: Run EF example
+      - name: Run Entity Framework Core example
         run: |
-          cd ./examples/src/EF
+          cd ./examples/src/EntityFrameworkCore.Ydb.QuickStart
+          dotnet tool install --global dotnet-ef
+          dotnet add package Microsoft.EntityFrameworkCore.Design
+          dotnet ef migrations add InitialCreate
+          dotnet ef database update
           dotnet run

examples/src/EF/EF.csproj

@@ -0,0 +1,21 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+    <PropertyGroup>
+        <OutputType>Exe</OutputType>
+        <TargetFramework>net8.0</TargetFramework>
+        <ImplicitUsings>enable</ImplicitUsings>
+        <Nullable>enable</Nullable>
+        <RootNamespace>EntityFrameworkCore.Ydb</RootNamespace>
+    </PropertyGroup>
+
+    <ItemGroup>
+        <ProjectReference Include="..\..\..\src\EFCore.Ydb\src\EntityFrameworkCore.Ydb.csproj" />
+    </ItemGroup>
+
+    <ItemGroup>
+      <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="9.0.5">
+        <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+        <PrivateAssets>all</PrivateAssets>
+      </PackageReference>
+    </ItemGroup>
+</Project>

examples/src/EntityFrameworkCore.Ydb.QuickStart/EntityFrameworkCore.Ydb.QuickStart.csproj

@@ -3,24 +3,25 @@
 
 await using var db = new BloggingContext();
 
-await db.Database.EnsureDeletedAsync();
-await db.Database.EnsureCreatedAsync();
-
+// Create
 Console.WriteLine("Inserting a new blog");
 db.Add(new Blog { Url = "http://blogs.msdn.com/adonet" });
-
 await db.SaveChangesAsync();
 
+// Read
 Console.WriteLine("Querying for a blog");
 var blog = await db.Blogs
     .OrderBy(b => b.BlogId)
     .FirstAsync();
 
+// Update
 Console.WriteLine("Updating the blog and adding a post");
 blog.Url = "https://devblogs.microsoft.com/dotnet";
-blog.Posts.Add(new Post { Title = "Hello World", Content = "I wrote an app using EF Core!" });
+blog.Posts.Add(
+    new Post { Title = "Hello World", Content = "I wrote an app using EF Core!" });
 await db.SaveChangesAsync();
 
+// Delete
 Console.WriteLine("Delete the blog");
 db.Remove(blog);
 await db.SaveChangesAsync();

examples/src/EF/Program.cs renamed to examples/src/EntityFrameworkCore.Ydb.QuickStart/Program.cs

@@ -0,0 +1,16 @@
+# Entity Framework Core YDB Quick Start
+
+A sample application from the [official documentation](https://learn.microsoft.com/en-us/ef/core/get-started/overview/first-app?tabs=netcore-cli)
+shows how to get started with EF, define a model, populate it with data and then query the database.
+
+## Running QuickStart
+
+1. Setup [YDB local](https://ydb.tech/docs/en/reference/docker/start).
+2. Create the database:
+    ```bash
+    dotnet tool install --global dotnet-ef
+    dotnet add package Microsoft.EntityFrameworkCore.Design
+    dotnet ef migrations add InitialCreate
+    dotnet ef database update
+    ```
+3. Run the app: `dotnet run`

examples/src/EntityFrameworkCore.Ydb.QuickStart/README.md

@@ -17,7 +17,7 @@ Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "YC", "YC\YC.csproj", "{753E
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Topic", "Topic\Topic.csproj", "{0FB9A1C2-4B0C-4AE4-9FA2-E0ED37802A6E}"
 EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "EF", "EF\EF.csproj", "{0CE9DF93-1411-4E73-BA88-A66018FAB948}"
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "EntityFrameworkCore.Ydb.QuickStart", "EntityFrameworkCore.Ydb.QuickStart\EntityFrameworkCore.Ydb.QuickStart.csproj", "{0CE9DF93-1411-4E73-BA88-A66018FAB948}"
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "EntityFrameworkCore.Ydb.Yandex.Cloud", "EntityFrameworkCore.Ydb.Yandex.Cloud\EntityFrameworkCore.Ydb.Yandex.Cloud.csproj", "{8F7266C7-75BB-4753-9FB2-BDF4678AF73B}"
 EndProject