add playground hint

Author: ahmad-moussawi

advanced.md

@@ -5,8 +5,11 @@
 Sometimes you need to do some actions only when certain conditions are met, in these cases you can use the `When(condition, whenTrue, whenFalse = null)` method.
 
 ```cs
+//:playground
 var query = db.Query("Transactions");
 
+var amount = 100;
+
 query.When(
     amount > 0,
     q => q.Select("Debit as Amount"),
@@ -18,6 +21,7 @@ query.When(
 is the same as
 
 ```cs
+//:playground
 var query = db.Query("Transactions");
 
 if(amount > 0)
@@ -57,6 +61,7 @@ This is helpful when you want to apply some native functions, that are available
 ### Casting Example
 
 ```cs
+//:playground
 var query = new Query("Posts")
     .Select("Id", "Title")
     .ForPostgres(q => q.SelectRaw("[Date]::date"))
@@ -87,13 +92,14 @@ Another example is to generate a date series between two given dates, you can us
 
 
 ```cs
+//:playground
 var now = DateTime.UtcNow;
 var format = "yyyy-MM-dd";
 
 DateTime from = now.AddDays(-5).ToString(format),
          now.ToString(format);
 
-var rangeQuery = new Query()
+var query = new Query()
 
 .ForPostgres(q =>
 

combine.md

@@ -9,6 +9,7 @@ the above methods accept either an instance of `Query` or a labmda expression
 
 
 ```cs
+//:playground
 var phones = new Query("Phones");
 var laptops = new Query("Laptops");
 
@@ -23,6 +24,7 @@ var mobiles = laptops.Union(phones);
 Or by using the labmda overload
 
 ```cs
+//:playground
 var mobiles = new Query("Laptops").ExceptAll(q => q.From("OldLaptops"));
 ```
 
@@ -35,6 +37,7 @@ var mobiles = new Query("Laptops").ExceptAll(q => q.From("OldLaptops"));
 You can always use the `CombineRaw` method to append raw expressions
 
 ```cs
+//:playground
 var mobiles = new Query("Laptops").CombineRaw("union all select * from OldLaptops");
 ```
 
@@ -46,6 +49,7 @@ Off course you can use the table identifier characters `[` and `]` to instruct S
 
 
 ```cs
+//:playground
 var mobiles = new Query("Laptops").CombineRaw("union all select * from [OldLaptops]");
 ```
 

compilers.md

@@ -10,6 +10,7 @@ Currently, SqlKata query builder supports natively the following compilers **Sql
 Theoretically the output of different compilers should be similar, this is true for the 80% of the cases, however in some edge cases the output can be very different, for instance take a look how the `Limit` and `Offset` clause get compiled in each compiler
 
 ```cs
+//:playground
 new Query("Posts").Limit(10).Offset(20);
 ```
 

cte.md

@@ -15,6 +15,7 @@ In Sql, CTE is represented as a `with` clause.
 To add a CTE to your query simply use the `With` method.
 
 ```cs
+//:playground
 var activePosts = new Query("Comments")
     .Select("PostId")
     .SelectRaw("count(1) as Count")
@@ -38,6 +39,7 @@ SELECT [Posts].*, [ActivePosts].[Count] FROM [Posts] INNER JOIN [ActivePosts] ON
 You can use the `WithRaw` method if you want to pass a raw Sql Expression.
 
 ```cs
+//:playground
 var query = new Query("Posts")
     .WithRaw("ActivePosts", "select PostId, count(1) as count from Comments having count(1) > ?", new [] {50}) // now you can consider ActivePosts as a regular table in the database
     .Join("ActivePosts", "ActivePosts.PostId", "Posts.Id")

from.md

@@ -4,12 +4,14 @@
 The `Query` constructor takes an optional parameter to set the `from` clause
 
 ```cs
+//:playground
 new Query("Posts");
 ```
 
 Or you can use the `From` method to set it
 
 ```cs
+//:playground
 new Query().From("Posts");
 ```
 
@@ -21,6 +23,7 @@ SELECT * FROM [Posts]
 To alias the table you should use the `as` syntax
 
 ```cs
+//:playground
 new Query("Posts as p")
 ```
 
@@ -33,6 +36,7 @@ SELECT * FROM [Posts] AS [p]
 You can select from a sub query by passing a `Query` instance to the `From` method or you can use the `Lambda` function overload.
 
 ```cs
+//:playground
 var fewMonthsAgo = DateTime.UtcNow.AddMonths(-6);
 var oldPostsQuery = new Query("Posts").Where("Date", "<", fewMonthsAgo).As("old");
 
@@ -47,6 +51,7 @@ SELECT * FROM (SELECT * FROM [Posts] WHERE [Date] < '2017-06-01 6:31:26') AS [ol
 You can rewrite the same query by using the `Lambda` function overload
 
 ```cs
+//:playground
 new Query().From(q =>
     q.From("Posts").Where("Date", "<", fewMonthsAgo).As("old")
 ).OrderByDesc("Date");

group.md

@@ -3,6 +3,7 @@
 ## GroupBy
 
 ```cs
+//:playground
 var query = new Query("Comments")
                 .Select("PostId")
                 .SelectRaw("count(1) as count")
@@ -16,6 +17,7 @@ SELECT [PostId], count(1) as count FROM [Comments] GROUP BY [PostId]
 ## GroupByRaw
 
 ```cs
+//:playground
 var query = new Query("Companies")
     .Select("Profit")
     .SelectRaw("COUNT(*) as count")

having.md

@@ -3,6 +3,7 @@
 ## Having
 
 ```cs
+//:playground
 var commentsCount = new Query("Comments").Select("PostId").SelectRaw("count(1) as Count").GroupBy("PostId");
 
 var query = new Query().From(commentsCount).Having("Count", ">", 100);
@@ -17,6 +18,7 @@ SELECT * FROM (SELECT [PostId], count(1) as Count FROM [Comments] GROUP BY [Post
 ## HavingRaw
 
 ```cs
+//:playground
 var query = new Query("Comments").Select("PostId").SelectRaw("count(1) as Count").GroupBy("PostId").HavingRaw("count(1) > 50");
 ```
 

join.md

@@ -5,6 +5,7 @@
 To apply an inner join use the `Join` method
 
 ```cs
+//:playground
 var query = new Query("Posts").Join("Authors", "Authors.Id", "Posts.AuthorId");
 ```
 
@@ -17,12 +18,14 @@ SELECT * FROM [Posts] INNER JOIN [Authors] ON [Authors].[Id] = [Posts].[AuthorId
 The 4th parameter is optional and default to `=`, pass any other operator to override the join operator.
 
 ```cs
+//:playground
 var query = new Query("Posts").Join("Comments", "Comments.Date", "Posts.Date", ">");
 ```
 
 ## Join with a Sub Query
 
 ```cs
+//:playground
 var topComments = new Query("Comments").OrderByDesc("Likes").Limit(10);
 
 var posts = new Query("Posts").LeftJoin(
@@ -44,7 +47,8 @@ SELECT * FROM [Posts] LEFT JOIN (
 In some advanced cases you may need to apply some constraints on the join clause.
 
 ```cs
-var comments = new Query("comments").LeftJoin("Posts", j => 
+//:playground
+var comments = new Query("comments").LeftJoin("Posts", j =>
     j.On("Posts.Id", "Comments.Id").WhereNotNull("Comments.AuthorId")
 );
 ```

limit.md

@@ -3,6 +3,7 @@
 `Limit` and `Offset` allows you to limit the number of results returned from the database, this method is highly correlated with the `OrderBy` and `OrderByDesc` methods.
 
 ```cs
+//:playground
 var latestPosts = new Query("Posts").OrderByDesc("Date").Limit(10)
 ```
 
@@ -27,6 +28,7 @@ SELECT * FROM `Posts` ORDER BY `Date` DESC LIMIT 10
 if you want to skip some records, use the `Offset` method.
 
 ```cs
+//:playground
 var latestPosts = new Query("Posts").OrderByDesc("Date").Limit(10).Offset(5);
 ```
 
@@ -55,6 +57,7 @@ SELECT * FROM `Posts` ORDER BY `Date` DESC LIMIT 10 OFFSET 5
 You can use the `ForPage` method to easily paginate your data.
 
 ```cs
+//:playground
 var posts = new Query("Posts").OrderByDesc("Date").ForPage(2);
 ```
 
@@ -64,6 +67,7 @@ By default this method will return `15` rows per page, you can override this val
 
 
 ```cs
+//:playground
 var posts = new Query("Posts").OrderByDesc("Date").ForPage(3, 50);
 ```
 

order.md

@@ -3,6 +3,7 @@
 ## OrderBy
 
 ```cs
+//:playground
 var query = new Query("Comments").OrderBy("Date").OrderByDesc("Name");
 ```
 
@@ -15,6 +16,7 @@ SELECT * FROM [Comments] ORDER BY [Date], [Name] DESC
 ## OrderByRaw
 
 ```cs
+//:playground
 var query = new Query("Comments").OrderByRaw("[Likes] DESC NULLS LAST")
 ```
 

select.md

@@ -4,6 +4,7 @@
 Select a single or many columns
 
 ```cs
+//:playground
 new Query("Posts").Select("Id", "Title", "CreatedAt as Date");
 ```
 
@@ -17,9 +18,10 @@ SELECT [Id], [Title], [CreatedAt] AS [Date] FROM [Posts]
 Select from a sub query
 
 ```cs
-var countQuery = new Query("Comments").WhereColumns("Comments.PostId", "Posts.Id").AsCount();
+//:playground
+var countQuery = new Query("Comments").WhereColumns("Comments.PostId", "=", "Posts.Id").AsCount();
 
-new Query("Posts").Select("Id").Select(countQuery, "CommentsCount");
+var query = new Query("Posts").Select("Id").Select(countQuery, "CommentsCount");
 ```
 
 ```sql
@@ -30,6 +32,7 @@ SELECT [Id], (SELECT COUNT(*) AS [count] FROM [Comments] WHERE [Comments].[PostI
 Your friend when you need the full freedom
 
 ```cs
+//:playground
 new Query("Posts").Select("Id").SelectRaw("count(1) over(partition by AuthorId) as PostsByAuthor")
 ```
 
@@ -42,6 +45,7 @@ You can wrap your identifier inside `[` and `]` so they get recognized by SqlKat
 
 
 ```cs
+//:playground
 new Query("Posts").Select("Id").SelectRaw("count(1) over(partition by [AuthorId]) as [PostsByAuthor]")
 ```
 
@@ -69,6 +73,7 @@ SELECT `Id`, count(1) over(partition by `AuthorId`) as `PostsByAuthor` FROM `Pos
 Starting **v1.1.2**, you can use the Braces Expansions feature, to select multiple columns at the same time. This will allow you to write the same query in a more compact way.
 
 ```cs
+//:playground
 new Query("Users")
     .Join("Profiles", "Profiles.UserId", "Users.Id")
     .Select("Users.{Id, Name, LastName}", "Profiles.{GithubUrl, Website}")
@@ -77,6 +82,7 @@ new Query("Users")
 Same as writing
 
 ```cs
+//:playground
 new Query("Users")
     .Join("Profiles", "Profiles.UserId", "Users.Id")
     .Select("Users.Id", "Users.Name", "Users.LastName", "Profiles.GithubUrl", "Profiles.Website")

update.md

@@ -4,6 +4,7 @@
 
 ## Insert
 ```cs
+//:playground
 var query = new Query("Books").AsInsert(new {
     Title = "Toyota Kata",
     CreatedAt = new DateTime(2009, 8, 4),
@@ -23,6 +24,7 @@ INSERT INTO [Books] ([Name], [CreatedAt], [Author]) VALUES ('Toyota Kata', '2009
 you can use the insert many overload to insert multiple records
 
 ```cs
+//:playground
 var cols = new [] {"Name", "Price"};
 
 var data = new [] {
@@ -44,6 +46,7 @@ INSERT INTO [Products] ([Name], [Price]) VALUES ("A", 1000), ("B", 2000), ("C",
 You can also insert records for the result of another Select Query.
 
 ```cs
+//:playground
 var cols = new [] { "Id", "Name", "Address" };
 new Query("ActiveUsers").AsInsert(cols, new Query("Users").Where("Active", 1));
 ```
@@ -55,6 +58,7 @@ INSERT INTO [ActiveUsers] ([Id], [Name], [Address]) SELECT * FROM [Users] WHERE
 ## Update
 
 ```cs
+//:playground
 var query = new Query("Posts").WhereNull("AuthorId").AsUpdate(new {
     AuthorId = 10
 });
@@ -67,6 +71,7 @@ UPDATE [Posts] SET [AuthorId] = 10 WHERE [AuthorId] IS NULL
 ## Delete
 
 ```cs
+//:playground
 var query = new Query("Posts").Where("Date", ">", DateTime.UtcNow.AddDays(-30)).AsDelete();
 ```
 

where-date.md

@@ -57,6 +57,7 @@ SELECT * FROM `Posts` WHERE TIME(`CreatedAt`) > '16:30'
 For example to get the posts created in the first of February.
 
 ```cs
+//:playground
 new Query("Posts").WhereDatePart("day", "CreatedAt", 1).WhereDatePart("month", "CreatedAt", 2);
 ```
 

where-string.md

@@ -9,6 +9,7 @@ To override this behavior you can pass a boolean `true` to the last parameter `c
 
 
 ```cs
+//:playground
 new Query("Posts").WhereEnds("Title", "Book")
 ```