✨ add basic example

Author: bert2

Json5.sln

@@ -16,6 +16,10 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Json5.Tests", "Json5.Tests\Json5.Tests.csproj", "{2D81813A-D9A3-49C5-9940-70500CF2F42D}"
 EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "examples", "examples", "{58D535B0-AE32-4202-8D70-B9206667D248}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "BasicUsage", "examples\BasicUsage\BasicUsage.csproj", "{E7D3925C-54A8-4B40-95A2-FA246F5A4A6B}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -30,8 +34,15 @@ Global
 		{2D81813A-D9A3-49C5-9940-70500CF2F42D}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{2D81813A-D9A3-49C5-9940-70500CF2F42D}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{2D81813A-D9A3-49C5-9940-70500CF2F42D}.Release|Any CPU.Build.0 = Release|Any CPU
+		{E7D3925C-54A8-4B40-95A2-FA246F5A4A6B}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{E7D3925C-54A8-4B40-95A2-FA246F5A4A6B}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{E7D3925C-54A8-4B40-95A2-FA246F5A4A6B}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{E7D3925C-54A8-4B40-95A2-FA246F5A4A6B}.Release|Any CPU.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE
 	EndGlobalSection
+	GlobalSection(NestedProjects) = preSolution
+		{E7D3925C-54A8-4B40-95A2-FA246F5A4A6B} = {58D535B0-AE32-4202-8D70-B9206667D248}
+	EndGlobalSection
 EndGlobal

examples/BasicUsage/BasicUsage.csproj

@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net9.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\..\Json5\Json5.csproj" />
+  </ItemGroup>
+
+</Project>

examples/BasicUsage/Program.cs

@@ -0,0 +1,41 @@
+using System.Text.Json;
+
+var json5 =
+    """
+    {
+        description: 'This is a basic example showing how to translate JSON5 to JSON, \
+                      how to parse JSON5 as a `System.Text.Json.Nodes.JsonNode`, \
+                      and how to deserialize JSON5 to a C# type.',
+        nums: [.1, -Infinity, NaN, 2.e-3, 0b101, 0xBEEF],
+    }
+    """;
+
+Console.WriteLine(
+    $"""
+    JSON5:
+
+    {json5}
+
+    Translated to JSON:
+
+    {Json5.Parser.Translate(json5)}
+
+    Parsed as JsonNode:
+
+    {Json5.Parser.Parse(json5)}
+
+    """);
+
+// `JsonSerializerOptions.Web` makes property names case-insensitive and allows the
+// floating point literals "NaN" and "Infinity".
+Console.WriteLine(
+    $"""
+    Deserialized as record:
+
+    {Json5.Parser.Parse(json5).Deserialize<Foo>(JsonSerializerOptions.Web)}
+    """);
+
+public record Foo(string Description, double[] Nums) {
+    public override string ToString()
+        => $"Foo {{ Description = {Description[..15]}..., Nums = [{string.Join(", ", Nums)}] }}";
+}