Custom Ordering/Sorting

README.md

@@ -4,7 +4,7 @@ RepoM is a minimal-conf git repository hub with Windows Explorer enhancements. I
 
 It's populating itself as you work with git. It does not get in the way and does not require any user attention to work.
 
-Repo< will not compete with your favourite git clients, so keep them. It's not about working within a repository: It's a new way to use all of your repositories to make your daily work easier.
+RepoM will not compete with your favourite git clients, so keep them. It's not about working within a repository: It's a new way to use all of your repositories to make your daily work easier.
 
 📦  [Check the Releases page](https://github.com/coenm/RepoM/releases) to **download** the latest version and see **what's new**!
 
@@ -26,12 +26,12 @@ For Windows, use the hotkeys <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>R</kbd> to show
 
 To open a file browser, simply press <kbd>Return</kbd> on the keyboard once you selected a repository. To open a command prompt instead, hold <kbd>Ctrl</kbd> on Windows or <kbd>Command</kbd> on macOS while pressing <kbd>Return</kbd>. These modifier keys will also work with mouse navigation.
 
-## Enhanced Windows Explorer Titles
+## Plugin: Enhanced Windows Explorer Titles
 
 As an extra goodie for Windows users, RepoZ automatically detects open File Explorer windows and adds a status appendix to their title if they are in context of a git repository.
 
 ![Screenshot](https://raw.githubusercontent.com/awaescher/RepoZ/master/_doc/RepoZ-ReadMe-Explorer.png)
 
 ## Credits
 
-RepoM is a fork of the amazing RepoZ, which was created by [Screenshot](https://github.com/awaescher/RepoZ).
+RepoM is a fork of the amazing RepoZ, which was created by [Andreas Wäscher](https://github.com/awaescher/RepoZ).

RepoM.sln

@@ -33,6 +33,10 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "RepoM.Api.Tests", "tests\Re
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "RepoM.Core.Plugin", "src\RepoM.Core.Plugin\RepoM.Core.Plugin.csproj", "{E38D9928-A0A6-4978-BD7E-C7F2E2B6BC9B}"
 EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "RepoM.Plugin.Statistics", "src\RepoM.Plugin.Statistics\RepoM.Plugin.Statistics.csproj", "{DF4F5FA8-0E3F-4D84-A048-20242FD032BC}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "RepoM.Plugin.Statistics.Tests", "tests\RepoM.Plugin.Statistics.Tests\RepoM.Plugin.Statistics.Tests.csproj", "{C90AA844-B355-4C62-96FA-D4F338EE094A}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -327,6 +331,46 @@ Global
 		{E38D9928-A0A6-4978-BD7E-C7F2E2B6BC9B}.Release|x64.Build.0 = Release|Any CPU
 		{E38D9928-A0A6-4978-BD7E-C7F2E2B6BC9B}.Release|x86.ActiveCfg = Release|Any CPU
 		{E38D9928-A0A6-4978-BD7E-C7F2E2B6BC9B}.Release|x86.Build.0 = Release|Any CPU
+		{DF4F5FA8-0E3F-4D84-A048-20242FD032BC}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{DF4F5FA8-0E3F-4D84-A048-20242FD032BC}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{DF4F5FA8-0E3F-4D84-A048-20242FD032BC}.Debug|ARM.ActiveCfg = Debug|Any CPU
+		{DF4F5FA8-0E3F-4D84-A048-20242FD032BC}.Debug|ARM.Build.0 = Debug|Any CPU
+		{DF4F5FA8-0E3F-4D84-A048-20242FD032BC}.Debug|ARM64.ActiveCfg = Debug|Any CPU
+		{DF4F5FA8-0E3F-4D84-A048-20242FD032BC}.Debug|ARM64.Build.0 = Debug|Any CPU
+		{DF4F5FA8-0E3F-4D84-A048-20242FD032BC}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{DF4F5FA8-0E3F-4D84-A048-20242FD032BC}.Debug|x64.Build.0 = Debug|Any CPU
+		{DF4F5FA8-0E3F-4D84-A048-20242FD032BC}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{DF4F5FA8-0E3F-4D84-A048-20242FD032BC}.Debug|x86.Build.0 = Debug|Any CPU
+		{DF4F5FA8-0E3F-4D84-A048-20242FD032BC}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{DF4F5FA8-0E3F-4D84-A048-20242FD032BC}.Release|Any CPU.Build.0 = Release|Any CPU
+		{DF4F5FA8-0E3F-4D84-A048-20242FD032BC}.Release|ARM.ActiveCfg = Release|Any CPU
+		{DF4F5FA8-0E3F-4D84-A048-20242FD032BC}.Release|ARM.Build.0 = Release|Any CPU
+		{DF4F5FA8-0E3F-4D84-A048-20242FD032BC}.Release|ARM64.ActiveCfg = Release|Any CPU
+		{DF4F5FA8-0E3F-4D84-A048-20242FD032BC}.Release|ARM64.Build.0 = Release|Any CPU
+		{DF4F5FA8-0E3F-4D84-A048-20242FD032BC}.Release|x64.ActiveCfg = Release|Any CPU
+		{DF4F5FA8-0E3F-4D84-A048-20242FD032BC}.Release|x64.Build.0 = Release|Any CPU
+		{DF4F5FA8-0E3F-4D84-A048-20242FD032BC}.Release|x86.ActiveCfg = Release|Any CPU
+		{DF4F5FA8-0E3F-4D84-A048-20242FD032BC}.Release|x86.Build.0 = Release|Any CPU
+		{C90AA844-B355-4C62-96FA-D4F338EE094A}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{C90AA844-B355-4C62-96FA-D4F338EE094A}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{C90AA844-B355-4C62-96FA-D4F338EE094A}.Debug|ARM.ActiveCfg = Debug|Any CPU
+		{C90AA844-B355-4C62-96FA-D4F338EE094A}.Debug|ARM.Build.0 = Debug|Any CPU
+		{C90AA844-B355-4C62-96FA-D4F338EE094A}.Debug|ARM64.ActiveCfg = Debug|Any CPU
+		{C90AA844-B355-4C62-96FA-D4F338EE094A}.Debug|ARM64.Build.0 = Debug|Any CPU
+		{C90AA844-B355-4C62-96FA-D4F338EE094A}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{C90AA844-B355-4C62-96FA-D4F338EE094A}.Debug|x64.Build.0 = Debug|Any CPU
+		{C90AA844-B355-4C62-96FA-D4F338EE094A}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{C90AA844-B355-4C62-96FA-D4F338EE094A}.Debug|x86.Build.0 = Debug|Any CPU
+		{C90AA844-B355-4C62-96FA-D4F338EE094A}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{C90AA844-B355-4C62-96FA-D4F338EE094A}.Release|Any CPU.Build.0 = Release|Any CPU
+		{C90AA844-B355-4C62-96FA-D4F338EE094A}.Release|ARM.ActiveCfg = Release|Any CPU
+		{C90AA844-B355-4C62-96FA-D4F338EE094A}.Release|ARM.Build.0 = Release|Any CPU
+		{C90AA844-B355-4C62-96FA-D4F338EE094A}.Release|ARM64.ActiveCfg = Release|Any CPU
+		{C90AA844-B355-4C62-96FA-D4F338EE094A}.Release|ARM64.Build.0 = Release|Any CPU
+		{C90AA844-B355-4C62-96FA-D4F338EE094A}.Release|x64.ActiveCfg = Release|Any CPU
+		{C90AA844-B355-4C62-96FA-D4F338EE094A}.Release|x64.Build.0 = Release|Any CPU
+		{C90AA844-B355-4C62-96FA-D4F338EE094A}.Release|x86.ActiveCfg = Release|Any CPU
+		{C90AA844-B355-4C62-96FA-D4F338EE094A}.Release|x86.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE
@@ -340,6 +384,8 @@ Global
 		{74B95BAF-0DB4-42C8-92EA-A364E8080809} = {D6E372DC-10D3-4997-9DFC-568B4666635A}
 		{26FF9590-66C7-4B87-9574-E816E1E36628} = {D6E372DC-10D3-4997-9DFC-568B4666635A}
 		{C2014EE2-F17C-478E-B282-9D0971065BB8} = {D6E372DC-10D3-4997-9DFC-568B4666635A}
+		{DF4F5FA8-0E3F-4D84-A048-20242FD032BC} = {D6E372DC-10D3-4997-9DFC-568B4666635A}
+		{C90AA844-B355-4C62-96FA-D4F338EE094A} = {D6E372DC-10D3-4997-9DFC-568B4666635A}
 	EndGlobalSection
 	GlobalSection(ExtensibilityGlobals) = postSolution
 		SolutionGuid = {1765ABAA-0652-4DA5-ABBF-05396F2957D7}

RepoM.sln.DotSettings

@@ -1,5 +1,7 @@
 <wpf:ResourceDictionary xml:space="preserve" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:s="clr-namespace:System;assembly=mscorlib" xmlns:ss="urn:shemas-jetbrains-com:settings-storage-xaml" xmlns:wpf="http://schemas.microsoft.com/winfx/2006/xaml/presentation">
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=bindable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=comparers/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=decoratee/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Devops/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Gravell/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Hardcodeded/@EntryIndexedValue">True</s:Boolean>

src/RepoM.Api/Common/AppSettings.cs

@@ -11,7 +11,9 @@ public AppSettings()
         EnabledSearchProviders = new List<string>();
         SonarCloudPersonalAccessToken = string.Empty;
         AzureDevOps = AzureDevOpsOptions.Default;
+        SortKey = string.Empty;
     }
+    public string SortKey { get; set; }
 
     public AutoFetchMode AutoFetchMode { get; set; }
 

src/RepoM.Api/Common/FileAppSettingsService.cs

@@ -7,7 +7,67 @@ namespace RepoM.Api.Common;
 using System.Linq;
 using Newtonsoft.Json;
 using RepoM.Api.Git.AutoFetch;
-using RepoM.Api.IO;
+using RepoM.Core.Plugin.Common;
+using RepoM.Core.Plugin.RepositoryOrdering.Configuration;
+using YamlDotNet.Serialization;
+using YamlDotNet.Serialization.NamingConventions;
+
+public class FilesICompareSettingsService : ICompareSettingsService
+{
+    private readonly IFileSystem _fileSystem;
+    private readonly IEnumerable<IConfigurationRegistration> _registrations;
+    private readonly IAppDataPathProvider _appDataPathProvider;
+    private Dictionary<string, IRepositoriesComparerConfiguration>? _configuration;
+
+
+    public FilesICompareSettingsService(IAppDataPathProvider appDataPathProvider, IFileSystem fileSystem, IEnumerable<IConfigurationRegistration> registrations)
+    {
+        _fileSystem = fileSystem ?? throw new ArgumentNullException(nameof(fileSystem));
+        _registrations = registrations.ToList();
+        _appDataPathProvider = appDataPathProvider ?? throw new ArgumentNullException(nameof(appDataPathProvider));
+    }
+
+    public Dictionary<string, IRepositoriesComparerConfiguration> Configuration => _configuration ??= Load();
+
+
+    private string GetFileName()
+    {
+        return _fileSystem.Path.Combine(_appDataPathProvider.GetAppDataPath(), "RepoM.Ordering.yaml");
+    }
+
+    private Dictionary<string, IRepositoriesComparerConfiguration> Load()
+    {
+        var file = GetFileName();
+
+        if (!_fileSystem.File.Exists(file))
+        {
+            throw new Exception("File doesn't exist");
+        }
+
+        try
+        {
+            var yml = _fileSystem.File.ReadAllText(file);
+
+            DeserializerBuilder builder = new DeserializerBuilder()
+                .WithNamingConvention(HyphenatedNamingConvention.Instance);
+
+            foreach (IConfigurationRegistration instance in _registrations)
+            {
+                var tag = instance.Tag.TrimStart('!');
+                builder.WithTagMapping("!" + tag, instance.ConfigurationType);
+            }
+
+            IDeserializer deserializer = builder.Build();
+
+            return deserializer.Deserialize<Dictionary<string, IRepositoriesComparerConfiguration>>(yml);
+        }
+        catch
+        {
+            throw;
+            /* Our app settings are not critical. For our purposes, we want to ignore IO exceptions */
+        }
+    }
+}
 
 public class FileAppSettingsService : IAppSettingsService
 {
@@ -72,6 +132,24 @@ private string GetFileName()
 
     private AppSettings Settings => _settings ??= Load();
 
+
+    public string SortKey
+    {
+        get => Settings.SortKey;
+        set
+        {
+            if (value == Settings.SortKey)
+            {
+                return;
+            }
+
+            Settings.SortKey = value;
+
+            NotifyChange();
+            Save();
+        }
+    }
+
     public AutoFetchMode AutoFetchMode
     {
         get => Settings.AutoFetchMode;

src/RepoM.Api/Common/HardcodededMiniHumanizer.cs

@@ -1,16 +1,12 @@
 namespace RepoM.Api.Common;
 
 using System;
+using RepoM.Core.Plugin.Common;
 
 public class HardcodededMiniHumanizer : IHumanizer
 {
     private readonly IClock _clock;
 
-    public HardcodededMiniHumanizer()
-        : this(new SystemClock())
-    {
-    }
-
     public HardcodededMiniHumanizer(IClock clock)
     {
         _clock = clock ?? throw new ArgumentNullException(nameof(clock));

src/RepoM.Api/Common/IAppSettingsService.cs

@@ -3,6 +3,12 @@ namespace RepoM.Api.Common;
 using System;
 using System.Collections.Generic;
 using RepoM.Api.Git.AutoFetch;
+using RepoM.Core.Plugin.RepositoryOrdering.Configuration;
+
+public interface ICompareSettingsService
+{
+    Dictionary<string, IRepositoriesComparerConfiguration> Configuration { get; }
+}
 
 public interface IAppSettingsService
 {
@@ -22,5 +28,7 @@ public interface IAppSettingsService
 
     string AzureDevOpsBaseUrl { get; set; }
 
+    string SortKey { get; set; }
+
     void RegisterInvalidationHandler(Action handler);
 }

src/RepoM.Api/Common/SystemClock.cs

@@ -1,8 +1,15 @@
 namespace RepoM.Api.Common;
 
 using System;
+using RepoM.Core.Plugin.Common;
 
 public class SystemClock : IClock
 {
+    private SystemClock()
+    {
+    }
+
+    public static SystemClock Instance { get; } = new();
+
     public DateTime Now => DateTime.Now;
 }

src/RepoM.Api/Git/AutoFetch/DefaultAutoFetchHandler.cs

@@ -9,7 +9,7 @@ namespace RepoM.Api.Git.AutoFetch;
 public class DefaultAutoFetchHandler : IAutoFetchHandler
 {
     private bool _active;
-    private AutoFetchMode? _mode = null;
+    private AutoFetchMode? _mode;
     private readonly Timer _timer;
     private readonly Dictionary<AutoFetchMode, AutoFetchProfile> _profiles;
     private int _lastFetchRepository = -1;
@@ -26,10 +26,10 @@ public DefaultAutoFetchHandler(
 
         _profiles = new Dictionary<AutoFetchMode, AutoFetchProfile>
             {
-                { AutoFetchMode.Off, new AutoFetchProfile() { PauseBetweenFetches = TimeSpan.MaxValue, } },
-                { AutoFetchMode.Discretely, new AutoFetchProfile() { PauseBetweenFetches = TimeSpan.FromMinutes(5), } },
-                { AutoFetchMode.Adequate, new AutoFetchProfile() { PauseBetweenFetches = TimeSpan.FromMinutes(1), } },
-                { AutoFetchMode.Aggressive, new AutoFetchProfile() { PauseBetweenFetches = TimeSpan.FromSeconds(2), } },
+                { AutoFetchMode.Off, new AutoFetchProfile { PauseBetweenFetches = TimeSpan.MaxValue, } },
+                { AutoFetchMode.Discretely, new AutoFetchProfile { PauseBetweenFetches = TimeSpan.FromMinutes(5), } },
+                { AutoFetchMode.Adequate, new AutoFetchProfile { PauseBetweenFetches = TimeSpan.FromMinutes(1), } },
+                { AutoFetchMode.Aggressive, new AutoFetchProfile { PauseBetweenFetches = TimeSpan.FromSeconds(2), } },
             };
 
         _timer = new Timer(FetchNext, null, Timeout.Infinite, Timeout.Infinite);
@@ -71,28 +71,28 @@ private void FetchNext(object timerState)
         // 2. makes sure that no repository is jumped over because the list
         //    of repositories is constantly changed and not sorted in any way in memory.
         //    So we cannot guarantuee that each repository is fetched on each iteration if we do not sort.
-        var repositories = RepositoryInformationAggregator.Repositories
+        var repositories = RepositoryInformationAggregator.Repositories?
                                                           .OrderBy(r => r.Name)
-                                                          .ToList();
+                                                          .ToArray() ?? Array.Empty<RepositoryViewModel>();
 
         // temporarily disable the timer to prevent parallel fetch executions
         UpdateBehavior(AutoFetchMode.Off);
 
         _lastFetchRepository++;
 
-        if (repositories.Count <= _lastFetchRepository)
+        if (repositories.Length <= _lastFetchRepository)
         {
             _lastFetchRepository = 0;
         }
 
-        RepositoryView repositoryView = repositories[_lastFetchRepository];
+        RepositoryViewModel repositoryViewModel = repositories[_lastFetchRepository];
 
-        Console.WriteLine($"Auto-fetching {repositoryView.Name} (index {_lastFetchRepository} of {repositories.Count})");
+        Console.WriteLine($"Auto-fetching {repositoryViewModel.Name} (index {_lastFetchRepository} of {repositories.Length})");
 
-        repositoryView.IsSynchronizing = true;
+        repositoryViewModel.IsSynchronizing = true;
         try
         {
-            RepositoryWriter.Fetch(repositoryView.Repository);
+            RepositoryWriter.Fetch(repositoryViewModel.Repository);
         }
         catch
         {
@@ -103,7 +103,7 @@ private void FetchNext(object timerState)
             // re-enable the timer to get to the next fetch
             UpdateBehavior();
 
-            repositoryView.IsSynchronizing = false;
+            repositoryViewModel.IsSynchronizing = false;
         }
     }
 
@@ -134,7 +134,7 @@ public AutoFetchMode Mode
             }
 
             _mode = value;
-            Console.WriteLine("Auto fetch is: " + _mode.GetValueOrDefault().ToString());
+            Console.WriteLine("Auto fetch is: " + _mode.GetValueOrDefault());
 
             UpdateBehavior();
         }

src/RepoM.Api/Git/DefaultRepositoryIgnoreStore.cs

@@ -5,7 +5,7 @@ namespace RepoM.Api.Git;
 using System.IO;
 using System.IO.Abstractions;
 using System.Linq;
-using RepoM.Api.IO;
+using RepoM.Core.Plugin.Common;
 
 public class DefaultRepositoryIgnoreStore : FileRepositoryStore, IRepositoryIgnoreStore
 {