Publish Blazor example

.github/workflows/main.yml

@@ -1,19 +1,29 @@
 name: Pure.DI check
 
-on: [push]
+on: [ push ]
 
 jobs:
   build:
 
     runs-on: ubuntu-latest
-
-    steps:
-    - uses: actions/checkout@v4
-
-    - name: Setup dotnet
-      uses: actions/setup-dotnet@v3
-      with:
-        dotnet-version: '8.0.x'
 
-    - name: Build and check
-      run: dotnet run --project ./build -- check
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup dotnet
+        uses: actions/setup-dotnet@v3
+        with:
+          dotnet-version: '8.0.x'
+
+      #- name: Build and check
+        #run: dotnet run --project ./build -- check
+
+      - name: Publish Blazor example
+        run: dotnet run --project ./build -- publish
+
+      - name: Commit wwwroot to GitHub Pages
+        uses: JamesIves/[email protected]
+        with:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          BRANCH: gh-pages
+          FOLDER: samples/BlazorWebAssemblyApp/bin/wwwroot

.gitignore

@@ -14,3 +14,4 @@ benchmarks/data/results/*.md
 _ReSharper.Caches/
 .idea
 .logs
+

.run/Publish Blazor example.run.xml

@@ -0,0 +1,20 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="Publish Blazor example" type="DotNetProject" factoryName=".NET Project">
+    <option name="EXE_PATH" value="$PROJECT_DIR$/build/bin/roslyn4.3/Debug/net8.0/build.exe" />
+    <option name="PROGRAM_PARAMETERS" value="publish" />
+    <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$" />
+    <option name="PASS_PARENT_ENVS" value="1" />
+    <option name="USE_EXTERNAL_CONSOLE" value="0" />
+    <option name="USE_MONO" value="0" />
+    <option name="RUNTIME_ARGUMENTS" value="" />
+    <option name="PROJECT_PATH" value="$PROJECT_DIR$/build/build.csproj" />
+    <option name="PROJECT_EXE_PATH_TRACKING" value="1" />
+    <option name="PROJECT_ARGUMENTS_TRACKING" value="1" />
+    <option name="PROJECT_WORKING_DIRECTORY_TRACKING" value="0" />
+    <option name="PROJECT_KIND" value="DotNetCore" />
+    <option name="PROJECT_TFM" value="net8.0" />
+    <method v="2">
+      <option name="Build" />
+    </method>
+  </configuration>
+</component>

build/Program.cs

@@ -2,20 +2,24 @@
 
 DI.Setup(nameof(Composition))
     .Root<RootTarget>("RootTarget")
+
     .DefaultLifetime(Lifetime.PerBlock)
-    .Bind<RootCommand>().To<RootCommand>()
-    .Bind<Settings>().To<Settings>()
+
+    .Bind().To<RootCommand>()
+    .Bind().To<Settings>()
     .Bind<ITeamCityArtifactsWriter>().To(_ => GetService<ITeamCityWriter>())
-    .Bind<INuGet>().To(_ => GetService<INuGet>())
+    .Bind().To(_ => GetService<INuGet>())
+
     // Targets
-    .Bind<IInitializable, ITarget<Package>>(typeof(GeneratorTarget)).To<GeneratorTarget>()
-    .Bind<IInitializable, ITarget<IReadOnlyCollection<Library>>>(typeof(LibrariesTarget)).To<LibrariesTarget>()
-    .Bind<IInitializable, ITarget<IReadOnlyCollection<Package>>>(typeof(CompatibilityCheckTarget)).To<CompatibilityCheckTarget>()
-    .Bind<IInitializable, ITarget<IReadOnlyCollection<Package>>>(typeof(PackTarget)).To<PackTarget>()
-    .Bind<IInitializable>(typeof(ReadmeTarget)).To<ReadmeTarget>()
-    .Bind<IInitializable, ITarget<int>>(typeof(BenchmarksTarget)).To<BenchmarksTarget>()
-    .Bind<IInitializable>(typeof(DeployTarget)).To<DeployTarget>()
-    .Bind<IInitializable>(typeof(TemplateTarget)).To<TemplateTarget>()
-    .Bind<IInitializable>(typeof(UpdateTarget)).To<UpdateTarget>();
+    .Bind(Tag.Type).To<GeneratorTarget>()
+    .Bind(Tag.Type).To<LibrariesTarget>()
+    .Bind(Tag.Type).To<CompatibilityCheckTarget>()
+    .Bind(Tag.Type).To<PackTarget>()
+    .Bind(Tag.Type).To<ReadmeTarget>()
+    .Bind(Tag.Type).To<BenchmarksTarget>()
+    .Bind(Tag.Type).To<DeployTarget>()
+    .Bind(Tag.Type).To<TemplateTarget>()
+    .Bind(Tag.Type).To<UpdateTarget>()
+    .Bind(Tag.Type).To<PublishBlazorTarget>();
 
 return await new Composition().RootTarget.RunAsync(CancellationToken.None);

build/PublishBlazorTarget.cs

@@ -0,0 +1,46 @@
+// ReSharper disable StringLiteralTypo
+// ReSharper disable HeapView.DelegateAllocation
+// ReSharper disable HeapView.ClosureAllocation
+// ReSharper disable ClassNeverInstantiated.Global
+// ReSharper disable ReturnTypeCanBeEnumerable.Local
+// ReSharper disable InvertIf
+
+namespace Build;
+
+internal class PublishBlazorTarget(
+    Commands commands)
+    : IInitializable, ITarget<int>
+{
+    public Task InitializeAsync() => commands.Register(
+        this,
+        "Publish balazor web sssembly example",
+        "publish",
+        "pb");
+
+    [SuppressMessage("Performance", "CA1861:Avoid constant arrays as arguments")]
+    public async Task<int> RunAsync(CancellationToken cancellationToken)
+    {
+        var projectPath = Path.Combine("samples", "BlazorWebAssemblyApp");
+        var publishPath = Path.Combine(projectPath, "bin");
+        var rootPath = Path.Combine(publishPath, "wwwroot");
+        var result = await new DotNetPublish()
+            .WithProject(projectPath)
+            .WithConfiguration("Release")
+            .WithOutput(publishPath)
+            .RunAsync(cancellationToken: cancellationToken);
+
+        // Change the base-tag in index.html from '/' to 'BlazorWebAssemblyApp' to match GitHub Pages repository subdirectory
+        var indexFile = Path.Combine(rootPath, "index.html");
+        var indexContent = await File.ReadAllTextAsync(indexFile, cancellationToken);
+        indexContent = indexContent.Replace("""<base href="/" />""", """<base href="/Pure.DI/" />""");
+        await File.WriteAllTextAsync(indexFile, indexContent, cancellationToken);
+
+        // Copy index.html to 404.html to serve the same file when a file is not found
+        File.Copy(indexFile, Path.Combine(rootPath, "404.html"));
+
+        // Add .nojekyll file to tell GitHub pages to not treat this as a Jekyll project. (Allow files and folders starting with an underscore)
+        await File.AppendAllTextAsync(Path.Combine(rootPath, ".nojekyll"), "", cancellationToken);
+
+        return result ?? 1;
+    }
+}

readme/BlazorWebAssemblyAppPageTemplate.md

@@ -2,6 +2,8 @@
 
 [![CSharp](https://img.shields.io/badge/C%23-code-blue.svg)](/samples/BlazorServerApp)
 
+[Here's an example](https://devteam.github.io/Pure.DI/) on github.io
+
 This example demonstrates the creation of a [Blazor WebAssembly](https://learn.microsoft.com/en-us/aspnet/core/blazor/hosting-models#blazor-webassembly) application in the pure DI paradigm using the _Pure.DI_ code generator.
 
 Composition setup file is [Composition.cs](/samples/BlazorWebAssemblyApp/Composition.cs):

samples/BlazorServerApp/Pages/Index.razor

@@ -7,7 +7,7 @@
 
 <h1>Hello, world!</h1>
 
-Welcome to your new app.
+Welcome to your Pure.DI Blazor server example.
 
 <hr/>
 

samples/BlazorServerApp/Shared/MainLayout.razor

@@ -1,6 +1,6 @@
 @inherits LayoutComponentBase
 
-<PageTitle>BlazorServerApp</PageTitle>
+<PageTitle>Pure.DI Blazor server example</PageTitle>
 
 <div class="page">
     <div class="sidebar">
@@ -9,7 +9,7 @@
 
     <main>
         <div class="top-row px-4">
-            <a href="https://docs.microsoft.com/aspnet/" target="_blank">About</a>
+            <a href="https://github.com/DevTeam/Pure.DI/blob/master/readme/BlazorServerApp.md" target="_blank">About</a>
         </div>
 
         <article class="content px-4">

samples/BlazorServerApp/Shared/NavMenu.razor

@@ -1,6 +1,6 @@
 <div class="top-row ps-3 navbar navbar-dark">
     <div class="container-fluid">
-        <a class="navbar-brand" href="">BlazorServerApp</a>
+        <a class="navbar-brand" href="">Pure.DI example</a>
         <button title="Navigation menu" class="navbar-toggler" @onclick="ToggleNavMenu">
             <span class="navbar-toggler-icon"></span>
         </button>

samples/BlazorWebAssemblyApp/Pages/Index.razor

@@ -7,7 +7,7 @@
 
 <h1>Hello, world!</h1>
 
-Welcome to your new app.
+Welcome to your Pure.DI Blazor WebAssembly example.
 
 <hr/>
 

samples/BlazorWebAssemblyApp/Shared/MainLayout.razor

@@ -7,7 +7,7 @@
 
     <main>
         <div class="top-row px-4">
-            <a href="https://docs.microsoft.com/aspnet/" target="_blank">About</a>
+            <a href="https://github.com/DevTeam/Pure.DI/blob/master/readme/BlazorWebAssemblyApp.md" target="_blank">About</a>
         </div>
 
         <article class="content px-4">

samples/BlazorWebAssemblyApp/Shared/NavMenu.razor

@@ -1,6 +1,6 @@
 <div class="top-row ps-3 navbar navbar-dark">
     <div class="container-fluid">
-        <a class="navbar-brand" href="">BlazorWebAssemblyApp</a>
+        <a class="navbar-brand" href="">Pure.DI example</a>
         <button title="Navigation menu" class="navbar-toggler" @onclick="ToggleNavMenu">
             <span class="navbar-toggler-icon"></span>
         </button>

samples/BlazorWebAssemblyApp/wwwroot/index.html

@@ -4,7 +4,7 @@
 <head>
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no" />
-    <title>BlazorWebAssemblyApp</title>
+    <title>Pure.DI Blazor WebAssembly example</title>
     <base href="/" />
     <link href="css/bootstrap/bootstrap.min.css" rel="stylesheet" />
     <link href="css/app.css" rel="stylesheet" />

samples/WebApp/Models/IndexViewModel.cs

@@ -5,7 +5,7 @@ namespace WebApp.Models;
 public class IndexViewModel(
     IWeatherForecastService weatherForecastService,
     string title = "Welcome",
-    string aboutUrl = "https://github.com/DevTeam/Pure.DI")
+    string aboutUrl = "https://github.com/DevTeam/Pure.DI/blob/master/readme/WebApp.md")
 {
     public string Title { get; } = title;