readme

README.md

@@ -19,9 +19,9 @@ This means you get the best of both worlds: the performance and simplicity of Da
 
 | Database | Supported | Code | NuGet |
 | -------- | -------- | -------- | -------- |
-| MySql         |   √   | [MySql](src/develop/src/Vitorm.MySql)             |  [![](https://img.shields.io/nuget/v/Vitorm.MySql.svg)](https://www.nuget.org/packages/Vitorm.MySql) ![](https://img.shields.io/nuget/dt/Vitorm.MySql.svg)   |
-| SqlServer     |   √   | [SqlServer](src/develop/src/Vitorm.SqlServer)     |  [![](https://img.shields.io/nuget/v/Vitorm.SqlServer.svg)](https://www.nuget.org/packages/Vitorm.SqlServer) ![](https://img.shields.io/nuget/dt/Vitorm.SqlServer.svg)   |
-| Sqlite        |   √   | [Sqlite](src/develop/src/Vitorm.Sqlite)           |  [![](https://img.shields.io/nuget/v/Vitorm.Sqlite.svg)](https://www.nuget.org/packages/Vitorm.Sqlite) ![](https://img.shields.io/nuget/dt/Vitorm.Sqlite.svg)   |
+| MySql         |   √   | [MySql](https://github.com/VitormLib/Vitorm/tree/master/src/Vitorm.MySql)             |  [![](https://img.shields.io/nuget/v/Vitorm.MySql.svg)](https://www.nuget.org/packages/Vitorm.MySql) ![](https://img.shields.io/nuget/dt/Vitorm.MySql.svg)   |
+| SqlServer     |   √   | [SqlServer](https://github.com/VitormLib/Vitorm/tree/master/src/Vitorm.SqlServer)     |  [![](https://img.shields.io/nuget/v/Vitorm.SqlServer.svg)](https://www.nuget.org/packages/Vitorm.SqlServer) ![](https://img.shields.io/nuget/dt/Vitorm.SqlServer.svg)   |
+| Sqlite        |   √   | [Sqlite](https://github.com/VitormLib/Vitorm/tree/master/src/Vitorm.Sqlite)           |  [![](https://img.shields.io/nuget/v/Vitorm.Sqlite.svg)](https://www.nuget.org/packages/Vitorm.Sqlite) ![](https://img.shields.io/nuget/dt/Vitorm.Sqlite.svg)   |
 | ElasticSearch |   √   | [ElasticSearch](https://github.com/VitormLib/Vitorm.ElasticSearch)     |  [![](https://img.shields.io/nuget/v/Vitorm.ElasticSearch.svg)](https://www.nuget.org/packages/Vitorm.ElasticSearch) ![](https://img.shields.io/nuget/dt/Vitorm.ElasticSearch.svg)   |
 | ClickHouse    |   √   | [ClickHouse](https://github.com/VitormLib/Vitorm.ClickHouse)     |  [![](https://img.shields.io/nuget/v/Vitorm.ClickHouse.svg)](https://www.nuget.org/packages/Vitorm.ClickHouse) ![](https://img.shields.io/nuget/dt/Vitorm.ClickHouse.svg)   |
 | Oracle        |   ×   |      |      |
@@ -176,7 +176,7 @@ Vitorm.Data is a static class that allows you to use Vitorm without explicitly c
  
 ## Installation
 
-Before using Vitorm, install the necessary package:
+Before using Vitorm.Data, install the necessary package:
 ``` bash
 dotnet add package Vitorm.Data
 dotnet add package Vitorm.Sqlite
@@ -189,8 +189,7 @@ dotnet add package Vitorm.Sqlite
   "Vitorm": {
     "Data": [
       {
-        "provider": "Vitorm.Sqlite.DataProvider",
-        "assemblyFile": "Vitorm.Sqlite.dll",
+        "provider": "Sqlite",
         "namespace": "App",
         "connectionString": "data source=sqlite.db;"
       }

src/Vitorm.Data/README.md

@@ -0,0 +1,167 @@
+
+# Vitorm.Data
+Vitorm is a lightweight yet comprehensive ORM that strikes the perfect balance between simplicity and functionality.     
+Similar to Dapper in its lightweight design, Vitorm offers an easy-to-use, efficient interface for data access.     
+However, it doesn't stop there; Vitorm goes beyond basic ORM capabilities to provide a rich feature set akin to Entity Framework.     
+This means you get the best of both worlds: the performance and simplicity of Dapper with the robust features and flexibility of Entity Framework, making Vitorm an ideal choice for developers seeking a powerful yet streamlined ORM solution.
+> written by ChatGPT :  "Help me write a description for Vitorm. It is a lightweight ORM, similar to Dapper, but it is feature-rich, akin to EF. Please emphasize its lightweight nature and comprehensive functionality."    
+> source address: [https://github.com/VitormLib/Vitorm](https://github.com/VitormLib/Vitorm "https://github.com/VitormLib/Vitorm/tree/master/src/Vitorm.Data")        
+
+![](https://img.shields.io/github/license/VitormLib/Vitorm.svg)  
+![](https://img.shields.io/github/repo-size/VitormLib/Vitorm.svg)  ![](https://img.shields.io/github/last-commit/VitormLib/Vitorm.svg)  
+ 
+
+| Build | NuGet |
+| -------- | -------- |
+|![](https://github.com/VitormLib/Vitorm/workflows/ki_devops3/badge.svg) | [![](https://img.shields.io/nuget/v/Vitorm.Data.svg)](https://www.nuget.org/packages/Vitorm.Data) ![](https://img.shields.io/nuget/dt/Vitorm.Data.svg) |
+
+
+
+
+# Vitorm.Data Documentation
+Vitorm.Data is a static class that allows you to use Vitorm without explicitly creating or disposing of a DbContext.
+ 
+## Installation
+
+Before using Vitorm.Data, install the necessary package:
+``` bash
+dotnet add package Vitorm.Data
+dotnet add package Vitorm.Sqlite
+```
+
+## Config settings
+``` json
+// appsettings.json
+{
+  "Vitorm": {
+    "Data": [
+      {
+        "provider": "Sqlite",
+        "namespace": "App",
+        "connectionString": "data source=sqlite.db;"
+      }
+    ]
+  }
+}
+```
+
+
+## Using Vitorm.Data
+
+``` csharp
+using Vit.Extensions.Vitorm_Extensions;
+using Vitorm;
+
+namespace App
+{
+    public class Program
+    {
+        static void Main(string[] args)
+        {
+            // #1 Create an empty SQLite database file and configures Vitorm.Data
+            File.WriteAllBytes("sqlite.db", new byte[0]);
+
+            // #2 Create Table
+            Data.Drop<User>();
+            Data.Create<User>();
+
+            // #3 Insert Records
+            Data.Add(new User { id = 1, name = "lith" });
+            Data.AddRange(new[] {
+                new User { id = 2, name = "lith", fatherId = 1 },
+                new User { id = 3, name = "lith", fatherId = 1 }
+            });
+
+            // #4 Query Records
+            {
+                var user = Data.Get<User>(1);
+                var users = Data.Query<User>().Where(u => u.name.Contains("li")).ToList();
+                var sql = Data.Query<User>().Where(u => u.name.Contains("li")).ToExecuteString();
+            }
+
+            // #5 Update Records
+            Data.Update(new User { id = 1, name = "lith1" });
+            Data.UpdateRange(new[] {
+                new User { id = 2, name = "lith2", fatherId = 1 },
+                new User { id = 3, name = "lith3", fatherId = 2 }
+            });
+            Data.Query<User>().Where(u => u.name.Contains("li"))
+                .ExecuteUpdate(u => new User { name = "Lith" + u.id });
+
+            // #6 Delete Records
+            Data.Delete<User>(new User { id = 1, name = "lith1" });
+            Data.DeleteRange(new[] {
+                new User { id = 2, name = "lith2", fatherId = 1 },
+                new User { id = 3, name = "lith3", fatherId = 2 }
+            });
+            Data.DeleteByKey<User>(1);
+            Data.DeleteByKeys<User, int>(new[] { 1, 2 });
+            Data.Query<User>().Where(u => u.name.Contains("li"))
+                .ExecuteDelete();
+
+            // #7 Join Queries
+            {
+                var query =
+                        from user in Data.Query<User>()
+                        from father in Data.Query<User>().Where(father => user.fatherId == father.id).DefaultIfEmpty()
+                        where father != null
+                        orderby user.id
+                        select new { user, father };
+
+                var sql = query.ToExecuteString();
+                var users = query.ToList();
+            }
+
+            // #8 Transactions
+            {
+                using var dbContext = Data.DataProvider<User>().CreateSqlDbContext();
+                using var tran1 = dbContext.BeginTransaction();
+
+                dbContext.Update(new User { id = 4, name = "u4001" });
+
+                using (var tran2 = dbContext.BeginTransaction())
+                {
+                    dbContext.Update(new User { id = 4, name = "u4002" });
+                    // will rollback
+                }
+
+                using (var tran2 = dbContext.BeginTransaction())
+                {
+                    dbContext.Update(new User { id = 4, name = "u4002" });
+                    tran2.Rollback();
+                }
+
+                using (var tran2 = dbContext.BeginTransaction())
+                {
+                    dbContext.Update(new User { id = 4, name = "u4003" });
+                    tran2.Commit();
+                }
+
+                tran1.Commit();
+            }
+
+            // #9 Database Functions
+            {
+                // select * from User where IIF(t0.fatherId is not null, true, false);
+                var query = Data.Query<User>().Where(u => DbFunction.Call<bool>("IIF", u.fatherId != null, true, false));
+                var sql = query.ToExecuteString();
+                var userList = query.ToList();
+            }
+        }
+
+        // Entity Definition
+        [System.ComponentModel.DataAnnotations.Schema.Table("User")]
+        public class User
+        {
+            [System.ComponentModel.DataAnnotations.Key]
+            public int id { get; set; }
+            public string name { get; set; }
+            public DateTime? birth { get; set; }
+            public int? fatherId { get; set; }
+        }
+    }
+}
+```
+
+[Console Example](https://github.com/VitormLib/Vitorm/tree/master/test/Vitorm.Data.Console)    
+[Test Example](https://github.com/VitormLib/Vitorm/tree/master/test/Vitorm.Data.MsTest)    

src/Vitorm.Data/Vitorm.Data.csproj

@@ -13,8 +13,11 @@
     <PropertyGroup>
         <Authors>Lith</Authors>
         <Description>Data access for Database</Description>
-        <PackageProjectUrl>https://github.com/VitormLib/Vitorm.ClickHouse</PackageProjectUrl>
+        <PackageProjectUrl>https://github.com/VitormLib/Vitorm</PackageProjectUrl>
         <PackageIcon>vitorm_logo_v1.png</PackageIcon>
+        <PackageReadmeFile>README.md</PackageReadmeFile>
+        <RepositoryUrl>https://github.com/VitormLib/Vitorm</RepositoryUrl>
+        <PackageTags>orm vitorm database mysql sqlserver sqlite clickhouse elasticsearch</PackageTags>
     </PropertyGroup>
 
     <ItemGroup>
@@ -32,4 +35,11 @@
         <ProjectReference Include="..\..\..\Vitorm\src\Vitorm\Vitorm.csproj" />
     </ItemGroup>
 
+    <ItemGroup>
+      <None Update="README.md">
+        <Pack>True</Pack>
+        <PackagePath>\</PackagePath>
+      </None>
+    </ItemGroup>
+
 </Project>

src/Vitorm.MySql/README.md

@@ -0,0 +1,304 @@
+
+# Vitorm.MySql
+Vitorm.MySql is a lightweight yet comprehensive ORM for MySql that strikes the perfect balance between simplicity and functionality.     
+Similar to Dapper in its lightweight design, Vitorm offers an easy-to-use, efficient interface for data access.     
+However, it doesn't stop there; Vitorm goes beyond basic ORM capabilities to provide a rich feature set akin to Entity Framework.     
+This means you get the best of both worlds: the performance and simplicity of Dapper with the robust features and flexibility of Entity Framework, making Vitorm an ideal choice for developers seeking a powerful yet streamlined ORM solution.
+> source address: [https://github.com/VitormLib/Vitorm/tree/master/src/Vitorm.MySql](https://github.com/VitormLib/Vitorm/tree/master/src/Vitorm.MySql "https://github.com/VitormLib/Vitorm/tree/master/src/Vitorm.MySql")        
+
+![](https://img.shields.io/github/license/VitormLib/Vitorm.svg)  
+![](https://img.shields.io/github/repo-size/VitormLib/Vitorm.svg)  ![](https://img.shields.io/github/last-commit/VitormLib/Vitorm.svg)  
+ 
+
+| Build | NuGet |
+| -------- | -------- |
+|![](https://github.com/VitormLib/Vitorm/workflows/ki_devops3/badge.svg) | [![](https://img.shields.io/nuget/v/Vitorm.MySql.svg)](https://www.nuget.org/packages/Vitorm.MySql) ![](https://img.shields.io/nuget/dt/Vitorm.MySql.svg) |
+
+
+
+
+# Vitorm.MySql Documentation
+This guide will walk you through the steps to set up and use Vitorm.MySql.
+
+## Installation
+Before using Vitorm.MySql, install the necessary package:
+
+``` bash
+dotnet add package Vitorm.MySql
+```
+
+## Using Vitorm.MySql
+> This example provides a comprehensive guide to utilizing Vitorm for basic and advanced database operations while maintaining lightweight performance.    
+
+``` csharp
+using Vitorm;
+
+namespace App
+{
+    public class Program
+    {
+        static void Main(string[] args)
+        {
+            // #1 Create an empty SQLite database file and configures Vitorm
+            using var dbContext = new Vitorm.Sql.SqlDbContext();
+            dbContext.UseMySql("Data Source=localhost;Port=3306;Database=dev-orm;SslMode=none;User Id=root;Password=123456;CharSet=utf8;allowPublicKeyRetrieval=true;");
+
+            // #2 Create Table
+            dbContext.Drop<User>();
+            dbContext.Create<User>();
+
+            // #3 Insert Records
+            dbContext.Add(new User { id = 1, name = "lith" });
+            dbContext.AddRange(new[] {
+                new User { id = 2, name = "lith", fatherId = 1 },
+                new User { id = 3, name = "lith", fatherId = 1 }
+            });
+
+            // #4 Query Records
+            {
+                var user = dbContext.Get<User>(1);
+                var users = dbContext.Query<User>().Where(u => u.name.Contains("li")).ToList();
+                var sql = dbContext.Query<User>().Where(u => u.name.Contains("li")).ToExecuteString();
+            }
+
+            // #5 Update Records
+            dbContext.Update(new User { id = 1, name = "lith1" });
+            dbContext.UpdateRange(new[] {
+                new User { id = 2, name = "lith2", fatherId = 1 },
+                new User { id = 3, name = "lith3", fatherId = 2 }
+            });
+            dbContext.Query<User>().Where(u => u.name.Contains("li"))
+                .ExecuteUpdate(u => new User { name = "Lith" + u.id });
+
+            // #6 Delete Records
+            dbContext.Delete<User>(new User { id = 1, name = "lith1" });
+            dbContext.DeleteRange(new[] {
+                new User { id = 2, name = "lith2", fatherId = 1 },
+                new User { id = 3, name = "lith3", fatherId = 2 }
+            });
+            dbContext.DeleteByKey<User>(1);
+            dbContext.DeleteByKeys<User, int>(new[] { 1, 2 });
+            dbContext.Query<User>().Where(u => u.name.Contains("li"))
+                .ExecuteDelete();
+
+            // #7 Join Queries
+            {
+                var query =
+                        from user in dbContext.Query<User>()
+                        from father in dbContext.Query<User>().Where(father => user.fatherId == father.id).DefaultIfEmpty()
+                        where father != null
+                        orderby user.id
+                        select new { user, father };
+
+                var sql = query.ToExecuteString();
+                var users = query.ToList();
+            }
+
+            // #8 Transactions
+            {
+                using var tran1 = dbContext.BeginTransaction();
+                dbContext.Update(new User { id = 4, name = "u4001" });
+
+                using (var tran2 = dbContext.BeginTransaction())
+                {
+                    dbContext.Update(new User { id = 4, name = "u4002" });
+                    // will rollback
+                }
+
+                using (var tran2 = dbContext.BeginTransaction())
+                {
+                    dbContext.Update(new User { id = 4, name = "u4002" });
+                    tran2.Rollback();
+                }
+
+                using (var tran2 = dbContext.BeginTransaction())
+                {
+                    dbContext.Update(new User { id = 4, name = "u4003" });
+                    tran2.Commit();
+                }
+
+                tran1.Commit();
+            }
+
+            // #9 Database Functions
+            {
+                // select * from User where IIF(t0.fatherId is not null, true, false);
+                var query = dbContext.Query<User>().Where(u => DbFunction.Call<bool>("IIF", u.fatherId != null, true, false));
+                var sql = query.ToExecuteString();
+                var userList = query.ToList();
+            }
+        }
+
+        // Entity Definition
+        [System.ComponentModel.DataAnnotations.Schema.Table("User")]
+        public class User
+        {
+            [System.ComponentModel.DataAnnotations.Key]
+            public int id { get; set; }
+            public string name { get; set; }
+            public DateTime? birth { get; set; }
+            public int? fatherId { get; set; }
+        }
+    }
+}
+```
+
+## Explanation
+
+1. **Setup**: Initializes the SQLite database and configures Vitorm.
+2. **Create Table**: Drops and recreates the `User` table.
+3. **Insert Records**: Adds single and multiple user records.
+4. **Query Records**: Retrieves user records using various querying methods.
+5. **Update Records**: Updates single and multiple user records.
+6. **Delete Records**: Deletes single and multiple user records.
+7. **Join Queries**: Performs a join operation between user and father records.
+8. **Transactions**: Demonstrates nested transactions and rollback/commit operations.
+9. **Database Functions**: Uses custom database functions in queries.
+
+
+
+# Vitorm.Data Documentation
+Vitorm.Data is a static class that allows you to use Vitorm without explicitly creating or disposing of a DbContext.
+ 
+## Installation
+
+Before using Vitorm.Data, install the necessary package:
+``` bash
+dotnet add package Vitorm.Data
+dotnet add package Vitorm.MySql
+```
+
+## Config settings
+``` json
+// appsettings.json
+{
+  "Vitorm": {
+    "Data": [
+      {
+        "provider": "MySql",
+        "namespace": "App",
+        "connectionString": "Data Source=localhost;Port=3306;Database=dev-orm;SslMode=none;User Id=root;Password=123456;CharSet=utf8;allowPublicKeyRetrieval=true;"
+      }
+    ]
+  }
+}
+```
+
+
+## Using Vitorm.Data
+
+``` csharp
+using Vitorm;
+
+namespace App
+{
+    public class Program
+    {
+        static void Main(string[] args)
+        {
+            // #1
+
+            // #2 Create Table
+            Data.Drop<User>();
+            Data.Create<User>();
+
+            // #3 Insert Records
+            Data.Add(new User { id = 1, name = "lith" });
+            Data.AddRange(new[] {
+                new User { id = 2, name = "lith", fatherId = 1 },
+                new User { id = 3, name = "lith", fatherId = 1 }
+            });
+
+            // #4 Query Records
+            {
+                var user = Data.Get<User>(1);
+                var users = Data.Query<User>().Where(u => u.name.Contains("li")).ToList();
+                var sql = Data.Query<User>().Where(u => u.name.Contains("li")).ToExecuteString();
+            }
+
+            // #5 Update Records
+            Data.Update(new User { id = 1, name = "lith1" });
+            Data.UpdateRange(new[] {
+                new User { id = 2, name = "lith2", fatherId = 1 },
+                new User { id = 3, name = "lith3", fatherId = 2 }
+            });
+            Data.Query<User>().Where(u => u.name.Contains("li"))
+                .ExecuteUpdate(u => new User { name = "Lith" + u.id });
+
+            // #6 Delete Records
+            Data.Delete<User>(new User { id = 1, name = "lith1" });
+            Data.DeleteRange(new[] {
+                new User { id = 2, name = "lith2", fatherId = 1 },
+                new User { id = 3, name = "lith3", fatherId = 2 }
+            });
+            Data.DeleteByKey<User>(1);
+            Data.DeleteByKeys<User, int>(new[] { 1, 2 });
+            Data.Query<User>().Where(u => u.name.Contains("li"))
+                .ExecuteDelete();
+
+            // #7 Join Queries
+            {
+                var query =
+                        from user in Data.Query<User>()
+                        from father in Data.Query<User>().Where(father => user.fatherId == father.id).DefaultIfEmpty()
+                        where father != null
+                        orderby user.id
+                        select new { user, father };
+
+                var sql = query.ToExecuteString();
+                var users = query.ToList();
+            }
+
+            // #8 Transactions
+            {
+                using var dbContext = Data.DataProvider<User>().CreateSqlDbContext();
+                using var tran1 = dbContext.BeginTransaction();
+
+                dbContext.Update(new User { id = 4, name = "u4001" });
+
+                using (var tran2 = dbContext.BeginTransaction())
+                {
+                    dbContext.Update(new User { id = 4, name = "u4002" });
+                    // will rollback
+                }
+
+                using (var tran2 = dbContext.BeginTransaction())
+                {
+                    dbContext.Update(new User { id = 4, name = "u4002" });
+                    tran2.Rollback();
+                }
+
+                using (var tran2 = dbContext.BeginTransaction())
+                {
+                    dbContext.Update(new User { id = 4, name = "u4003" });
+                    tran2.Commit();
+                }
+
+                tran1.Commit();
+            }
+
+            // #9 Database Functions
+            {
+                // select * from User where IIF(t0.fatherId is not null, true, false);
+                var query = Data.Query<User>().Where(u => DbFunction.Call<bool>("IIF", u.fatherId != null, true, false));
+                var sql = query.ToExecuteString();
+                var userList = query.ToList();
+            }
+        }
+
+        // Entity Definition
+        [System.ComponentModel.DataAnnotations.Schema.Table("User")]
+        public class User
+        {
+            [System.ComponentModel.DataAnnotations.Key]
+            public int id { get; set; }
+            public string name { get; set; }
+            public DateTime? birth { get; set; }
+            public int? fatherId { get; set; }
+        }
+    }
+}
+```
+
+
+[Test Example](https://github.com/VitormLib/Vitorm/tree/master/test/Vitorm.MySql.MsTest)    

src/Vitorm.MySql/Vitorm.MySql.csproj

@@ -15,6 +15,9 @@
         <Description>orm for MySql</Description>
         <PackageProjectUrl>https://github.com/VitormLib/Vitorm</PackageProjectUrl>
         <PackageIcon>vitorm_logo_v1.png</PackageIcon>
+        <PackageReadmeFile>README.md</PackageReadmeFile>
+        <RepositoryUrl>https://github.com/VitormLib/Vitorm</RepositoryUrl>
+        <PackageTags>orm vitorm database mysql</PackageTags>
     </PropertyGroup>
 
     <ItemGroup>
@@ -32,4 +35,11 @@
         <ProjectReference Include="..\Vitorm\Vitorm.csproj" />
     </ItemGroup>
 
+    <ItemGroup>
+      <None Update="README.md">
+        <Pack>True</Pack>
+        <PackagePath>\</PackagePath>
+      </None>
+    </ItemGroup>
+
 </Project>

src/Vitorm.SqlServer/README.md

@@ -0,0 +1,304 @@
+
+# Vitorm.SqlServer
+Vitorm.SqlServer is a lightweight yet comprehensive ORM for SqlServer that strikes the perfect balance between simplicity and functionality.     
+Similar to Dapper in its lightweight design, Vitorm offers an easy-to-use, efficient interface for data access.     
+However, it doesn't stop there; Vitorm goes beyond basic ORM capabilities to provide a rich feature set akin to Entity Framework.     
+This means you get the best of both worlds: the performance and simplicity of Dapper with the robust features and flexibility of Entity Framework, making Vitorm an ideal choice for developers seeking a powerful yet streamlined ORM solution.
+> source address: [https://github.com/VitormLib/Vitorm/tree/master/src/Vitorm.SqlServer](https://github.com/VitormLib/Vitorm/tree/master/src/Vitorm.SqlServer "https://github.com/VitormLib/Vitorm/tree/master/src/Vitorm.SqlServer")        
+
+![](https://img.shields.io/github/license/VitormLib/Vitorm.svg)  
+![](https://img.shields.io/github/repo-size/VitormLib/Vitorm.svg)  ![](https://img.shields.io/github/last-commit/VitormLib/Vitorm.svg)  
+ 
+
+| Build | NuGet |
+| -------- | -------- |
+|![](https://github.com/VitormLib/Vitorm/workflows/ki_devops3/badge.svg) | [![](https://img.shields.io/nuget/v/Vitorm.SqlServer.svg)](https://www.nuget.org/packages/Vitorm.SqlServer) ![](https://img.shields.io/nuget/dt/Vitorm.SqlServer.svg) |
+
+
+
+
+# Vitorm.SqlServer Documentation
+This guide will walk you through the steps to set up and use Vitorm.SqlServer.
+
+## Installation
+Before using Vitorm.SqlServer, install the necessary package:
+
+``` bash
+dotnet add package Vitorm.SqlServer
+```
+
+## Using Vitorm.SqlServer
+> This example provides a comprehensive guide to utilizing Vitorm for basic and advanced database operations while maintaining lightweight performance.    
+
+``` csharp
+using Vitorm;
+
+namespace App
+{
+    public class Program
+    {
+        static void Main(string[] args)
+        {
+            // #1 Create an empty SQLite database file and configures Vitorm
+            using var dbContext = new Vitorm.Sql.SqlDbContext();
+            dbContext.UseMySql("Server=localhost;Database=dev-orm;User ID=sa;Password=123456;TrustServerCertificate=true;");
+
+            // #2 Create Table
+            dbContext.Drop<User>();
+            dbContext.Create<User>();
+
+            // #3 Insert Records
+            dbContext.Add(new User { id = 1, name = "lith" });
+            dbContext.AddRange(new[] {
+                new User { id = 2, name = "lith", fatherId = 1 },
+                new User { id = 3, name = "lith", fatherId = 1 }
+            });
+
+            // #4 Query Records
+            {
+                var user = dbContext.Get<User>(1);
+                var users = dbContext.Query<User>().Where(u => u.name.Contains("li")).ToList();
+                var sql = dbContext.Query<User>().Where(u => u.name.Contains("li")).ToExecuteString();
+            }
+
+            // #5 Update Records
+            dbContext.Update(new User { id = 1, name = "lith1" });
+            dbContext.UpdateRange(new[] {
+                new User { id = 2, name = "lith2", fatherId = 1 },
+                new User { id = 3, name = "lith3", fatherId = 2 }
+            });
+            dbContext.Query<User>().Where(u => u.name.Contains("li"))
+                .ExecuteUpdate(u => new User { name = "Lith" + u.id });
+
+            // #6 Delete Records
+            dbContext.Delete<User>(new User { id = 1, name = "lith1" });
+            dbContext.DeleteRange(new[] {
+                new User { id = 2, name = "lith2", fatherId = 1 },
+                new User { id = 3, name = "lith3", fatherId = 2 }
+            });
+            dbContext.DeleteByKey<User>(1);
+            dbContext.DeleteByKeys<User, int>(new[] { 1, 2 });
+            dbContext.Query<User>().Where(u => u.name.Contains("li"))
+                .ExecuteDelete();
+
+            // #7 Join Queries
+            {
+                var query =
+                        from user in dbContext.Query<User>()
+                        from father in dbContext.Query<User>().Where(father => user.fatherId == father.id).DefaultIfEmpty()
+                        where father != null
+                        orderby user.id
+                        select new { user, father };
+
+                var sql = query.ToExecuteString();
+                var users = query.ToList();
+            }
+
+            // #8 Transactions
+            {
+                using var tran1 = dbContext.BeginTransaction();
+                dbContext.Update(new User { id = 4, name = "u4001" });
+
+                using (var tran2 = dbContext.BeginTransaction())
+                {
+                    dbContext.Update(new User { id = 4, name = "u4002" });
+                    // will rollback
+                }
+
+                using (var tran2 = dbContext.BeginTransaction())
+                {
+                    dbContext.Update(new User { id = 4, name = "u4002" });
+                    tran2.Rollback();
+                }
+
+                using (var tran2 = dbContext.BeginTransaction())
+                {
+                    dbContext.Update(new User { id = 4, name = "u4003" });
+                    tran2.Commit();
+                }
+
+                tran1.Commit();
+            }
+
+            // #9 Database Functions
+            {
+                // select * from User where IIF(t0.fatherId is not null, true, false);
+                var query = dbContext.Query<User>().Where(u => DbFunction.Call<bool>("IIF", u.fatherId != null, true, false));
+                var sql = query.ToExecuteString();
+                var userList = query.ToList();
+            }
+        }
+
+        // Entity Definition
+        [System.ComponentModel.DataAnnotations.Schema.Table("User")]
+        public class User
+        {
+            [System.ComponentModel.DataAnnotations.Key]
+            public int id { get; set; }
+            public string name { get; set; }
+            public DateTime? birth { get; set; }
+            public int? fatherId { get; set; }
+        }
+    }
+}
+```
+
+## Explanation
+
+1. **Setup**: Initializes the SQLite database and configures Vitorm.
+2. **Create Table**: Drops and recreates the `User` table.
+3. **Insert Records**: Adds single and multiple user records.
+4. **Query Records**: Retrieves user records using various querying methods.
+5. **Update Records**: Updates single and multiple user records.
+6. **Delete Records**: Deletes single and multiple user records.
+7. **Join Queries**: Performs a join operation between user and father records.
+8. **Transactions**: Demonstrates nested transactions and rollback/commit operations.
+9. **Database Functions**: Uses custom database functions in queries.
+
+
+
+# Vitorm.Data Documentation
+Vitorm.Data is a static class that allows you to use Vitorm without explicitly creating or disposing of a DbContext.
+ 
+## Installation
+
+Before using Vitorm.Data, install the necessary package:
+``` bash
+dotnet add package Vitorm.Data
+dotnet add package Vitorm.SqlServer
+```
+
+## Config settings
+``` json
+// appsettings.json
+{
+  "Vitorm": {
+    "Data": [
+      {
+        "provider": "SqlServer",
+        "namespace": "App",
+        "connectionString": "Server=localhost;Database=dev-orm;User ID=sa;Password=123456;TrustServerCertificate=true;"
+      }
+    ]
+  }
+}
+```
+
+
+## Using Vitorm.Data
+
+``` csharp
+using Vitorm;
+
+namespace App
+{
+    public class Program
+    {
+        static void Main(string[] args)
+        {
+            // #1
+
+            // #2 Create Table
+            Data.Drop<User>();
+            Data.Create<User>();
+
+            // #3 Insert Records
+            Data.Add(new User { id = 1, name = "lith" });
+            Data.AddRange(new[] {
+                new User { id = 2, name = "lith", fatherId = 1 },
+                new User { id = 3, name = "lith", fatherId = 1 }
+            });
+
+            // #4 Query Records
+            {
+                var user = Data.Get<User>(1);
+                var users = Data.Query<User>().Where(u => u.name.Contains("li")).ToList();
+                var sql = Data.Query<User>().Where(u => u.name.Contains("li")).ToExecuteString();
+            }
+
+            // #5 Update Records
+            Data.Update(new User { id = 1, name = "lith1" });
+            Data.UpdateRange(new[] {
+                new User { id = 2, name = "lith2", fatherId = 1 },
+                new User { id = 3, name = "lith3", fatherId = 2 }
+            });
+            Data.Query<User>().Where(u => u.name.Contains("li"))
+                .ExecuteUpdate(u => new User { name = "Lith" + u.id });
+
+            // #6 Delete Records
+            Data.Delete<User>(new User { id = 1, name = "lith1" });
+            Data.DeleteRange(new[] {
+                new User { id = 2, name = "lith2", fatherId = 1 },
+                new User { id = 3, name = "lith3", fatherId = 2 }
+            });
+            Data.DeleteByKey<User>(1);
+            Data.DeleteByKeys<User, int>(new[] { 1, 2 });
+            Data.Query<User>().Where(u => u.name.Contains("li"))
+                .ExecuteDelete();
+
+            // #7 Join Queries
+            {
+                var query =
+                        from user in Data.Query<User>()
+                        from father in Data.Query<User>().Where(father => user.fatherId == father.id).DefaultIfEmpty()
+                        where father != null
+                        orderby user.id
+                        select new { user, father };
+
+                var sql = query.ToExecuteString();
+                var users = query.ToList();
+            }
+
+            // #8 Transactions
+            {
+                using var dbContext = Data.DataProvider<User>().CreateSqlDbContext();
+                using var tran1 = dbContext.BeginTransaction();
+
+                dbContext.Update(new User { id = 4, name = "u4001" });
+
+                using (var tran2 = dbContext.BeginTransaction())
+                {
+                    dbContext.Update(new User { id = 4, name = "u4002" });
+                    // will rollback
+                }
+
+                using (var tran2 = dbContext.BeginTransaction())
+                {
+                    dbContext.Update(new User { id = 4, name = "u4002" });
+                    tran2.Rollback();
+                }
+
+                using (var tran2 = dbContext.BeginTransaction())
+                {
+                    dbContext.Update(new User { id = 4, name = "u4003" });
+                    tran2.Commit();
+                }
+
+                tran1.Commit();
+            }
+
+            // #9 Database Functions
+            {
+                // select * from User where IIF(t0.fatherId is not null, true, false);
+                var query = Data.Query<User>().Where(u => DbFunction.Call<bool>("IIF", u.fatherId != null, true, false));
+                var sql = query.ToExecuteString();
+                var userList = query.ToList();
+            }
+        }
+
+        // Entity Definition
+        [System.ComponentModel.DataAnnotations.Schema.Table("User")]
+        public class User
+        {
+            [System.ComponentModel.DataAnnotations.Key]
+            public int id { get; set; }
+            public string name { get; set; }
+            public DateTime? birth { get; set; }
+            public int? fatherId { get; set; }
+        }
+    }
+}
+```
+
+
+[Test Example](https://github.com/VitormLib/Vitorm/tree/master/test/Vitorm.SqlServer.MsTest)    

src/Vitorm.SqlServer/Vitorm.SqlServer.csproj

@@ -15,6 +15,9 @@
         <Description>orm for SqlServer</Description>
         <PackageProjectUrl>https://github.com/VitormLib/Vitorm</PackageProjectUrl>
         <PackageIcon>vitorm_logo_v1.png</PackageIcon>
+        <RepositoryUrl>https://github.com/VitormLib/Vitorm</RepositoryUrl>
+        <PackageReadmeFile>README.md</PackageReadmeFile>
+        <PackageTags>orm vitorm database sqlserver mssql</PackageTags>
     </PropertyGroup>
 
     <ItemGroup>
@@ -32,4 +35,11 @@
         <ProjectReference Include="..\Vitorm\Vitorm.csproj" />
     </ItemGroup>
 
+    <ItemGroup>
+      <None Update="README.md">
+        <Pack>True</Pack>
+        <PackagePath>\</PackagePath>
+      </None>
+    </ItemGroup>
+
 </Project>

src/Vitorm.Sqlite/README.md

@@ -0,0 +1,307 @@
+
+# Vitorm.Sqlite
+Vitorm.Sqlite is a lightweight yet comprehensive ORM for Sqlite that strikes the perfect balance between simplicity and functionality.     
+Similar to Dapper in its lightweight design, Vitorm offers an easy-to-use, efficient interface for data access.     
+However, it doesn't stop there; Vitorm goes beyond basic ORM capabilities to provide a rich feature set akin to Entity Framework.     
+This means you get the best of both worlds: the performance and simplicity of Dapper with the robust features and flexibility of Entity Framework, making Vitorm an ideal choice for developers seeking a powerful yet streamlined ORM solution.
+> source address: [https://github.com/VitormLib/Vitorm/tree/master/src/Vitorm.Sqlite](https://github.com/VitormLib/Vitorm/tree/master/src/Vitorm.Sqlite "https://github.com/VitormLib/Vitorm/tree/master/src/Vitorm.Sqlite")        
+
+![](https://img.shields.io/github/license/VitormLib/Vitorm.svg)  
+![](https://img.shields.io/github/repo-size/VitormLib/Vitorm.svg)  ![](https://img.shields.io/github/last-commit/VitormLib/Vitorm.svg)  
+ 
+
+| Build | NuGet |
+| -------- | -------- |
+|![](https://github.com/VitormLib/Vitorm/workflows/ki_devops3/badge.svg) | [![](https://img.shields.io/nuget/v/Vitorm.Sqlite.svg)](https://www.nuget.org/packages/Vitorm.Sqlite) ![](https://img.shields.io/nuget/dt/Vitorm.Sqlite.svg) |
+
+
+
+
+# Vitorm.Sqlite Documentation
+This guide will walk you through the steps to set up and use Vitorm.Sqlite.
+
+## Installation
+Before using Vitorm.Sqlite, install the necessary package:
+
+``` bash
+dotnet add package Vitorm.Sqlite
+```
+
+## Using Vitorm.Sqlite
+> This example provides a comprehensive guide to utilizing Vitorm.Sqlite for basic and advanced database operations while maintaining lightweight performance.    
+
+``` csharp
+using Vitorm;
+
+namespace App
+{
+    public class Program
+    {
+        static void Main(string[] args)
+        {
+            // #1 Create an empty SQLite database file and configures Vitorm
+            File.WriteAllBytes("sqlite.db", new byte[0]);
+            using var dbContext = new Vitorm.Sql.SqlDbContext();
+            dbContext.UseSqlite("data source=sqlite.db");
+
+            // #2 Create Table
+            dbContext.Drop<User>();
+            dbContext.Create<User>();
+
+            // #3 Insert Records
+            dbContext.Add(new User { id = 1, name = "lith" });
+            dbContext.AddRange(new[] {
+                new User { id = 2, name = "lith", fatherId = 1 },
+                new User { id = 3, name = "lith", fatherId = 1 }
+            });
+
+            // #4 Query Records
+            {
+                var user = dbContext.Get<User>(1);
+                var users = dbContext.Query<User>().Where(u => u.name.Contains("li")).ToList();
+                var sql = dbContext.Query<User>().Where(u => u.name.Contains("li")).ToExecuteString();
+            }
+
+            // #5 Update Records
+            dbContext.Update(new User { id = 1, name = "lith1" });
+            dbContext.UpdateRange(new[] {
+                new User { id = 2, name = "lith2", fatherId = 1 },
+                new User { id = 3, name = "lith3", fatherId = 2 }
+            });
+            dbContext.Query<User>().Where(u => u.name.Contains("li"))
+                .ExecuteUpdate(u => new User { name = "Lith" + u.id });
+
+            // #6 Delete Records
+            dbContext.Delete<User>(new User { id = 1, name = "lith1" });
+            dbContext.DeleteRange(new[] {
+                new User { id = 2, name = "lith2", fatherId = 1 },
+                new User { id = 3, name = "lith3", fatherId = 2 }
+            });
+            dbContext.DeleteByKey<User>(1);
+            dbContext.DeleteByKeys<User, int>(new[] { 1, 2 });
+            dbContext.Query<User>().Where(u => u.name.Contains("li"))
+                .ExecuteDelete();
+
+            // #7 Join Queries
+            {
+                var query =
+                        from user in dbContext.Query<User>()
+                        from father in dbContext.Query<User>().Where(father => user.fatherId == father.id).DefaultIfEmpty()
+                        where father != null
+                        orderby user.id
+                        select new { user, father };
+
+                var sql = query.ToExecuteString();
+                var users = query.ToList();
+            }
+
+            // #8 Transactions
+            {
+                using var tran1 = dbContext.BeginTransaction();
+                dbContext.Update(new User { id = 4, name = "u4001" });
+
+                using (var tran2 = dbContext.BeginTransaction())
+                {
+                    dbContext.Update(new User { id = 4, name = "u4002" });
+                    // will rollback
+                }
+
+                using (var tran2 = dbContext.BeginTransaction())
+                {
+                    dbContext.Update(new User { id = 4, name = "u4002" });
+                    tran2.Rollback();
+                }
+
+                using (var tran2 = dbContext.BeginTransaction())
+                {
+                    dbContext.Update(new User { id = 4, name = "u4003" });
+                    tran2.Commit();
+                }
+
+                tran1.Commit();
+            }
+
+            // #9 Database Functions
+            {
+                // select * from User where IIF(t0.fatherId is not null, true, false);
+                var query = dbContext.Query<User>().Where(u => DbFunction.Call<bool>("IIF", u.fatherId != null, true, false));
+                var sql = query.ToExecuteString();
+                var userList = query.ToList();
+            }
+        }
+
+        // Entity Definition
+        [System.ComponentModel.DataAnnotations.Schema.Table("User")]
+        public class User
+        {
+            [System.ComponentModel.DataAnnotations.Key]
+            public int id { get; set; }
+            public string name { get; set; }
+            public DateTime? birth { get; set; }
+            public int? fatherId { get; set; }
+        }
+    }
+}
+```
+
+## Explanation
+
+1. **Setup**: Initializes the SQLite database and configures Vitorm.
+2. **Create Table**: Drops and recreates the `User` table.
+3. **Insert Records**: Adds single and multiple user records.
+4. **Query Records**: Retrieves user records using various querying methods.
+5. **Update Records**: Updates single and multiple user records.
+6. **Delete Records**: Deletes single and multiple user records.
+7. **Join Queries**: Performs a join operation between user and father records.
+8. **Transactions**: Demonstrates nested transactions and rollback/commit operations.
+9. **Database Functions**: Uses custom database functions in queries.
+
+
+
+# Vitorm.Data Documentation
+Vitorm.Data is a static class that allows you to use Vitorm without explicitly creating or disposing of a DbContext.
+ 
+## Installation
+
+Before using Vitorm.Data, install the necessary package:
+``` bash
+dotnet add package Vitorm.Data
+dotnet add package Vitorm.Sqlite
+```
+
+## Config settings
+``` json
+// appsettings.json
+{
+  "Vitorm": {
+    "Data": [
+      {
+        "provider": "Sqlite",
+        "namespace": "App",
+        "connectionString": "data source=sqlite.db;"
+      }
+    ]
+  }
+}
+```
+
+
+## Using Vitorm.Data
+
+``` csharp
+using Vit.Extensions.Vitorm_Extensions;
+using Vitorm;
+
+namespace App
+{
+    public class Program
+    {
+        static void Main(string[] args)
+        {
+            // #1 Create an empty SQLite database file and configures Vitorm.Data
+            File.WriteAllBytes("sqlite.db", new byte[0]);
+
+            // #2 Create Table
+            Data.Drop<User>();
+            Data.Create<User>();
+
+            // #3 Insert Records
+            Data.Add(new User { id = 1, name = "lith" });
+            Data.AddRange(new[] {
+                new User { id = 2, name = "lith", fatherId = 1 },
+                new User { id = 3, name = "lith", fatherId = 1 }
+            });
+
+            // #4 Query Records
+            {
+                var user = Data.Get<User>(1);
+                var users = Data.Query<User>().Where(u => u.name.Contains("li")).ToList();
+                var sql = Data.Query<User>().Where(u => u.name.Contains("li")).ToExecuteString();
+            }
+
+            // #5 Update Records
+            Data.Update(new User { id = 1, name = "lith1" });
+            Data.UpdateRange(new[] {
+                new User { id = 2, name = "lith2", fatherId = 1 },
+                new User { id = 3, name = "lith3", fatherId = 2 }
+            });
+            Data.Query<User>().Where(u => u.name.Contains("li"))
+                .ExecuteUpdate(u => new User { name = "Lith" + u.id });
+
+            // #6 Delete Records
+            Data.Delete<User>(new User { id = 1, name = "lith1" });
+            Data.DeleteRange(new[] {
+                new User { id = 2, name = "lith2", fatherId = 1 },
+                new User { id = 3, name = "lith3", fatherId = 2 }
+            });
+            Data.DeleteByKey<User>(1);
+            Data.DeleteByKeys<User, int>(new[] { 1, 2 });
+            Data.Query<User>().Where(u => u.name.Contains("li"))
+                .ExecuteDelete();
+
+            // #7 Join Queries
+            {
+                var query =
+                        from user in Data.Query<User>()
+                        from father in Data.Query<User>().Where(father => user.fatherId == father.id).DefaultIfEmpty()
+                        where father != null
+                        orderby user.id
+                        select new { user, father };
+
+                var sql = query.ToExecuteString();
+                var users = query.ToList();
+            }
+
+            // #8 Transactions
+            {
+                using var dbContext = Data.DataProvider<User>().CreateSqlDbContext();
+                using var tran1 = dbContext.BeginTransaction();
+
+                dbContext.Update(new User { id = 4, name = "u4001" });
+
+                using (var tran2 = dbContext.BeginTransaction())
+                {
+                    dbContext.Update(new User { id = 4, name = "u4002" });
+                    // will rollback
+                }
+
+                using (var tran2 = dbContext.BeginTransaction())
+                {
+                    dbContext.Update(new User { id = 4, name = "u4002" });
+                    tran2.Rollback();
+                }
+
+                using (var tran2 = dbContext.BeginTransaction())
+                {
+                    dbContext.Update(new User { id = 4, name = "u4003" });
+                    tran2.Commit();
+                }
+
+                tran1.Commit();
+            }
+
+            // #9 Database Functions
+            {
+                // select * from User where IIF(t0.fatherId is not null, true, false);
+                var query = Data.Query<User>().Where(u => DbFunction.Call<bool>("IIF", u.fatherId != null, true, false));
+                var sql = query.ToExecuteString();
+                var userList = query.ToList();
+            }
+        }
+
+        // Entity Definition
+        [System.ComponentModel.DataAnnotations.Schema.Table("User")]
+        public class User
+        {
+            [System.ComponentModel.DataAnnotations.Key]
+            public int id { get; set; }
+            public string name { get; set; }
+            public DateTime? birth { get; set; }
+            public int? fatherId { get; set; }
+        }
+    }
+}
+```
+
+
+[Test Example](https://github.com/VitormLib/Vitorm/tree/master/test/Vitorm.Sqlite.MsTest)    

src/Vitorm.Sqlite/Vitorm.Sqlite.csproj

@@ -15,6 +15,9 @@
         <Description>orm for Sqlite</Description>
         <PackageProjectUrl>https://github.com/VitormLib/Vitorm</PackageProjectUrl>
         <PackageIcon>vitorm_logo_v1.png</PackageIcon>
+        <PackageReadmeFile>README.md</PackageReadmeFile>
+        <PackageTags>orm vitorm database sqlite</PackageTags>
+        <RepositoryUrl>https://github.com/VitormLib/Vitorm</RepositoryUrl>
     </PropertyGroup>
 
     <ItemGroup>
@@ -32,4 +35,11 @@
         <ProjectReference Include="..\Vitorm\Vitorm.csproj" />
     </ItemGroup>
 
+    <ItemGroup>
+      <None Update="README.md">
+        <Pack>True</Pack>
+        <PackagePath>\</PackagePath>
+      </None>
+    </ItemGroup>
+
 </Project>

src/Vitorm/Vitorm.csproj

@@ -17,7 +17,7 @@
         <PackageIcon>vitorm_logo_v1.png</PackageIcon>
         <PackageReadmeFile>README.md</PackageReadmeFile>
         <RepositoryUrl>https://github.com/VitormLib/Vitorm</RepositoryUrl>
-        <PackageTags>orm</PackageTags>
+        <PackageTags>orm vitorm database mysql sqlserver sqlite clickhouse elasticsearch</PackageTags>
     </PropertyGroup>
 
     <ItemGroup>
@@ -26,8 +26,8 @@
             <PackagePath>\</PackagePath>
         </None>
         <None Include="..\..\README.md">
-            <Pack>True</Pack>
-            <PackagePath>\</PackagePath>
+          <Pack>True</Pack>
+          <PackagePath>\</PackagePath>
         </None>
     </ItemGroup>
 

test/Vitorm.Data.MsTest/Vitorm.Data.MsTest.csproj

@@ -18,8 +18,6 @@
     </ItemGroup>
 
     <ItemGroup>
-        <ProjectReference Include="..\..\..\Vitorm.ClickHouse\src\Vitorm.ClickHouse\Vitorm.ClickHouse.csproj" />
-        <ProjectReference Include="..\..\..\Vitorm.ElasticSearch\src\Vitorm.ElasticSearch\Vitorm.ElasticSearch.csproj" />
         <ProjectReference Include="..\..\..\Vitorm\src\Vitorm.MySql\Vitorm.MySql.csproj" />
         <ProjectReference Include="..\..\..\Vitorm\src\Vitorm.Sqlite\Vitorm.Sqlite.csproj" />
         <ProjectReference Include="..\..\..\Vitorm\src\Vitorm.SqlServer\Vitorm.SqlServer.csproj" />