WIP: Prepare next major release of Thoth.Json ecosystem

.config/dotnet-tools.json

@@ -3,7 +3,7 @@
   "isRoot": true,
   "tools": {
     "paket": {
-      "version": "5.226.0",
+      "version": "5.247.3",
       "commands": [
         "paket"
       ]
@@ -13,6 +13,12 @@
       "commands": [
         "fake"
       ]
+    },
+    "fornax": {
+      "version": "0.13.1",
+      "commands": [
+        "fornax"
+      ]
     }
   }
 }

.gitignore

@@ -268,3 +268,4 @@ demos/Thoth\.Elmish\.Demo/output/
 \.ionide/
 
 docs_deploy/
+docs/_public/

.vscode/settings.json

@@ -0,0 +1,5 @@
+{
+    "files.trimTrailingWhitespace": true,
+    "files.insertFinalNewline": true,
+    "files.trimFinalNewlines": true
+}

docs/index.md → DOCUMENTATION.md

@@ -1,14 +1,28 @@
----
-title: Thoth.Json
----
-
-[[toc]]
-
-This documentation is for `Thoth.Json` v4, documentation for older versions can be found here:
-
-- [Thoth.Json v1](/Thoth.Json/legacy/v1.html)
-- [Thoth.Json v2](/Thoth.Json/legacy/v2.html)
-- [Thoth.Json v3](/Thoth.Json/legacy/v3.html)
+# Thoth.JSON documentation
+
+## Table of contents
+
+<!-- TOC -->
+
+- [Table of contents](#table-of-contents)
+- [Decoder](#decoder)
+    - [What is a Decoder?](#what-is-a-decoder)
+    - [Primitives decoders](#primitives-decoders)
+    - [Collections](#collections)
+    - [Decoding Objects](#decoding-objects)
+- [Encoder](#encoder)
+    - [How to use it?](#how-to-use-it)
+- [Auto coders](#auto-coders)
+    - [Auto decoder](#auto-decoder)
+    - [Auto encoder](#auto-encoder)
+    - [Extra coders](#extra-coders)
+    - [Decoding int64, decimal or bigint](#decoding-int64-decimal-or-bigint)
+    - [Caching](#caching)
+- [.Net & NetCore support](#net--netcore-support)
+    - [Code sample](#code-sample)
+    - [Giraffe](#giraffe)
+
+<!-- /TOC -->
 
 ## Decoder
 
@@ -97,10 +111,10 @@ There are special decoders for the following collections.
 ```fsharp
 open Thoth.Json
 
-> Decode.fromString (array int) "[1, 2, 3]"
+> Decode.fromString (Decode.array int) "[1, 2, 3]"
 val it : Result<int [], string> =  Ok [|1, 2, 3|]
 
-> Decode.fromString (list string) """["Maxime", "Alfonso", "Vesper"]"""
+> Decode.fromString (Decode.list string) """["Maxime", "Alfonso", "Vesper"]"""
 val it : Result<string list, string> = Ok ["Maxime", "Alfonso", "Vesper"]
 
 > Decode.fromString (Decode.index 1 Decode.string) """["maxime", "alfonso", "steffen"]"""

Thoth.Json.Projets.sln

@@ -0,0 +1,81 @@
+
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 16
+VisualStudioVersion = 16.0.29709.97
+MinimumVisualStudioVersion = 15.0.26124.0
+Project("{F2A71F9B-5D33-465A-A702-920D77279786}") = "Thoth.Json", "src\Thoth.Json.fsproj", "{B967432B-CE16-480B-B364-B5A6B18AB3DC}"
+EndProject
+Project("{F2A71F9B-5D33-465A-A702-920D77279786}") = "Tests.Thoth.Json.FableRuntime", "tests\Tests.Thoth.Json.FableRuntime.fsproj", "{77152A74-CFC7-437C-9415-3FC1F3593DA0}"
+EndProject
+Project("{F2A71F9B-5D33-465A-A702-920D77279786}") = "Tests.Thoth.Json.NetRuntime", "tests\Tests.Thoth.Json.NetRuntime.fsproj", "{BC1BD8D5-D518-4C04-89D9-9E62A932D5E6}"
+EndProject
+Project("{F2A71F9B-5D33-465A-A702-920D77279786}") = "Thoth.Json.FableRuntime", "src\Thoth.Json.FableRuntime.fsproj", "{4C938BA5-EF95-4BB0-B1B5-C04F188DB17E}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Any CPU = Debug|Any CPU
+		Debug|x64 = Debug|x64
+		Debug|x86 = Debug|x86
+		Release|Any CPU = Release|Any CPU
+		Release|x64 = Release|x64
+		Release|x86 = Release|x86
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{B967432B-CE16-480B-B364-B5A6B18AB3DC}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{B967432B-CE16-480B-B364-B5A6B18AB3DC}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{B967432B-CE16-480B-B364-B5A6B18AB3DC}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{B967432B-CE16-480B-B364-B5A6B18AB3DC}.Debug|x64.Build.0 = Debug|Any CPU
+		{B967432B-CE16-480B-B364-B5A6B18AB3DC}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{B967432B-CE16-480B-B364-B5A6B18AB3DC}.Debug|x86.Build.0 = Debug|Any CPU
+		{B967432B-CE16-480B-B364-B5A6B18AB3DC}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{B967432B-CE16-480B-B364-B5A6B18AB3DC}.Release|Any CPU.Build.0 = Release|Any CPU
+		{B967432B-CE16-480B-B364-B5A6B18AB3DC}.Release|x64.ActiveCfg = Release|Any CPU
+		{B967432B-CE16-480B-B364-B5A6B18AB3DC}.Release|x64.Build.0 = Release|Any CPU
+		{B967432B-CE16-480B-B364-B5A6B18AB3DC}.Release|x86.ActiveCfg = Release|Any CPU
+		{B967432B-CE16-480B-B364-B5A6B18AB3DC}.Release|x86.Build.0 = Release|Any CPU
+		{77152A74-CFC7-437C-9415-3FC1F3593DA0}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{77152A74-CFC7-437C-9415-3FC1F3593DA0}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{77152A74-CFC7-437C-9415-3FC1F3593DA0}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{77152A74-CFC7-437C-9415-3FC1F3593DA0}.Debug|x64.Build.0 = Debug|Any CPU
+		{77152A74-CFC7-437C-9415-3FC1F3593DA0}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{77152A74-CFC7-437C-9415-3FC1F3593DA0}.Debug|x86.Build.0 = Debug|Any CPU
+		{77152A74-CFC7-437C-9415-3FC1F3593DA0}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{77152A74-CFC7-437C-9415-3FC1F3593DA0}.Release|Any CPU.Build.0 = Release|Any CPU
+		{77152A74-CFC7-437C-9415-3FC1F3593DA0}.Release|x64.ActiveCfg = Release|Any CPU
+		{77152A74-CFC7-437C-9415-3FC1F3593DA0}.Release|x64.Build.0 = Release|Any CPU
+		{77152A74-CFC7-437C-9415-3FC1F3593DA0}.Release|x86.ActiveCfg = Release|Any CPU
+		{77152A74-CFC7-437C-9415-3FC1F3593DA0}.Release|x86.Build.0 = Release|Any CPU
+		{BC1BD8D5-D518-4C04-89D9-9E62A932D5E6}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{BC1BD8D5-D518-4C04-89D9-9E62A932D5E6}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{BC1BD8D5-D518-4C04-89D9-9E62A932D5E6}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{BC1BD8D5-D518-4C04-89D9-9E62A932D5E6}.Debug|x64.Build.0 = Debug|Any CPU
+		{BC1BD8D5-D518-4C04-89D9-9E62A932D5E6}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{BC1BD8D5-D518-4C04-89D9-9E62A932D5E6}.Debug|x86.Build.0 = Debug|Any CPU
+		{BC1BD8D5-D518-4C04-89D9-9E62A932D5E6}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{BC1BD8D5-D518-4C04-89D9-9E62A932D5E6}.Release|Any CPU.Build.0 = Release|Any CPU
+		{BC1BD8D5-D518-4C04-89D9-9E62A932D5E6}.Release|x64.ActiveCfg = Release|Any CPU
+		{BC1BD8D5-D518-4C04-89D9-9E62A932D5E6}.Release|x64.Build.0 = Release|Any CPU
+		{BC1BD8D5-D518-4C04-89D9-9E62A932D5E6}.Release|x86.ActiveCfg = Release|Any CPU
+		{BC1BD8D5-D518-4C04-89D9-9E62A932D5E6}.Release|x86.Build.0 = Release|Any CPU
+		{4C938BA5-EF95-4BB0-B1B5-C04F188DB17E}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{4C938BA5-EF95-4BB0-B1B5-C04F188DB17E}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{4C938BA5-EF95-4BB0-B1B5-C04F188DB17E}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{4C938BA5-EF95-4BB0-B1B5-C04F188DB17E}.Debug|x64.Build.0 = Debug|Any CPU
+		{4C938BA5-EF95-4BB0-B1B5-C04F188DB17E}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{4C938BA5-EF95-4BB0-B1B5-C04F188DB17E}.Debug|x86.Build.0 = Debug|Any CPU
+		{4C938BA5-EF95-4BB0-B1B5-C04F188DB17E}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{4C938BA5-EF95-4BB0-B1B5-C04F188DB17E}.Release|Any CPU.Build.0 = Release|Any CPU
+		{4C938BA5-EF95-4BB0-B1B5-C04F188DB17E}.Release|x64.ActiveCfg = Release|Any CPU
+		{4C938BA5-EF95-4BB0-B1B5-C04F188DB17E}.Release|x64.Build.0 = Release|Any CPU
+		{4C938BA5-EF95-4BB0-B1B5-C04F188DB17E}.Release|x86.ActiveCfg = Release|Any CPU
+		{4C938BA5-EF95-4BB0-B1B5-C04F188DB17E}.Release|x86.Build.0 = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+	GlobalSection(NestedProjects) = preSolution
+	EndGlobalSection
+	GlobalSection(ExtensibilityGlobals) = postSolution
+		SolutionGuid = {138D696D-3E83-4254-99CF-C6A0675E97E7}
+	EndGlobalSection
+EndGlobal

config.fsx

@@ -0,0 +1,42 @@
+#r "_lib/Fornax.Core.dll"
+
+open Config
+open System.IO
+
+let postPredicate (projectRoot: string, page: string) =
+    let fileName = Path.Combine(projectRoot,page)
+    let ext = Path.GetExtension page
+    if ext = ".md" then
+        let ctn = File.ReadAllText fileName
+        ctn.Contains("layout: post")
+    else
+        false
+
+let staticPredicate (projectRoot: string, page: string) =
+    let ext = Path.GetExtension page
+    if page.Contains "_public" ||
+       page.Contains "_bin" ||
+       page.Contains "_lib" ||
+       page.Contains "_data" ||
+       page.Contains "_settings" ||
+       page.Contains "_config.yml" ||
+       page.Contains ".sass-cache" ||
+       page.Contains ".git" ||
+       page.Contains ".ionide" ||
+       ext = ".fsx"
+    then
+        false
+    else
+        true
+
+let config = {
+    Generators = [
+        {Script = "less.fsx"; Trigger = OnFileExt ".less"; OutputFile = ChangeExtension "css" }
+        {Script = "sass.fsx"; Trigger = OnFileExt ".scss"; OutputFile = ChangeExtension "css" }
+        {Script = "post.fsx"; Trigger = OnFilePredicate postPredicate; OutputFile = ChangeExtension "html" }
+        {Script = "staticfile.fsx"; Trigger = OnFilePredicate staticPredicate; OutputFile = SameFileName }
+        {Script = "index.fsx"; Trigger = Once; OutputFile = NewFileName "index.html" }
+        {Script = "about.fsx"; Trigger = Once; OutputFile = NewFileName "about.html" }
+        {Script = "contact.fsx"; Trigger = Once; OutputFile = NewFileName "contact.html" }
+    ]
+}