Calabonga.Commandex.Shell.Develop.Template 1.0.0-beta.12

Calabonga.Commandex.Shell.Develop

Description

This is a Developer version of the Command Executer (Calabonga.Commandex). Witch is created to runs commands of any type for any purposes. For example, to execute a stored procedure or just to copy some files to some destination. And so on...

What is Calabonga.Commandex

It's a complex solution with a few repositories:

• Calabonga.Commandex.Shell → Command Executer or Command Launcher. To run commands of any type for any purpose. For example, to execute a stored procedure or just to copy some files to some destination.

• Calabonga.Commandex.Commands → Commands for Calabonga.Commandex.Shell that can execute them from unified shell.

• Calabonga.Commandex.Shell.Develop.Template → This is a Developer version of the Command Executer (Calabonga.Commandex). Witch is created to runs commands of any type for any purposes. For example, to execute a stored procedure or just to co…

• Calabonga.Commandex.Engine → Engine and contracts library for Calabonga.Commandex. Contracts are using for developing a modules for Commandex Shell.

How to install template

Nothing is simpler then install this template. Just execute command in powershell:

dotnet new install Calabonga.Commandex.Shell.Develop.Template

How to use

This application can only test your Command for Commandex, but almost in a real conditions. How? Please do a few simple steps:

1. Please implement a ICommandexCommand interface in WPF Class Library project and add reference to Calabonga.Commandex.Shell.Develop.

2. Register your ICommandexCommand implementation in the DependencyContainer.cs.

   internal static class DependencyContainer
   {
       internal static IServiceProvider ConfigureServices()
       {
           var services = new ServiceCollection();
   
           services.AddLogging(options =>
           {
               options.AddSerilog(dispose: true);
               options.AddDebug();
           });
   
           services.AddSingleton(typeof(DefaultDialogResult<>));
           services.AddSingleton<DefaultDialogView>();
           services.AddSingleton<MainWindow>();
           services.AddSingleton<MainWindowsViewModel>();
           services.AddSingleton<IDialogService, DialogService>();
           services.AddSingleton<IAppSettings>(_ => App.Current.Settings);
   
           // --------------------------------------------------
           // Attach your definition from your project with your
           // Commandex.Command implementation, uncomment line below and add your command type.
           // services.AddDefinitions(typeof(YourCommandDefinition)); // <-- here should be your Command
           // --------------------------------------------------
   
           return services.BuildServiceProvider();
       }
   }
   

3. Inject your command implementation into MainWindowsViewModel as ICommandexCommand.

   public partial class MainWindowsViewModel : ViewModelBase
   {
       private readonly IDialogService _dialogService;
   
       public MainWindowsViewModel(
           IDialogService dialogService,
           IAppSettings settings)
       {
           Title = $"Commandex Shell Emulator for Easy developing ({settings.CommandsPath})";
           _dialogService = dialogService;
       }
   
   
       [RelayCommand]
       private Task ExecuteAsync()
       {
           _dialogService.ShowNotification("You do not attach your ICommandexCommand yet.");
           return Task.CompletedTask;
       }
   }
   

4. Use your injected instance in ExecuteAsync() method to execute command as shown above.

5. If you everything do correctly, than after button click on the form your command will come executed.

Screenshot

Ingredients

WPF, MVVM, CommunityToolkit, AppDefinitions, etc.

Versions history

v1.0.0-beta.12 2024-08-07

• SettingsFinder copied from the main Shell project.
• Shell settings as IAppSettings injected to MainWindowViewModel.
• commandex.env file created with default parameters.
• Nuget dependencied version updated.

v1.0.0-beta.9 2024-08-05

• Core from original Shell updated.
• Nuget dependencies updated.
• MainWindow updated with new welcome message (instructions).

v1.0.0-beta.5 2024-08-01

• GitInfo nuget package removed because throwing error when git not used.
• Readme.md updated with screenshot and som code snippets.

v1.0.0-beta.1 2024-08-01

• First commit