BaseHost 1.0.0.143-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.143-beta                
NuGet\Install-Package BaseHost -Version 1.0.0.143-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.143-beta" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add BaseHost --version 1.0.0.143-beta                
#r "nuget: BaseHost, 1.0.0.143-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.
// Install BaseHost as a Cake Addin
#addin nuget:?package=BaseHost&version=1.0.0.143-beta&prerelease

// Install BaseHost as a Cake Tool
#tool nuget:?package=BaseHost&version=1.0.0.143-beta&prerelease                

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. 
.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 28 12/21/2024
1.2.35 71 12/12/2024
1.2.34 56 12/5/2024
1.2.33 62 11/28/2024
1.2.32 54 11/22/2024
1.2.31 49 11/19/2024
1.2.29 42 11/18/2024
1.2.26 46 11/4/2024
1.2.25 46 11/3/2024
1.2.24 45 11/3/2024
1.2.23 51 10/22/2024
1.2.22 54 10/4/2024
1.2.21 56 9/25/2024
1.2.20 49 9/12/2024
1.2.19 62 9/2/2024
1.2.18 50 8/15/2024
1.2.17 57 8/15/2024
1.2.16 49 8/9/2024
1.2.15 45 8/9/2024
1.2.14 52 8/9/2024
1.2.13 49 8/9/2024
1.2.12 51 7/30/2024
1.2.11 47 7/30/2024
1.2.10 48 7/30/2024
1.2.7 75 7/4/2024
1.2.6 63 7/4/2024
1.2.5 59 7/3/2024
1.2.1 54 7/3/2024
1.0.0.201 113 6/30/2024
1.0.0.200 108 6/30/2024
1.0.0.172 589 9/28/2023
1.0.0.171 804 4/23/2023
1.0.0.170 791 4/16/2023
1.0.0.169 761 4/16/2023
1.0.0.168 737 4/16/2023
1.0.0.167 761 4/14/2023
1.0.0.166 790 3/19/2023
1.0.0.165 789 3/18/2023
1.0.0.164 879 1/7/2023
1.0.0.163 891 1/1/2023
1.0.0.162 867 12/30/2022
1.0.0.161 869 12/30/2022
1.0.0.160 859 12/16/2022
1.0.0.159 865 12/16/2022
1.0.0.153 1,011 6/26/2022
1.0.0.152 1,030 6/25/2022
1.0.0.151 1,031 6/25/2022
1.0.0.151-beta 723 6/25/2022
1.0.0.150 1,013 6/25/2022
1.0.0.150-beta 685 6/25/2022
1.0.0.149 1,004 6/23/2022
1.0.0.149-beta 701 6/23/2022
1.0.0.148 1,013 6/21/2022
1.0.0.148-beta 727 6/21/2022
1.0.0.147 1,044 4/20/2022
1.0.0.147-beta 723 4/20/2022
1.0.0.146 1,033 1/16/2022
1.0.0.146-beta 734 1/16/2022
1.0.0.145 1,040 1/16/2022
1.0.0.145-beta 730 1/16/2022
1.0.0.144-beta 747 1/16/2022
1.0.0.143-beta 707 1/16/2022
1.0.0.141 1,068 1/15/2022
1.0.0.141-beta 737 1/15/2022
1.0.0.140 1,045 1/11/2022
1.0.0.140-beta 720 1/11/2022
1.0.0.139-beta 747 1/11/2022
1.0.0.138-beta 749 1/10/2022
1.0.0.135 875 12/22/2021
1.0.0.135-beta 749 12/22/2021
1.0.0.132-beta 740 12/22/2021
1.0.0.131-beta 746 12/4/2021
1.0.0.130-beta 724 12/2/2021
1.0.0.129-beta 730 12/1/2021
1.0.0.128-beta 745 12/1/2021
1.0.0.127-beta 730 12/1/2021
1.0.0.126-beta 1,404 12/1/2021
1.0.0.125-beta 1,469 12/1/2021
1.0.0.124-beta 742 12/1/2021
1.0.0.123-beta 1,586 11/29/2021
1.0.0.122-beta 1,494 11/29/2021
1.0.0.121 1,942 11/28/2021
1.0.0.121-beta 1,816 11/28/2021
1.0.0.120 855 11/28/2021
1.0.0.120-beta 734 11/28/2021
1.0.0.119 870 11/27/2021
1.0.0.119-beta 709 11/27/2021
1.0.0.118-beta 726 11/27/2021
1.0.0.117-beta 722 11/27/2021
1.0.0.116-beta 749 11/27/2021
1.0.0.113-beta 725 11/27/2021
1.0.0.112-beta 752 11/27/2021
1.0.0.111-beta 1,887 11/27/2021
1.0.0.110-beta 1,888 11/27/2021
1.0.0.109-beta 1,776 11/27/2021
1.0.0.108-beta 1,759 11/26/2021
1.0.0.107-beta 1,931 11/26/2021
1.0.0.105 901 11/8/2021
1.0.0.105-beta 786 11/8/2021
1.0.0.104-beta 777 11/8/2021
1.0.0.103-beta 797 11/8/2021
1.0.0.102 919 11/8/2021
1.0.0.102-beta 833 11/8/2021
1.0.0.101 941 11/8/2021
1.0.0.95 910 11/6/2021
1.0.0.94 927 11/6/2021
1.0.0.91 934 11/4/2021
1.0.0.90 975 11/2/2021
1.0.0.89 911 11/1/2021
0.0.200 62 7/2/2024
0.0.199 60 7/2/2024
0.0.198 56 7/2/2024
0.0.6.84 981 11/1/2021
0.0.6.83 976 11/1/2021
0.0.6.81 978 11/1/2021
0.0.6.80 983 11/1/2021
0.0.6.79 1,011 10/31/2021
0.0.6.78 906 10/31/2021
0.0.6.77 939 10/31/2021
0.0.6.76 956 8/20/2021
0.0.6.75 971 8/20/2021
0.0.6.73 935 6/18/2021
0.0.6.72 996 2/27/2021
0.0.6.71 978 2/27/2021
0.0.6.70 1,050 11/23/2020
0.0.5.67 1,008 11/23/2020
0.0.4.69 1,145 10/10/2020
0.0.4.68 1,024 11/23/2020
0.0.3.69 1,096 10/4/2020
0.0.3.68 1,089 10/2/2020
0.0.2.68 1,101 10/2/2020
0.0.2.64 1,128 8/23/2020
0.0.2.62 1,035 8/23/2020
0.0.1.62 1,121 8/23/2020
0.0.1.61 1,110 8/16/2020
0.0.1.60 1,084 8/16/2020
0.0.1.57 1,181 4/10/2020
0.0.1.53 1,321 1/18/2020
0.0.1.52 1,281 1/7/2020
0.0.1.51 1,174 1/7/2020
0.0.1.49 1,194 1/7/2020
0.0.1.48 1,146 1/6/2020
0.0.1.47 1,182 1/5/2020
0.0.1.46 1,170 1/4/2020
0.0.1.45 1,193 1/4/2020
0.0.1.44 1,152 1/4/2020
0.0.1.43 1,270 1/1/2020
0.0.1.42 1,277 1/1/2020
0.0.1.41 1,254 1/1/2020
0.0.1.40 1,164 11/21/2019
0.0.1.39 1,196 10/18/2019
0.0.1.38 1,274 5/6/2019
0.0.1.37 1,258 5/6/2019
0.0.1.36 1,337 4/22/2019
0.0.1.34 1,332 4/22/2019