BaseHost 1.0.0.127-beta

This is a prerelease version of BaseHost.
There is a newer version of this package available.
See the version list below for details.
dotnet add package BaseHost --version 1.0.0.127-beta
                    
NuGet\Install-Package BaseHost -Version 1.0.0.127-beta
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="BaseHost" Version="1.0.0.127-beta" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="BaseHost" Version="1.0.0.127-beta" />
                    
Directory.Packages.props
<PackageReference Include="BaseHost" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add BaseHost --version 1.0.0.127-beta
                    
#r "nuget: BaseHost, 1.0.0.127-beta"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package BaseHost@1.0.0.127-beta
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=BaseHost&version=1.0.0.127-beta&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=BaseHost&version=1.0.0.127-beta&prerelease
                    
Install as a Cake Tool

Purpose

This is used as the foundation of my other C# projects. It provides some common bits of setup with are often needed. It sets up a configured host which uses my config module, my console module, Autofac and NLog. There is also a code generator which will create builders for any class [BuilderPattern].

How to use

Host

This is how a host can be setup, you'll need to add your own nlog config

public class Host : ConsoleHost{
    public static void Main(string[] args) => new Host().Start(args);
    protected override void Setup(ContainerBuilder builder){
        builder.AutoActivateWith<Controller>(i => i.Start());
    }
    public class Controller{
        public Controller(ILogger logger){...}
        public void Start(){...}
    }
}

Builder Generator

The generator will create a builder class, also add methods for each public property with a private mutator, With(value), Update(Func<value,value>). It will also make special use of ImmutableArray, ImmutableDictionary and ImmutableHashSet

Example model class

[BuilderPattern]
public partial class Model
{
    public string Value { get; private set; }
}

generated class

public partial class Model
{
    private Model () { }
    public Builder AsBuilder() => Builder.BasedOn(this);
    public static Builder CreateBuilder() => Builder.Instance();

    public Mutable AsMutable() => new Mutable(){
        Value = this.Value,
    };
    
public Model WithValue(string value) => AsBuilder().WithValue(value).Build();
public Model UpdateValue(Func<string,string> valueFunc) => AsBuilder().UpdateValue(valueFunc).Build();
    public sealed partial class Builder {
        private Model _instance = new Model();
        private Builder() { }
        internal static Builder Instance () => new Builder();
        internal static Builder BasedOn(Model reference) => Instance ()
        .WithValue(reference.Value);                    
        
        
    
    public Builder WithValue(string value){
        _instance.Value = value;
        return this;
    }
    public Builder UpdateValue(Func<string,string> valueFunc){
        _instance.Value = valueFunc(_instance.Value);
        return this;
    }
        public Model Build() {
            var local = _instance;
            _instance = null;
            local = local.GetValidatedInstance();
            
            return local;
        }
    }

    public sealed class Mutable {
        public string Value {get; set; }

        public Model AsImmutable() => Model.CreateBuilder()
            .WithValue(this.Value)
            .Build();                   

}}}

Console

There are shells, console and commands. shells run on a console, and have access to commands. new commands can be registered and them will be accessable from all the consoles. There are some commands included, for shutdown/get-starting-args/config and more commands can be registered in ICommandManager

There is also a websocket interface for this.

var shutdown = new Shutdown();

_commandManager.Register("get-starting-args",args);

Config

A config can be given in the form of a json file (Host.config.json), if no json file is provied one will be generated and saved in output at runtime. Config is specified as below:

    [ConfigValue(Name = "ws_pokemon_server_path", DefaultString = "ws:bhah.blah.blah:12")]
    private static string ConnectionString => Config.ws_pokemon_server_path; //Config is generated at build time

Extention Methods

Lots of extention methods, covering a variety of functionality, ienumerable/observables/funcs ..., not really much structure, just whaterver I've found useful

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on BaseHost:

Package Downloads
BaseHost.Web

Configured host, with generators, modules for logging, console and config

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.2.36 105 12/21/2024
1.2.35 114 12/12/2024
1.2.34 94 12/5/2024
1.2.33 101 11/28/2024
1.2.32 97 11/22/2024
1.2.31 89 11/19/2024
1.2.29 78 11/18/2024
1.2.26 78 11/4/2024
1.2.25 77 11/3/2024
1.2.24 84 11/3/2024
1.2.23 83 10/22/2024
1.2.22 85 10/4/2024
1.2.21 91 9/25/2024
1.2.20 84 9/12/2024
1.2.19 102 9/2/2024
1.2.18 84 8/15/2024
1.2.17 96 8/15/2024
1.2.16 80 8/9/2024
1.2.15 81 8/9/2024
1.2.14 89 8/9/2024
1.2.13 83 8/9/2024
1.2.12 95 7/30/2024
1.2.11 99 7/30/2024
1.2.10 85 7/30/2024
1.2.7 115 7/4/2024
1.2.6 96 7/4/2024
1.2.5 90 7/3/2024
1.2.1 98 7/3/2024
1.0.0.201 149 6/30/2024
1.0.0.200 148 6/30/2024
1.0.0.172 633 9/28/2023
1.0.0.171 852 4/23/2023
1.0.0.170 835 4/16/2023
1.0.0.169 807 4/16/2023
1.0.0.168 784 4/16/2023
1.0.0.167 800 4/14/2023
1.0.0.166 844 3/19/2023
1.0.0.165 849 3/18/2023
1.0.0.164 928 1/7/2023
1.0.0.163 943 1/1/2023
1.0.0.162 914 12/30/2022
1.0.0.161 920 12/30/2022
1.0.0.160 906 12/16/2022
1.0.0.159 914 12/16/2022
1.0.0.153 1,072 6/26/2022
1.0.0.152 1,094 6/25/2022
1.0.0.151 1,085 6/25/2022
1.0.0.151-beta 783 6/25/2022
1.0.0.150 1,081 6/25/2022
1.0.0.150-beta 739 6/25/2022
1.0.0.149 1,064 6/23/2022
1.0.0.149-beta 771 6/23/2022
1.0.0.148 1,072 6/21/2022
1.0.0.148-beta 791 6/21/2022
1.0.0.147 1,108 4/20/2022
1.0.0.147-beta 786 4/20/2022
1.0.0.146 1,102 1/16/2022
1.0.0.146-beta 800 1/16/2022
1.0.0.145 1,118 1/16/2022
1.0.0.145-beta 803 1/16/2022
1.0.0.144-beta 817 1/16/2022
1.0.0.143-beta 786 1/16/2022
1.0.0.141 1,132 1/15/2022
1.0.0.141-beta 808 1/15/2022
1.0.0.140 1,111 1/11/2022
1.0.0.140-beta 787 1/11/2022
1.0.0.139-beta 815 1/11/2022
1.0.0.138-beta 815 1/10/2022
1.0.0.135 945 12/22/2021
1.0.0.135-beta 826 12/22/2021
1.0.0.132-beta 808 12/22/2021
1.0.0.131-beta 812 12/4/2021
1.0.0.130-beta 802 12/2/2021
1.0.0.129-beta 803 12/1/2021
1.0.0.128-beta 816 12/1/2021
1.0.0.127-beta 798 12/1/2021
1.0.0.126-beta 1,488 12/1/2021
1.0.0.125-beta 1,555 12/1/2021
1.0.0.124-beta 818 12/1/2021
1.0.0.123-beta 1,657 11/29/2021
1.0.0.122-beta 1,564 11/29/2021
1.0.0.121 2,013 11/28/2021
1.0.0.121-beta 1,886 11/28/2021
1.0.0.120 932 11/28/2021
1.0.0.120-beta 812 11/28/2021
1.0.0.119 939 11/27/2021
1.0.0.119-beta 779 11/27/2021
1.0.0.118-beta 800 11/27/2021
1.0.0.117-beta 794 11/27/2021
1.0.0.116-beta 822 11/27/2021
1.0.0.113-beta 788 11/27/2021
1.0.0.112-beta 822 11/27/2021
1.0.0.111-beta 1,968 11/27/2021
1.0.0.110-beta 1,953 11/27/2021
1.0.0.109-beta 1,836 11/27/2021
1.0.0.108-beta 1,830 11/26/2021
1.0.0.107-beta 1,994 11/26/2021
1.0.0.105 970 11/8/2021
1.0.0.105-beta 855 11/8/2021
1.0.0.104-beta 848 11/8/2021
1.0.0.103-beta 869 11/8/2021
1.0.0.102 989 11/8/2021
1.0.0.102-beta 904 11/8/2021
1.0.0.101 1,016 11/8/2021
1.0.0.95 985 11/6/2021
1.0.0.94 1,004 11/6/2021
1.0.0.91 1,003 11/4/2021
1.0.0.90 1,052 11/2/2021
1.0.0.89 984 11/1/2021
0.0.200 98 7/2/2024
0.0.199 90 7/2/2024
0.0.198 90 7/2/2024
0.0.6.84 1,057 11/1/2021
0.0.6.83 1,045 11/1/2021
0.0.6.81 1,048 11/1/2021
0.0.6.80 1,053 11/1/2021
0.0.6.79 1,081 10/31/2021
0.0.6.78 981 10/31/2021
0.0.6.77 1,010 10/31/2021
0.0.6.76 1,027 8/20/2021
0.0.6.75 1,048 8/20/2021
0.0.6.73 1,010 6/18/2021
0.0.6.72 1,078 2/27/2021
0.0.6.71 1,059 2/27/2021
0.0.6.70 1,135 11/23/2020
0.0.5.67 1,088 11/23/2020
0.0.4.69 1,222 10/10/2020
0.0.4.68 1,108 11/23/2020
0.0.3.69 1,176 10/4/2020
0.0.3.68 1,179 10/2/2020
0.0.2.68 1,189 10/2/2020
0.0.2.64 1,213 8/23/2020
0.0.2.62 1,121 8/23/2020
0.0.1.62 1,211 8/23/2020
0.0.1.61 1,198 8/16/2020
0.0.1.60 1,164 8/16/2020
0.0.1.57 1,271 4/10/2020
0.0.1.53 1,419 1/18/2020
0.0.1.52 1,395 1/7/2020
0.0.1.51 1,270 1/7/2020
0.0.1.49 1,291 1/7/2020
0.0.1.48 1,235 1/6/2020
0.0.1.47 1,274 1/5/2020
0.0.1.46 1,266 1/4/2020
0.0.1.45 1,285 1/4/2020
0.0.1.44 1,243 1/4/2020
0.0.1.43 1,360 1/1/2020
0.0.1.42 1,363 1/1/2020
0.0.1.41 1,344 1/1/2020
0.0.1.40 1,250 11/21/2019
0.0.1.39 1,287 10/18/2019
0.0.1.38 1,371 5/6/2019
0.0.1.37 1,350 5/6/2019
0.0.1.36 1,431 4/22/2019
0.0.1.34 1,432 4/22/2019