Implement Unit & Behaviour Tests For Main Library

.resxpress/namespace-mapping.json

@@ -0,0 +1 @@
+{"TestResources.fr-FR":"Mocale.UnitTests.Resources"}

samples/Mocale.Samples/Pages/ParameterPage.xaml

@@ -17,39 +17,16 @@
             VerticalOptions="Start">
 
             <Label Text="{mocale:Localize Key={x:Static keys:TranslationKeys.ParameterPageHeading}}" />
-
-            <Label Text="This feature is experimental and not yet mature, use at your own discretion!" />
-
-
-            <Border Padding="20">
-                <VerticalStackLayout Spacing="10">
-
-                    <Label FontSize="Title" Text="{mocale:Localize Key={x:Static keys:TranslationKeys.ParameterPageSectionOneHeading}}" />
-                    <Label Margin="0,0,0,10" Text="{mocale:Localize Key={x:Static keys:TranslationKeys.ParameterPageSectionOneSubHeading}}" />
-
-                    <Label FontAttributes="Bold" Text="{mocale:Localize Key={x:Static keys:TranslationKeys.ParameterPageBasicStringFormatLabel}}" />
-                    <Label Margin="0,0,0,10" Text="{mocale:Localize Key={x:Static keys:TranslationKeys.ParameterPageBasicStringFormat}, Parameters='W O R L D!'}" />
-
-                    <Label FontAttributes="Bold" Text="{mocale:Localize Key={x:Static keys:TranslationKeys.ParameterPageLargeStringFormatLabel}}" />
-                    <Label Margin="0,0,0,10" Text="{mocale:Localize Key={x:Static keys:TranslationKeys.ParameterPageLargeStringFormat}, Parameters='World|23-07-2024|23'}" />
-
-                    <Label FontAttributes="Bold" Text="{mocale:Localize Key={x:Static keys:TranslationKeys.ParameterPageMultipleFormatsSameValueLabel}}" />
-                    <Label Text="{mocale:Localize Key={x:Static keys:TranslationKeys.ParameterPageMultipleFormatsSameValue}, Parameters='mate'}" />
-
-                </VerticalStackLayout>
-            </Border>
-
             <Border Padding="20">
                 <VerticalStackLayout Spacing="10">
 
-                    <Label FontSize="Title" Text="{mocale:Localize Key={x:Static keys:TranslationKeys.ParameterPageSectionTwoHeading}}" />
-                    <Label Margin="0,0,0,10" Text="{mocale:Localize Key={x:Static keys:TranslationKeys.ParameterPageSectionTwoSubHeading}}" />
+                    <Label FontSize="Title" Text="{mocale:Localize Key={x:Static keys:TranslationKeys.ParameterPageSectionHeading}}" />
+                    <Label Margin="0,0,0,10" Text="{mocale:Localize Key={x:Static keys:TranslationKeys.ParameterPageSectionSubHeading}}" />
 
                     <Label FontAttributes="Bold" Text="{mocale:Localize Key={x:Static keys:TranslationKeys.ParameterPageBasicStringFormatLabel}}" />
                     <Label Margin="0,0,0,10" Text="{mocale:LocalizeBinding Name, TranslationKey={x:Static keys:TranslationKeys.ParameterPageBasicStringFormat}}" />
 
                     <Label FontAttributes="Bold" Text="{mocale:Localize Key={x:Static keys:TranslationKeys.ParameterPageLargeStringFormatLabel}}" />
-                    <!--<Label Margin="0,0,0,10" Text="{mocale:Localize Key={x:Static keys:TranslationKeys.ParameterPageLargeStringFormat}}" />-->
                     <Label Margin="0,0,0,10">
                         <Label.Text>
                             <mocale:LocalizeMultiBinding TranslationKey="{x:Static keys:TranslationKeys.ParameterPageLargeStringFormat}">

samples/Mocale.Samples/Resources/Locales/en-GB.json

@@ -19,17 +19,15 @@
   "BindingPage_CodeBehind_Heading": "In this example we have a label whos translation will be set via code behind using the SetTranslation method.",
   "BindingPage_CodeBehind_LabelKey": "This translation was set in c# code, not xaml!",
   "ParameterPage_Title": "Parameters",
-  "ParameterPage_Heading": "Here we can see examples of string formatting using Mocale. Use the normal .NET string format notation ({0}, {1}) and provide these values to localize the formats",
-  "ParameterPage_SectionOne_Heading": "Static Localizations",
-  "ParameterPage_SectionOne_SubHeading": "All of the following values have been localized using static xaml.",
+  "ParameterPage_Heading": "Here we can see examples of string formatting using Mocale. Use the normal .NET string format notation ({0}, {1}) and provide these values to localize the formats.\r\nThese can be bound to any property, for single Bindings use LocalizeBinding and for multiple use LocalizeMultiBinding",
+  "ParameterPage_Section_Heading": "Parameterized Localizations",
+  "ParameterPage_Section_SubHeading": "All of the following values have been localized using both translation keys and the value they are bound to.",
   "ParameterPage_BasicStringFormat_Label": "A basic string format",
   "ParameterPage_BasicStringFormat": "Hello {0}",
   "ParameterPage_LargeStringFormat_Label": "A larger string format",
   "ParameterPage_LargeStringFormat": "Hello {0}, todays date is {1} and the weather is {2}°C",
   "ParameterPage_MultipleFormatsSameValue_Label": "A string format with the same value multiple times",
   "ParameterPage_MultipleFormatsSameValue": "Hello {0}, Hello {0}, Hello {0}",
-  "ParameterPage_SectionTwo_Heading": "Binded Localizations",
-  "ParameterPage_SectionTwo_SubHeading": "All of the following values have been localized using bindings. If the binded values update the strings will update accordingly",
   "CodePage_Title": "Code",
   "CodePage_Heading": "This page is built entirely through code behind, you can see examples of everything Mocale has to offer when not using xaml!"
 }

samples/Mocale.Samples/Resources/Locales/fr-FR.json

@@ -19,17 +19,15 @@
   "BindingPage_CodeBehind_Heading": "Dans cet exemple, nous avons une étiquette dont la traduction sera définie via le code derrière en utilisant la méthode SetTranslation.",
   "BindingPage_CodeBehind_LabelKey": "Cette traduction a été définie dans du code C#, pas en Xaml !",
   "ParameterPage_Title": "Paramètres",
-  "ParameterPage_Heading": "Ici, nous pouvons voir des exemples de formatage de chaîne à l'aide de Mocale. Utilisez la notation normale de format de chaîne .NET ({0}, {1}) et fournissez ces valeurs pour localiser les formats",
-  "ParameterPage_SectionOne_Heading": "Localisations statiques",
-  "ParameterPage_SectionOne_SubHeading": "Toutes les valeurs suivantes ont été localisées à l'aide de XML statique.",
+  "ParameterPage_Heading": "Ici, nous pouvons voir des exemples de formatage de chaîne à l'aide de Mocale. Utilisez la notation normale du format de chaîne .NET ({0}, {1}) et fournissez ces valeurs pour localiser les formats.\r\nCeux-ci peuvent être liés à n'importe quelle propriété, pour des liaisons uniques, utilisez LocalizeBinding et pour une utilisation multiple LocalizeMultiBinding",
+  "ParameterPage_Section_Heading": "Localisations paramétrées",
+  "ParameterPage_Section_SubHeading": "Toutes les valeurs suivantes ont été localisées à l'aide des clés de traduction et de la valeur à laquelle elles sont liées.",
   "ParameterPage_BasicStringFormat_Label": "Un format de chaîne de base",
   "ParameterPage_BasicStringFormat": "Bonjour {0}",
   "ParameterPage_LargeStringFormat_Label": "Un format de chaîne plus grand",
   "ParameterPage_LargeStringFormat": "Bonjour {0}, la date d'aujourd'hui est {1} et la météo est {2}°C",
   "ParameterPage_MultipleFormatsSameValue_Label": "Un format de chaîne avec la même valeur plusieurs fois",
   "ParameterPage_MultipleFormatsSameValue": "Bonjour {0}, Bonjour {0}, Bonjour {0}",
-  "ParameterPage_SectionTwo_Heading": "Localisations liées",
-  "ParameterPage_SectionTwo_SubHeading": "Toutes les valeurs suivantes ont été localisées à l'aide de liaisons. Si les valeurs liées sont mises à jour, les chaînes seront mises à jour en conséquence",
   "CodePage_Title": "Code",
   "CodePage_Heading": "Cette page est entièrement construite grâce au code derrière, vous pouvez voir des exemples de tout ce que Mocale a à offrir lorsque vous n'utilisez pas xaml!"
 }

src/Mocale.Cache.SQLite/Managers/SqlCacheUpdateManager.cs

@@ -7,20 +7,20 @@ namespace Mocale.Cache.SQLite.Managers;
 internal class SqlCacheUpdateManager : ICacheUpdateManager
 {
     private readonly ICacheRepository cacheRepository;
-    private readonly IDateTime dateTime;
     private readonly ILogger logger;
 
     private readonly ISqliteConfig sqliteConfig;
+    private readonly TimeProvider timeProvider;
 
     public SqlCacheUpdateManager(
         ICacheRepository cacheRepository,
-        IDateTime dateTime,
         ILogger<SqlCacheUpdateManager> logger,
-        IConfigurationManager<ISqliteConfig> sqliteConfigurationManager)
+        IConfigurationManager<ISqliteConfig> sqliteConfigurationManager,
+        TimeProvider timeProvider)
     {
-        this.dateTime = Guard.Against.Null(dateTime, nameof(dateTime));
-        this.logger = Guard.Against.Null(logger, nameof(logger));
         this.cacheRepository = Guard.Against.Null(cacheRepository, nameof(cacheRepository));
+        this.logger = Guard.Against.Null(logger, nameof(logger));
+        this.timeProvider = Guard.Against.Null(timeProvider, nameof(timeProvider));
 
         sqliteConfigurationManager = Guard.Against.Null(sqliteConfigurationManager, nameof(sqliteConfigurationManager));
         this.sqliteConfig = sqliteConfigurationManager.Configuration;
@@ -40,13 +40,13 @@ public bool CanUpdateCache(CultureInfo cultureInfo)
 
         var nextUpdateWindow = updateItem.LastUpdated.Add(sqliteConfig.UpdateInterval);
 
-        return nextUpdateWindow < dateTime.UtcNow;
+        return nextUpdateWindow < timeProvider.GetUtcNow();
     }
 
     /// <inheritdoc/>
     public bool SetCacheUpdated(CultureInfo cultureInfo)
     {
-        return cacheRepository.AddOrUpdateItem(cultureInfo, dateTime.UtcNow);
+        return cacheRepository.AddOrUpdateItem(cultureInfo, timeProvider.GetUtcNow().DateTime);
     }
 
     /// <inheritdoc/>

src/Mocale/Abstractions/ICacheUpdateManager.cs

@@ -1,3 +1,4 @@
+using System.Diagnostics.CodeAnalysis;
 using System.Globalization;
 namespace Mocale.Abstractions;
 
@@ -13,23 +14,23 @@
     /// </summary>
     /// <param name="cultureInfo">The culture to check whether updates can occur</param>
     /// <returns>True if external provider should be used (cache expired / no localizations for culture)</returns>
     bool CanUpdateCache(CultureInfo cultureInfo);
 
     /// <summary>
     /// Sets when the cache has been updated for the given culture
     /// </summary>
     /// <param name="cultureInfo">The culture that has just been updated</param>
     /// <returns>Success</returns>
     bool SetCacheUpdated(CultureInfo cultureInfo);
 
     /// <summary>
     /// Clear the cache for a specific culture
     /// </summary>
     /// <param name="cultureInfo">Culture to clear cache for</param>
     void ClearCache(CultureInfo cultureInfo);
 
     /// <summary>
     /// Clear the cache for all cultures
     /// </summary>
     void ClearCache();
 }

src/Mocale/Abstractions/IConfigurationManager.cs

@@ -9,7 +9,7 @@
     /// <summary>
     /// The configuration for the given area
     /// </summary>
-    TConfig Configuration { get; set; }
+    TConfig Configuration { get; }
 }
 
 /// <summary>

src/Mocale/AppBuilderExtensions.cs

@@ -3,7 +3,6 @@
 using Mocale.Exceptions;
 using Mocale.Managers;
 using Mocale.Providers;
-using Mocale.Wrappers;
 namespace Mocale;
 
 /// <summary>
@@ -35,7 +34,7 @@ public static MauiAppBuilder UseMocale(
         // - Maui Dependencies
         mauiAppBuilder.Services.AddSingleton(Preferences.Default);
         mauiAppBuilder.Services.AddSingleton(FileSystem.Current);
-        mauiAppBuilder.Services.AddTransient<IDateTime, DateTimeWrapper>();
+        mauiAppBuilder.Services.AddSingleton(TimeProvider.System);
 
         // - Localization
         mauiAppBuilder.Services.AddSingleton<IConfigurationManager<IMocaleConfiguration>>(mocaleBuilder.ConfigurationManager);