pax_global_header00006660000000000000000000000064147075035270014524gustar00rootroot0000000000000052 comment=85b04d952374c75afcf419848c1ff5f9a03ad089 Light.GuardClauses-12.0.0/000077500000000000000000000000001470750352700152345ustar00rootroot00000000000000Light.GuardClauses-12.0.0/.github/000077500000000000000000000000001470750352700165745ustar00rootroot00000000000000Light.GuardClauses-12.0.0/.github/workflows/000077500000000000000000000000001470750352700206315ustar00rootroot00000000000000Light.GuardClauses-12.0.0/.github/workflows/build-and-test.yml000066400000000000000000000016271470750352700241760ustar00rootroot00000000000000name: Build and Test on: push: branches: [main, dev] paths: ['Code/**', 'build-and-test.yml'] pull_request: branches: [main, dev] paths: ['Code/**', 'build-and-test.yml'] jobs: build-and-test: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - name: Setup .NET uses: actions/setup-dotnet@v3 with: dotnet-version: 8.0.x - name: Restore dependencies run: dotnet restore ./Code/Light.GuardClauses.AllProjects.sln - name: Build Analyzer run: dotnet build ./Code/Light.GuardClauses.InternalRoslynAnalyzers/Light.GuardClauses.InternalRoslynAnalyzers.csproj -c Release --no-restore - name: Build run: dotnet build ./Code/Light.GuardClauses.AllProjects.sln -c Release --no-restore - name: Test run: dotnet test ./Code/Light.GuardClauses.Tests/Light.GuardClauses.Tests.csproj -c Release --no-build --verbosity normal Light.GuardClauses-12.0.0/.github/workflows/release-on-nuget.yml000066400000000000000000000025051470750352700245300ustar00rootroot00000000000000name: Release to NuGet on: release: types: [published] workflow_dispatch: inputs: dotnetVersion: description: "The version of .NET to use" required: false default: "8.0.x" jobs: release-to-nuget: runs-on: ubuntu-latest timeout-minutes: 5 steps: - name: Checkout uses: actions/checkout@v4 - name: Setup .NET uses: actions/setup-dotnet@v3 with: dotnet-version: ${{ github.event.inputs.dotnetVersion || '8.0.x' }} - name: Prepare SNK file env: LIGHT_GUARDCLAUSES_SNK: ${{ secrets.LIGHT_GUARDCLAUSES_SNK }} run: | echo $LIGHT_GUARDCLAUSES_SNK | base64 --decode > ./Code/Light.GuardClauses/Light.GuardClauses.snk - name: Create NuGet packages run: dotnet pack ./Code/Light.GuardClauses/Light.GuardClauses.csproj -c Release /p:SignAssembly=true /p:AssemblyOriginatorKeyFile=Light.GuardClauses.snk /p:ContinuousIntegrationBuild=true - name: Delete SNK file run: rm ./Code/Light.GuardClauses/Light.GuardClauses.snk - name: Push nupkg package env: NUGET_API_KEY: ${{ secrets.NUGET_API_KEY }} run: dotnet nuget push "./Code/Light.GuardClauses/bin/Release/Light.GuardClauses.*.nupkg" --api-key $NUGET_API_KEY --source https://api.nuget.org/v3/index.json Light.GuardClauses-12.0.0/.gitignore000066400000000000000000000066531470750352700172360ustar00rootroot00000000000000## Ignore Visual Studio temporary files, build results, and ## files generated by popular Visual Studio add-ons. # User-specific files *.suo *.user *.userosscache *.sln.docstates # User-specific files (MonoDevelop/Xamarin Studio) *.userprefs # Build results [Dd]ebug/ [Dd]ebugPublic/ [Rr]elease/ [Rr]eleases/ x64/ x86/ build/ bld/ [Bb]in/ [Oo]bj/ # Visual Studio 2015 cache/options directory .vs/ # MSTest test Results [Tt]est[Rr]esult*/ [Bb]uild[Ll]og.* # NUNIT *.VisualState.xml TestResult.xml # Build Results of an ATL Project [Dd]ebugPS/ [Rr]eleasePS/ dlldata.c # DNX project.lock.json artifacts/ *_i.c *_p.c *_i.h *.ilk *.meta *.obj *.pch *.pdb *.pgc *.pgd *.rsp *.sbr *.tlb *.tli *.tlh *.tmp *.tmp_proj *.log *.vspscc *.vssscc .builds *.pidb *.svclog *.scc # Chutzpah Test files _Chutzpah* # Visual C++ cache files ipch/ *.aps *.ncb *.opensdf *.sdf *.cachefile # Visual Studio profiler *.psess *.vsp *.vspx # TFS 2012 Local Workspace $tf/ # Guidance Automation Toolkit *.gpState # ReSharper is a .NET coding add-in _ReSharper*/ *.[Rr]e[Ss]harper *.DotSettings.user # JustCode is a .NET coding add-in .JustCode # TeamCity is a build add-in _TeamCity* # DotCover is a Code Coverage Tool *.dotCover # NCrunch _NCrunch_* .*crunch*.local.xml # MightyMoose *.mm.* AutoTest.Net/ # Web workbench (sass) .sass-cache/ # Installshield output folder [Ee]xpress/ # DocProject is a documentation generator add-in DocProject/buildhelp/ DocProject/Help/*.HxT DocProject/Help/*.HxC DocProject/Help/*.hhc DocProject/Help/*.hhk DocProject/Help/*.hhp DocProject/Help/Html2 DocProject/Help/html # Click-Once directory publish/ # Publish Web Output *.[Pp]ublish.xml *.azurePubxml ## TODO: Comment the next line if you want to checkin your ## web deploy settings but do note that will include unencrypted ## passwords #*.pubxml *.publishproj # NuGet Packages *.nupkg # The packages folder can be ignored because of Package Restore **/packages/* # except build/, which is used as an MSBuild target. !**/packages/build/ # Uncomment if necessary however generally it will be regenerated when needed #!**/packages/repositories.config # Windows Azure Build Output csx/ *.build.csdef # Windows Store app package directory AppPackages/ # Visual Studio cache files # files ending in .cache can be ignored *.[Cc]ache # but keep track of directories ending in .cache !*.[Cc]ache/ # Others ClientBin/ [Ss]tyle[Cc]op.* ~$* *~ *.dbmdl *.dbproj.schemaview *.pfx *.publishsettings node_modules/ orleans.codegen.cs # RIA/Silverlight projects Generated_Code/ # Backup & report files from converting an old project file # to a newer Visual Studio version. Backup files are not needed, # because we have git ;-) _UpgradeReport_Files/ Backup*/ UpgradeLog*.XML UpgradeLog*.htm # SQL Server files *.mdf *.ldf # Business Intelligence projects *.rdl.data *.bim.layout *.bim_*.settings # Microsoft Fakes FakesAssemblies/ # Node.js Tools for Visual Studio .ntvs_analysis.dat # Visual Studio 6 build log *.plg # Visual Studio 6 workspace options file *.opt # LightSwitch generated files GeneratedArtifacts/ _Pvt_Extensions/ ModelManifest.xml /Code/Light.GuardClauses.Performance/BenchmarkDotNet.Artifacts # VS Code files **/.vscode/ # TargetFrameworks.props files **/TargetFrameworks.props # JetBrains Rider *.sln.iml .idea/ # The source code redistributable of Light.GuardClauses /Code/Light.GuardClauses.Source/Light.GuardClauses.cs /Code/Light.GuardClauses.SourceCodeTransformation/settings.json Light.GuardClauses-12.0.0/CONTRIBUTING.md000066400000000000000000000022361470750352700174700ustar00rootroot00000000000000You thought of an assertion that you'd like to add to Light.GuardClauses? That's awesome! Here is how you can add your ideas to the project: 1. **Create an issue**: before doing anything else, please create an issue where you describe what you have in mind. This way you and I can discuss and coordinate the implementation of your idea. 2. **Get the source code**: fork and clone the repository. Get accustomed to the way Light.GuardClauses is structured and how the functional and performance tests are written. Please use the same style guide as the rest of the source code. 3. **Create a branch for each feature**: besides the actual implementation, each feature should be tested functionally (in the Light.GuardClauses.Tests project) and performance-wise (in the Light.GuardClauses.Performance project). 4. **Send me a pull request for each feature**: please keep your pull requests as small as possible. Don't put two or more features in the same pull request. I think small pull requests take considerably less time to evaluate. You can read more about setting up your dev machine [in the wiki](https://github.com/feO2x/Light.GuardClauses/wiki/How-to-Contribute-and-Build). Light.GuardClauses-12.0.0/Code/000077500000000000000000000000001470750352700161065ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.AllProjects.sln000066400000000000000000000260401470750352700244770ustar00rootroot00000000000000Microsoft Visual Studio Solution File, Format Version 12.00 # Visual Studio Version 16 VisualStudioVersion = 16.0.29102.190 MinimumVisualStudioVersion = 15.0.26124.0 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Light.GuardClauses", "Light.GuardClauses\Light.GuardClauses.csproj", "{E850D655-B8C8-49B5-8336-D4743504B064}" ProjectSection(ProjectDependencies) = postProject {DB4A3982-5312-4923-9C79-C39D18A5899C} = {DB4A3982-5312-4923-9C79-C39D18A5899C} EndProjectSection EndProject Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Light.GuardClauses.Tests", "Light.GuardClauses.Tests\Light.GuardClauses.Tests.csproj", "{E804A19A-589D-49CC-A649-3092013E0133}" EndProject Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Light.GuardClauses.Performance", "Light.GuardClauses.Performance\Light.GuardClauses.Performance.csproj", "{F4EE1A0F-60E0-4077-BFC4-82387535352A}" EndProject Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Light.GuardClauses.InternalRoslynAnalyzers", "Light.GuardClauses.InternalRoslynAnalyzers\Light.GuardClauses.InternalRoslynAnalyzers.csproj", "{DB4A3982-5312-4923-9C79-C39D18A5899C}" EndProject Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "InternalAnalyzers", "InternalAnalyzers", "{A58A06DD-EEDC-4B1B-830F-0927739CFB9E}" EndProject Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Light.GuardClauses.InternalRoslynAnalyzers.Tests", "Light.GuardClauses.InternalRoslynAnalyzers.Tests\Light.GuardClauses.InternalRoslynAnalyzers.Tests.csproj", "{2FE2D52E-21B8-4C51-9983-9C1812BDEBA0}" EndProject Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "SourceCodePublishing", "SourceCodePublishing", "{0E0A86F9-C976-4FA1-8BF6-3A6A21D86BFD}" EndProject Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Light.GuardClauses.SourceCodeTransformation", "Light.GuardClauses.SourceCodeTransformation\Light.GuardClauses.SourceCodeTransformation.csproj", "{ECE42390-E3B5-49D4-9452-3B0CC04C633A}" EndProject Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Light.GuardClauses.Source", "Light.GuardClauses.Source\Light.GuardClauses.Source.csproj", "{A7B9AC78-FA4F-4BDE-9DAF-B854408AB843}" EndProject Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Versioning", "Versioning", "{176BEDC4-CFE3-4084-8213-B4EC155A7E38}" ProjectSection(SolutionItems) = preProject Version.props = Version.props EndProjectSection EndProject Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Light.GuardClauses.SourceCodeTransformation.Tests", "Light.GuardClauses.SourceCodeTransformation.Tests\Light.GuardClauses.SourceCodeTransformation.Tests.csproj", "{A2067796-F167-47BE-B367-191152DCE230}" EndProject Global GlobalSection(SolutionConfigurationPlatforms) = preSolution Debug|Any CPU = Debug|Any CPU Debug|x64 = Debug|x64 Debug|x86 = Debug|x86 Release|Any CPU = Release|Any CPU Release|x64 = Release|x64 Release|x86 = Release|x86 EndGlobalSection GlobalSection(ProjectConfigurationPlatforms) = postSolution {E850D655-B8C8-49B5-8336-D4743504B064}.Debug|Any CPU.ActiveCfg = Debug|Any CPU {E850D655-B8C8-49B5-8336-D4743504B064}.Debug|Any CPU.Build.0 = Debug|Any CPU {E850D655-B8C8-49B5-8336-D4743504B064}.Debug|x64.ActiveCfg = Debug|Any CPU {E850D655-B8C8-49B5-8336-D4743504B064}.Debug|x64.Build.0 = Debug|Any CPU {E850D655-B8C8-49B5-8336-D4743504B064}.Debug|x86.ActiveCfg = Debug|Any CPU {E850D655-B8C8-49B5-8336-D4743504B064}.Debug|x86.Build.0 = Debug|Any CPU {E850D655-B8C8-49B5-8336-D4743504B064}.Release|Any CPU.ActiveCfg = Release|Any CPU {E850D655-B8C8-49B5-8336-D4743504B064}.Release|Any CPU.Build.0 = Release|Any CPU {E850D655-B8C8-49B5-8336-D4743504B064}.Release|x64.ActiveCfg = Release|Any CPU {E850D655-B8C8-49B5-8336-D4743504B064}.Release|x64.Build.0 = Release|Any CPU {E850D655-B8C8-49B5-8336-D4743504B064}.Release|x86.ActiveCfg = Release|Any CPU {E850D655-B8C8-49B5-8336-D4743504B064}.Release|x86.Build.0 = Release|Any CPU {E804A19A-589D-49CC-A649-3092013E0133}.Debug|Any CPU.ActiveCfg = Debug|Any CPU {E804A19A-589D-49CC-A649-3092013E0133}.Debug|Any CPU.Build.0 = Debug|Any CPU {E804A19A-589D-49CC-A649-3092013E0133}.Debug|x64.ActiveCfg = Debug|Any CPU {E804A19A-589D-49CC-A649-3092013E0133}.Debug|x64.Build.0 = Debug|Any CPU {E804A19A-589D-49CC-A649-3092013E0133}.Debug|x86.ActiveCfg = Debug|Any CPU {E804A19A-589D-49CC-A649-3092013E0133}.Debug|x86.Build.0 = Debug|Any CPU {E804A19A-589D-49CC-A649-3092013E0133}.Release|Any CPU.ActiveCfg = Release|Any CPU {E804A19A-589D-49CC-A649-3092013E0133}.Release|Any CPU.Build.0 = Release|Any CPU {E804A19A-589D-49CC-A649-3092013E0133}.Release|x64.ActiveCfg = Release|Any CPU {E804A19A-589D-49CC-A649-3092013E0133}.Release|x64.Build.0 = Release|Any CPU {E804A19A-589D-49CC-A649-3092013E0133}.Release|x86.ActiveCfg = Release|Any CPU {E804A19A-589D-49CC-A649-3092013E0133}.Release|x86.Build.0 = Release|Any CPU {F4EE1A0F-60E0-4077-BFC4-82387535352A}.Debug|Any CPU.ActiveCfg = Debug|Any CPU {F4EE1A0F-60E0-4077-BFC4-82387535352A}.Debug|Any CPU.Build.0 = Debug|Any CPU {F4EE1A0F-60E0-4077-BFC4-82387535352A}.Debug|x64.ActiveCfg = Debug|Any CPU {F4EE1A0F-60E0-4077-BFC4-82387535352A}.Debug|x64.Build.0 = Debug|Any CPU {F4EE1A0F-60E0-4077-BFC4-82387535352A}.Debug|x86.ActiveCfg = Debug|Any CPU {F4EE1A0F-60E0-4077-BFC4-82387535352A}.Debug|x86.Build.0 = Debug|Any CPU {F4EE1A0F-60E0-4077-BFC4-82387535352A}.Release|Any CPU.ActiveCfg = Release|Any CPU {F4EE1A0F-60E0-4077-BFC4-82387535352A}.Release|Any CPU.Build.0 = Release|Any CPU {F4EE1A0F-60E0-4077-BFC4-82387535352A}.Release|x64.ActiveCfg = Release|Any CPU {F4EE1A0F-60E0-4077-BFC4-82387535352A}.Release|x64.Build.0 = Release|Any CPU {F4EE1A0F-60E0-4077-BFC4-82387535352A}.Release|x86.ActiveCfg = Release|Any CPU {F4EE1A0F-60E0-4077-BFC4-82387535352A}.Release|x86.Build.0 = Release|Any CPU {DB4A3982-5312-4923-9C79-C39D18A5899C}.Debug|Any CPU.ActiveCfg = Debug|Any CPU {DB4A3982-5312-4923-9C79-C39D18A5899C}.Debug|Any CPU.Build.0 = Debug|Any CPU {DB4A3982-5312-4923-9C79-C39D18A5899C}.Debug|x64.ActiveCfg = Debug|Any CPU {DB4A3982-5312-4923-9C79-C39D18A5899C}.Debug|x64.Build.0 = Debug|Any CPU {DB4A3982-5312-4923-9C79-C39D18A5899C}.Debug|x86.ActiveCfg = Debug|Any CPU {DB4A3982-5312-4923-9C79-C39D18A5899C}.Debug|x86.Build.0 = Debug|Any CPU {DB4A3982-5312-4923-9C79-C39D18A5899C}.Release|Any CPU.ActiveCfg = Release|Any CPU {DB4A3982-5312-4923-9C79-C39D18A5899C}.Release|Any CPU.Build.0 = Release|Any CPU {DB4A3982-5312-4923-9C79-C39D18A5899C}.Release|x64.ActiveCfg = Release|Any CPU {DB4A3982-5312-4923-9C79-C39D18A5899C}.Release|x64.Build.0 = Release|Any CPU {DB4A3982-5312-4923-9C79-C39D18A5899C}.Release|x86.ActiveCfg = Release|Any CPU {DB4A3982-5312-4923-9C79-C39D18A5899C}.Release|x86.Build.0 = Release|Any CPU {2FE2D52E-21B8-4C51-9983-9C1812BDEBA0}.Debug|Any CPU.ActiveCfg = Debug|Any CPU {2FE2D52E-21B8-4C51-9983-9C1812BDEBA0}.Debug|Any CPU.Build.0 = Debug|Any CPU {2FE2D52E-21B8-4C51-9983-9C1812BDEBA0}.Debug|x64.ActiveCfg = Debug|Any CPU {2FE2D52E-21B8-4C51-9983-9C1812BDEBA0}.Debug|x64.Build.0 = Debug|Any CPU {2FE2D52E-21B8-4C51-9983-9C1812BDEBA0}.Debug|x86.ActiveCfg = Debug|Any CPU {2FE2D52E-21B8-4C51-9983-9C1812BDEBA0}.Debug|x86.Build.0 = Debug|Any CPU {2FE2D52E-21B8-4C51-9983-9C1812BDEBA0}.Release|Any CPU.ActiveCfg = Release|Any CPU {2FE2D52E-21B8-4C51-9983-9C1812BDEBA0}.Release|Any CPU.Build.0 = Release|Any CPU {2FE2D52E-21B8-4C51-9983-9C1812BDEBA0}.Release|x64.ActiveCfg = Release|Any CPU {2FE2D52E-21B8-4C51-9983-9C1812BDEBA0}.Release|x64.Build.0 = Release|Any CPU {2FE2D52E-21B8-4C51-9983-9C1812BDEBA0}.Release|x86.ActiveCfg = Release|Any CPU {2FE2D52E-21B8-4C51-9983-9C1812BDEBA0}.Release|x86.Build.0 = Release|Any CPU {ECE42390-E3B5-49D4-9452-3B0CC04C633A}.Debug|Any CPU.ActiveCfg = Debug|Any CPU {ECE42390-E3B5-49D4-9452-3B0CC04C633A}.Debug|Any CPU.Build.0 = Debug|Any CPU {ECE42390-E3B5-49D4-9452-3B0CC04C633A}.Debug|x64.ActiveCfg = Debug|Any CPU {ECE42390-E3B5-49D4-9452-3B0CC04C633A}.Debug|x64.Build.0 = Debug|Any CPU {ECE42390-E3B5-49D4-9452-3B0CC04C633A}.Debug|x86.ActiveCfg = Debug|Any CPU {ECE42390-E3B5-49D4-9452-3B0CC04C633A}.Debug|x86.Build.0 = Debug|Any CPU {ECE42390-E3B5-49D4-9452-3B0CC04C633A}.Release|Any CPU.ActiveCfg = Release|Any CPU {ECE42390-E3B5-49D4-9452-3B0CC04C633A}.Release|Any CPU.Build.0 = Release|Any CPU {ECE42390-E3B5-49D4-9452-3B0CC04C633A}.Release|x64.ActiveCfg = Release|Any CPU {ECE42390-E3B5-49D4-9452-3B0CC04C633A}.Release|x64.Build.0 = Release|Any CPU {ECE42390-E3B5-49D4-9452-3B0CC04C633A}.Release|x86.ActiveCfg = Release|Any CPU {ECE42390-E3B5-49D4-9452-3B0CC04C633A}.Release|x86.Build.0 = Release|Any CPU {A7B9AC78-FA4F-4BDE-9DAF-B854408AB843}.Debug|Any CPU.ActiveCfg = Debug|Any CPU {A7B9AC78-FA4F-4BDE-9DAF-B854408AB843}.Debug|Any CPU.Build.0 = Debug|Any CPU {A7B9AC78-FA4F-4BDE-9DAF-B854408AB843}.Debug|x64.ActiveCfg = Debug|Any CPU {A7B9AC78-FA4F-4BDE-9DAF-B854408AB843}.Debug|x64.Build.0 = Debug|Any CPU {A7B9AC78-FA4F-4BDE-9DAF-B854408AB843}.Debug|x86.ActiveCfg = Debug|Any CPU {A7B9AC78-FA4F-4BDE-9DAF-B854408AB843}.Debug|x86.Build.0 = Debug|Any CPU {A7B9AC78-FA4F-4BDE-9DAF-B854408AB843}.Release|Any CPU.ActiveCfg = Release|Any CPU {A7B9AC78-FA4F-4BDE-9DAF-B854408AB843}.Release|Any CPU.Build.0 = Release|Any CPU {A7B9AC78-FA4F-4BDE-9DAF-B854408AB843}.Release|x64.ActiveCfg = Release|Any CPU {A7B9AC78-FA4F-4BDE-9DAF-B854408AB843}.Release|x64.Build.0 = Release|Any CPU {A7B9AC78-FA4F-4BDE-9DAF-B854408AB843}.Release|x86.ActiveCfg = Release|Any CPU {A7B9AC78-FA4F-4BDE-9DAF-B854408AB843}.Release|x86.Build.0 = Release|Any CPU {A2067796-F167-47BE-B367-191152DCE230}.Debug|Any CPU.ActiveCfg = Debug|Any CPU {A2067796-F167-47BE-B367-191152DCE230}.Debug|Any CPU.Build.0 = Debug|Any CPU {A2067796-F167-47BE-B367-191152DCE230}.Debug|x64.ActiveCfg = Debug|Any CPU {A2067796-F167-47BE-B367-191152DCE230}.Debug|x64.Build.0 = Debug|Any CPU {A2067796-F167-47BE-B367-191152DCE230}.Debug|x86.ActiveCfg = Debug|Any CPU {A2067796-F167-47BE-B367-191152DCE230}.Debug|x86.Build.0 = Debug|Any CPU {A2067796-F167-47BE-B367-191152DCE230}.Release|Any CPU.ActiveCfg = Release|Any CPU {A2067796-F167-47BE-B367-191152DCE230}.Release|Any CPU.Build.0 = Release|Any CPU {A2067796-F167-47BE-B367-191152DCE230}.Release|x64.ActiveCfg = Release|Any CPU {A2067796-F167-47BE-B367-191152DCE230}.Release|x64.Build.0 = Release|Any CPU {A2067796-F167-47BE-B367-191152DCE230}.Release|x86.ActiveCfg = Release|Any CPU {A2067796-F167-47BE-B367-191152DCE230}.Release|x86.Build.0 = Release|Any CPU EndGlobalSection GlobalSection(SolutionProperties) = preSolution HideSolutionNode = FALSE EndGlobalSection GlobalSection(NestedProjects) = preSolution {DB4A3982-5312-4923-9C79-C39D18A5899C} = {A58A06DD-EEDC-4B1B-830F-0927739CFB9E} {2FE2D52E-21B8-4C51-9983-9C1812BDEBA0} = {A58A06DD-EEDC-4B1B-830F-0927739CFB9E} {ECE42390-E3B5-49D4-9452-3B0CC04C633A} = {0E0A86F9-C976-4FA1-8BF6-3A6A21D86BFD} {A7B9AC78-FA4F-4BDE-9DAF-B854408AB843} = {0E0A86F9-C976-4FA1-8BF6-3A6A21D86BFD} {A2067796-F167-47BE-B367-191152DCE230} = {0E0A86F9-C976-4FA1-8BF6-3A6A21D86BFD} EndGlobalSection GlobalSection(ExtensibilityGlobals) = postSolution SolutionGuid = {1566605B-18A9-423B-BB52-1406254EDE47} EndGlobalSection EndGlobal Light.GuardClauses-12.0.0/Code/Light.GuardClauses.AllProjects.sln.DotSettings000066400000000000000000000623541470750352700267550ustar00rootroot00000000000000 True None False HINT HINT HINT WARNING <?xml version="1.0" encoding="utf-16"?><Profile name="Kenny's Kleanup"><CSReorderTypeMembers>True</CSReorderTypeMembers><CSUpdateFileHeader>True</CSUpdateFileHeader><CSEnforceVarKeywordUsageSettings>True</CSEnforceVarKeywordUsageSettings><CSMakeFieldReadonly>True</CSMakeFieldReadonly><CSArrangeQualifiers>True</CSArrangeQualifiers><CSOptimizeUsings><OptimizeUsings>True</OptimizeUsings><EmbraceInRegion>False</EmbraceInRegion><RegionName></RegionName></CSOptimizeUsings><CSShortenReferences>True</CSShortenReferences><CSReformatCode>True</CSReformatCode><CSharpFormatDocComments>True</CSharpFormatDocComments><CppReformatCode>True</CppReformatCode><XMLReformatCode>True</XMLReformatCode><CssReformatCode>True</CssReformatCode><CSCodeStyleAttributes ArrangeTypeAccessModifier="True" ArrangeTypeMemberAccessModifier="True" SortModifiers="True" RemoveRedundantParentheses="False" AddMissingParentheses="False" ArrangeBraces="False" ArrangeAttributes="False" ArrangeArgumentsStyle="False" ArrangeCodeBodyStyle="False" ArrangeVarStyle="False" /><CSMakeAutoPropertyGetOnly>True</CSMakeAutoPropertyGetOnly><RemoveCodeRedundancies>True</RemoveCodeRedundancies><HtmlReformatCode>True</HtmlReformatCode><JsInsertSemicolon>True</JsInsertSemicolon><CorrectVariableKindsDescriptor>True</CorrectVariableKindsDescriptor><JsReformatCode>True</JsReformatCode><JsFormatDocComments>True</JsFormatDocComments><FormatAttributeQuoteDescriptor>True</FormatAttributeQuoteDescriptor></Profile> C# Cleanup Kenny's Kleanup True True True True True True True True True True TOGETHER_SAME_LINE True True True True True True NEVER NEVER NEVER NEVER DO_NOT_CHANGE True 500 False RemoveIndent RemoveIndent False False False False <?xml version="1.0" encoding="utf-16"?> <Patterns xmlns="urn:schemas-jetbrains-com:member-reordering-patterns"> <TypePattern DisplayName="COM interfaces or structs"> <TypePattern.Match> <Or> <And> <Kind Is="Interface" /> <Or> <HasAttribute Name="System.Runtime.InteropServices.InterfaceTypeAttribute" /> <HasAttribute Name="System.Runtime.InteropServices.ComImport" /> </Or> </And> <Kind Is="Struct" /> </Or> </TypePattern.Match> </TypePattern> <TypePattern DisplayName="xUnit Test Class"> <TypePattern.Match> <And> <Kind Is="Class" /> <HasMember> <Or> <HasAttribute Name="Xunit.FactAttribute" /> <HasAttribute Name="Xunit.TheoryAttribute" /> </Or> </HasMember> </And> </TypePattern.Match> </TypePattern> <TypePattern DisplayName="NUnit Test Fixtures" RemoveRegions="All"> <TypePattern.Match> <And> <Kind Is="Class" /> <HasAttribute Name="NUnit.Framework.TestFixtureAttribute" Inherited="True" /> </And> </TypePattern.Match> <Entry DisplayName="Setup/Teardown Methods"> <Entry.Match> <And> <Kind Is="Method" /> <Or> <HasAttribute Name="NUnit.Framework.SetUpAttribute" Inherited="True" /> <HasAttribute Name="NUnit.Framework.TearDownAttribute" Inherited="True" /> <HasAttribute Name="NUnit.Framework.FixtureSetUpAttribute" Inherited="True" /> <HasAttribute Name="NUnit.Framework.FixtureTearDownAttribute" Inherited="True" /> </Or> </And> </Entry.Match> </Entry> <Entry DisplayName="All other members" /> <Entry Priority="100" DisplayName="Test Methods"> <Entry.Match> <And> <Kind Is="Method" /> <HasAttribute Name="NUnit.Framework.TestAttribute" /> </And> </Entry.Match> <Entry.SortBy> <Name /> </Entry.SortBy> </Entry> </TypePattern> <TypePattern DisplayName="Default Pattern"> <Entry Priority="100" DisplayName="Public Delegates"> <Entry.Match> <And> <Access Is="Public" /> <Kind Is="Delegate" /> </And> </Entry.Match> <Entry.SortBy> <Name /> </Entry.SortBy> </Entry> <Entry Priority="100" DisplayName="Public Enums"> <Entry.Match> <And> <Access Is="Public" /> <Kind Is="Enum" /> </And> </Entry.Match> <Entry.SortBy> <Name /> </Entry.SortBy> </Entry> <Entry DisplayName="Static Fields and Constants"> <Entry.Match> <Or> <Kind Is="Constant" /> <And> <Kind Is="Field" /> <Static /> </And> </Or> </Entry.Match> <Entry.SortBy> <Kind Order="Constant Field" /> </Entry.SortBy> </Entry> <Entry DisplayName="Fields"> <Entry.Match> <And> <Kind Is="Field" /> <Not> <Static /> </Not> </And> </Entry.Match> <Entry.SortBy> <Readonly /> <Name /> </Entry.SortBy> </Entry> <Entry DisplayName="Constructors"> <Entry.Match> <Kind Is="Constructor" /> </Entry.Match> <Entry.SortBy> <Static /> </Entry.SortBy> </Entry> <Entry DisplayName="Properties, Indexers"> <Entry.Match> <Or> <Kind Is="Property" /> <Kind Is="Indexer" /> </Or> </Entry.Match> </Entry> <Entry Priority="100" DisplayName="Interface Implementations"> <Entry.Match> <And> <Kind Is="Member" /> <ImplementsInterface /> </And> </Entry.Match> <Entry.SortBy> <ImplementsInterface Immediate="True" /> </Entry.SortBy> </Entry> <Entry DisplayName="All other members" /> <Entry DisplayName="Nested Types"> <Entry.Match> <Kind Is="Type" /> </Entry.Match> </Entry> </TypePattern> </Patterns> False False True Replace Replace False True False False True False <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /> <Policy Inspect="True" Prefix="I" Suffix="" Style="AaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="T" Suffix="" Style="AaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /> True D:\Programming\Light.GuardClauses\Code\Light.GuardClauses.sln.DotSettings True 1 True True True True True True True True True True True True True True True True True True True True TrueLight.GuardClauses-12.0.0/Code/Light.GuardClauses.InternalRoslynAnalyzers.Tests/000077500000000000000000000000001470750352700275125ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.InternalRoslynAnalyzers.Tests/DiagnosticIdTests.cs000066400000000000000000000122121470750352700334230ustar00rootroot00000000000000using System.Globalization; using FluentAssertions; using Xunit; namespace Light.GuardClauses.InternalRoslynAnalyzers.Tests { public static class DiagnosticIdTests { [Theory] [InlineData("Light.GuardClauses.NonDefaultParameterName", false)] // No '.' character allowed [InlineData("LightGuardClauses-NonDefaultParameterName", false)] // No '-' character allowed [InlineData("LightGuardClauses_NonDefaultParameterName", true)] // Underscores are allowed public static void ValidDiagnosticIdentifiers(string identifier, bool expected) => UnicodeCharacterUtilities.IsValidIdentifier(identifier).Should().Be(expected); } public static class UnicodeCharacterUtilities { /// /// Check that the name is a valid Unicode identifier. /// public static bool IsValidIdentifier(string name) { if (string.IsNullOrEmpty(name)) return false; if (!IsIdentifierStartCharacter(name[0])) return false; var nameLength = name.Length; for (var i = 1; i < nameLength; i++) //NB: start at 1 { if (!IsIdentifierPartCharacter(name[i])) return false; } return true; } public static bool IsIdentifierStartCharacter(char ch) { // identifier-start-character: // letter-character // _ (the underscore character U+005F) if (ch < 'a') // '\u0061' { if (ch < 'A') // '\u0041' return false; return ch <= 'Z' // '\u005A' || ch == '_'; // '\u005F' } if (ch <= 'z') // '\u007A' return true; if (ch <= '\u007F') // max ASCII return false; return IsLetterChar(CharUnicodeInfo.GetUnicodeCategory(ch)); } public static bool IsIdentifierPartCharacter(char ch) { // identifier-part-character: // letter-character // decimal-digit-character // connecting-character // combining-character // formatting-character if (ch < 'a') // '\u0061' { if (ch < 'A') // '\u0041' return ch >= '0' // '\u0030' && ch <= '9'; // '\u0039' return ch <= 'Z' // '\u005A' || ch == '_'; // '\u005F' } if (ch <= 'z') // '\u007A' return true; if (ch <= '\u007F') // max ASCII return false; var cat = CharUnicodeInfo.GetUnicodeCategory(ch); return IsLetterChar(cat) || IsDecimalDigitChar(cat) || IsConnectingChar(cat) || IsCombiningChar(cat) || IsFormattingChar(cat); } private static bool IsLetterChar(UnicodeCategory cat) { // letter-character: // A Unicode character of classes Lu, Ll, Lt, Lm, Lo, or Nl // A Unicode-escape-sequence representing a character of classes Lu, Ll, Lt, Lm, Lo, or Nl switch (cat) { case UnicodeCategory.UppercaseLetter: case UnicodeCategory.LowercaseLetter: case UnicodeCategory.TitlecaseLetter: case UnicodeCategory.ModifierLetter: case UnicodeCategory.OtherLetter: case UnicodeCategory.LetterNumber: return true; } return false; } private static bool IsDecimalDigitChar(UnicodeCategory cat) { // decimal-digit-character: // A Unicode character of the class Nd // A unicode-escape-sequence representing a character of the class Nd return cat == UnicodeCategory.DecimalDigitNumber; } private static bool IsConnectingChar(UnicodeCategory cat) { // connecting-character: // A Unicode character of the class Pc // A unicode-escape-sequence representing a character of the class Pc return cat == UnicodeCategory.ConnectorPunctuation; } private static bool IsFormattingChar(UnicodeCategory cat) { // formatting-character: // A Unicode character of the class Cf // A unicode-escape-sequence representing a character of the class Cf return cat == UnicodeCategory.Format; } private static bool IsCombiningChar(UnicodeCategory cat) { // combining-character: // A Unicode character of classes Mn or Mc // A Unicode-escape-sequence representing a character of classes Mn or Mc switch (cat) { case UnicodeCategory.NonSpacingMark: case UnicodeCategory.SpacingCombiningMark: return true; } return false; } } }Light.GuardClauses.InternalRoslynAnalyzers.Tests.csproj000066400000000000000000000014121470750352700422570ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.InternalRoslynAnalyzers.Tests net8.0 PreserveNewest ParameterNameAndMessageCommentsTests.cs000066400000000000000000000141521470750352700371670ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.InternalRoslynAnalyzers.Testsusing System.Threading.Tasks; using FluentAssertions; using Microsoft.CodeAnalysis.Diagnostics; using Xunit; namespace Light.GuardClauses.InternalRoslynAnalyzers.Tests { public static class ParameterNameAndMessageCommentsTests { private static readonly DiagnosticAnalyzer Analyzer = new XmlCommentAnalyzer(); private const string MissingParameterNameComment = @" using System.Runtime.CompilerServices; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses { public static class CommonAssertions { /// /// Ensures that the specified reference is not null, or otherwise throws an . /// /// The reference to be checked. /// /// The message that will be passed to the resulting exception (optional). /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T MustNotBeNull(this T parameter, string parameterName = null, string message = null) { if (parameter == null) Throw.MustNotBeNull(parameterName, message); return parameter; } } }"; private const string FixedParameterNameComment = @" using System.Runtime.CompilerServices; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses { public static class CommonAssertions { /// /// Ensures that the specified reference is not null, or otherwise throws an . /// /// The reference to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T MustNotBeNull(this T parameter, string parameterName = null, string message = null) { if (parameter == null) Throw.MustNotBeNull(parameterName, message); return parameter; } } }"; [Fact] public static async Task AnalyzeParameterName() { var diagnostics = await Analyzer.AnalyzeAsync(MissingParameterNameComment); diagnostics.Should().HaveCount(1); diagnostics[0].Descriptor.Should().BeSameAs(Descriptors.ParameterNameComment); } [Fact] public static async Task FixParameterName() { var codeFix = new ParameterNameXmlCommentFix(); var resultingCode = await codeFix.ApplyFixAsync(MissingParameterNameComment, Analyzer); resultingCode.Should().Be(FixedParameterNameComment); } private const string MissingMessageWithExistingException = @" using System.Runtime.CompilerServices; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses { public static class CommonAssertions { /// /// Ensures that the specified reference is not null, or otherwise throws an . /// /// The reference to be checked. /// The name of the parameter (optional). /// /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T MustNotBeNull(this T parameter, string parameterName = null, string message = null) { if (parameter == null) Throw.MustNotBeNull(parameterName, message); return parameter; } } }"; private const string FixedMessageCommentWithExistingException = @" using System.Runtime.CompilerServices; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses { public static class CommonAssertions { /// /// Ensures that the specified reference is not null, or otherwise throws an . /// /// The reference to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T MustNotBeNull(this T parameter, string parameterName = null, string message = null) { if (parameter == null) Throw.MustNotBeNull(parameterName, message); return parameter; } } }"; [Fact] public static async Task AnalyzeMissingMessage() { var diagnostics = await Analyzer.AnalyzeAsync(MissingMessageWithExistingException); diagnostics.Should().HaveCount(1); diagnostics[0].Descriptor.Should().BeSameAs(Descriptors.MessageComment); } [Fact] public static async Task FixMissingMessageWithExistingExceptionComment() { var codeFix = new MessageXmlCommentFix(); var resultingCode = await codeFix.ApplyFixAsync(MissingMessageWithExistingException, Analyzer); resultingCode.Should().Be(FixedMessageCommentWithExistingException); } [Fact] public static async Task AnalyzeFixedMessageCode() { var diagnostics = await Analyzer.AnalyzeAsync(FixedMessageCommentWithExistingException); diagnostics.Should().BeEmpty(); } } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.InternalRoslynAnalyzers.Tests/RoslynExtensions.cs000066400000000000000000000114231470750352700334100ustar00rootroot00000000000000using System.Collections.Generic; using System.Collections.Immutable; using System.IO; using System.Linq; using System.Runtime.CompilerServices; using System.Threading; using System.Threading.Tasks; using Microsoft.CodeAnalysis; using Microsoft.CodeAnalysis.CodeActions; using Microsoft.CodeAnalysis.CodeFixes; using Microsoft.CodeAnalysis.CSharp; using Microsoft.CodeAnalysis.Diagnostics; using Microsoft.CodeAnalysis.Text; namespace Light.GuardClauses.InternalRoslynAnalyzers.Tests { public static class RoslynExtensions { public static readonly MetadataReference MsCoreLibReference = MetadataReference.CreateFromFile(typeof(object).Assembly.Location); public static readonly MetadataReference SystemCoreReference = MetadataReference.CreateFromFile(typeof(Enumerable).Assembly.Location); public static readonly MetadataReference CompilationReference = MetadataReference.CreateFromFile(typeof(Compilation).Assembly.Location); public static readonly MetadataReference CSharpCompilationReference = MetadataReference.CreateFromFile(typeof(CSharpCompilation).Assembly.Location); public static readonly IReadOnlyList AllReferences = new[] { MsCoreLibReference, SystemCoreReference, CompilationReference, CSharpCompilationReference }; public static async Task> AnalyzeAsync(this DiagnosticAnalyzer analyzer, string code, [CallerMemberName] string projectName = null) { var (_, compilation) = await CreateLightGuardClausesDllInMemory(projectName, code); return await compilation.WithAnalyzers(ImmutableArray.Create(analyzer)) .GetAllDiagnosticsAsync(); } public static async Task ApplyFixAsync(this CodeFixProvider codeFixProvider, string code, DiagnosticAnalyzer analyzer, [CallerMemberName] string projectName = null) { var (document, compilation) = await CreateLightGuardClausesDllInMemory(projectName, code); var diagnostics = await compilation.WithAnalyzers(ImmutableArray.Create(analyzer)) .GetAllDiagnosticsAsync(); var codeActions = new List(); var context = new CodeFixContext(document, diagnostics[0], (action, diagnostic) => codeActions.Add(action), CancellationToken.None); await codeFixProvider.RegisterCodeFixesAsync(context); document = (await codeActions[0].GetOperationsAsync(CancellationToken.None)).OfType() .Single() .ChangedSolution .GetDocument(document.Id); return (await document.GetSyntaxRootAsync()).GetText().ToString(); } public static async Task<(Document, Compilation)> CreateLightGuardClausesDllInMemory(string projectName, string code) { var projectId = ProjectId.CreateNewId(projectName); var codeFileName = $"{projectName}Source.cs"; var codeFileId = DocumentId.CreateNewId(projectId, codeFileName); var project = new AdhocWorkspace().CurrentSolution .AddProject(projectId, projectName, projectName, LanguageNames.CSharp) .AddMetadataReferences(projectId, AllReferences) .AddDocument(codeFileId, codeFileName, SourceText.From(code)) .AddThrowClass(projectId) .GetProject(projectId) .WithCompilationOptions(new CSharpCompilationOptions(OutputKind.DynamicallyLinkedLibrary)); var document = project.GetDocument(codeFileId); var compilation = await project.GetCompilationAsync(); return (document, compilation); } private static Solution AddThrowClass(this Solution solution, ProjectId projectId) { const string fileName = "Throw.cs"; return solution.AddDocument(DocumentId.CreateNewId(projectId, fileName), fileName, SourceText.From(File.ReadAllText(fileName))); } } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.InternalRoslynAnalyzers.Tests/Throw.cs000066400000000000000000000015541470750352700311510ustar00rootroot00000000000000using System; // ReSharper disable once CheckNamespace namespace Light.GuardClauses.Exceptions { /// /// Provides static factory methods that throw default exceptions. /// public static class Throw { /// /// Throws the default , using the optional parameter name and message. /// public static void MustNotBeNull(string parameterName = null, string message = null) => throw new ArgumentNullException(parameterName, message ?? $"{parameterName ?? "The value"} must not be null."); /// /// Throws the exception that is returned by . /// public static void CustomException(Func exceptionFactory) => throw exceptionFactory(); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.InternalRoslynAnalyzers/000077500000000000000000000000001470750352700264115ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.InternalRoslynAnalyzers/Constants.cs000066400000000000000000000007551470750352700307230ustar00rootroot00000000000000namespace Light.GuardClauses.InternalRoslynAnalyzers { public static class ParameterNameConstants { public const string ParameterName = "parameterName"; public const string DefaultComment = "The name of the parameter (optional)."; } public static class MessageConstants { public const string ParameterName = "message"; public const string DefaultComment = "The message that will be passed to the resulting exception (optional)."; } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.InternalRoslynAnalyzers/Descriptors.cs000066400000000000000000000031101470750352700312340ustar00rootroot00000000000000using Microsoft.CodeAnalysis; namespace Light.GuardClauses.InternalRoslynAnalyzers { public static class Descriptors { public const string DescriptorIdPrefix = "LightGuardClauses"; public const string XmlCommentsCategory = "XML Comments"; #pragma warning disable RS1017 // DiagnosticId for analyzers must be a non-null constant. public static readonly DiagnosticDescriptor ParameterNameComment = new DiagnosticDescriptor("ParameterNameComment".CreateDescriptorId(), "Use default XML comment for parameterName", $"Use the default comment for parameterName: \"{ParameterNameConstants.DefaultComment}\"", XmlCommentsCategory, DiagnosticSeverity.Warning, true); public static readonly DiagnosticDescriptor MessageComment = new DiagnosticDescriptor("MessageComment".CreateDescriptorId(), "Use default XML comment for message", $"Use the default comment for message: \"{MessageConstants.DefaultComment}\"", XmlCommentsCategory, DiagnosticSeverity.Warning, true); #pragma warning restore RS1017 // DiagnosticId for analyzers must be a non-null constant. private static string CreateDescriptorId(this string partialId) => $"{DescriptorIdPrefix}_{partialId}"; } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.InternalRoslynAnalyzers/Extensions.cs000066400000000000000000000077761470750352700311200ustar00rootroot00000000000000using System.Collections.Immutable; using System.Linq; using Microsoft.CodeAnalysis; using Microsoft.CodeAnalysis.CSharp.Syntax; using Microsoft.CodeAnalysis.Diagnostics; namespace Light.GuardClauses.InternalRoslynAnalyzers { internal static class Extensions { public static bool IsStandardExceptionAssertion(this IMethodSymbol methodSymbol) => methodSymbol.MethodKind == MethodKind.Ordinary && methodSymbol.IsStatic && methodSymbol.Name.StartsWith("Must") && methodSymbol.Parameters.ContainsParameterNameAndMessage(); public static bool ContainsParameterNameAndMessage(this ImmutableArray parameters) { // The method must have at least 3 parameters (the assertion target, parameterName, and message) if (parameters.Length < 3) return false; var wasParameterNameFound = false; var wasMessageFound = false; for (var i = 0; i < parameters.Length; ++i) { var currentParameter = parameters[i]; if (currentParameter.Type.SpecialType != SpecialType.System_String || !currentParameter.IsOptional) continue; if (currentParameter.Name.Equals(ParameterNameConstants.ParameterName)) wasParameterNameFound = true; else if (currentParameter.Name.Equals(MessageConstants.ParameterName)) wasMessageFound = true; } return wasParameterNameFound && wasMessageFound; } public static void ReportNonDefaultParameterNameComment(this SymbolAnalysisContext context, DocumentationCommentTriviaSyntax documentationSyntax) { var xmlCommentElement = documentationSyntax.GetXmlCommentParam(ParameterNameConstants.ParameterName); if (xmlCommentElement == null) return; if (xmlCommentElement.GetSimpleCommentText().EqualsString(ParameterNameConstants.DefaultComment)) return; context.ReportDiagnostic(Diagnostic.Create(Descriptors.ParameterNameComment, xmlCommentElement.GetLocation())); } public static void ReportMessageComment(this SymbolAnalysisContext context, DocumentationCommentTriviaSyntax documentationSyntax) { var xmlCommentElement = documentationSyntax.GetXmlCommentParam(MessageConstants.ParameterName); if (xmlCommentElement == null) return; if (xmlCommentElement.GetSimpleCommentText().EqualsString(MessageConstants.DefaultComment)) return; context.ReportDiagnostic(Diagnostic.Create(Descriptors.MessageComment, xmlCommentElement.GetLocation())); } public static XmlElementSyntax GetXmlCommentParam(this DocumentationCommentTriviaSyntax documentationSyntax, string xmlParamName) => documentationSyntax?.ChildNodes() .OfType() .FirstOrDefault(xmlElementSyntax => xmlElementSyntax.IsXmlCommentParam(xmlParamName)); public static bool IsXmlCommentParam(this XmlElementSyntax xmlElement, string xmlParamName) => xmlElement.StartTag.Name.LocalName.Text == "param" && xmlElement.StartTag.Attributes.Any(attribute => attribute is XmlNameAttributeSyntax nameAttribute && nameAttribute.Identifier.Identifier.Text == xmlParamName); private static XmlTextSyntax GetSimpleCommentText(this XmlElementSyntax xmlCommentParam) => xmlCommentParam.Content.Count != 1 ? null : xmlCommentParam.Content[0] as XmlTextSyntax; public static bool EqualsString(this XmlTextSyntax commentTextSyntax, string value) => commentTextSyntax?.TextTokens.Count == 1 && commentTextSyntax.TextTokens[0].Text.Equals(value); } }Light.GuardClauses.InternalRoslynAnalyzers.csproj000066400000000000000000000005411470750352700400570ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.InternalRoslynAnalyzers netstandard2.0 true Light.GuardClauses-12.0.0/Code/Light.GuardClauses.InternalRoslynAnalyzers/MessageXmlCommentFix.cs000066400000000000000000000043011470750352700327750ustar00rootroot00000000000000using System.Collections.Immutable; using System.Composition; using System.Threading.Tasks; using Microsoft.CodeAnalysis; using Microsoft.CodeAnalysis.CodeActions; using Microsoft.CodeAnalysis.CodeFixes; using Microsoft.CodeAnalysis.CSharp.Syntax; using static Microsoft.CodeAnalysis.CSharp.SyntaxFactory; namespace Light.GuardClauses.InternalRoslynAnalyzers { [ExportCodeFixProvider(LanguageNames.CSharp), Shared] public sealed class MessageXmlCommentFix : CodeFixProvider { public override ImmutableArray FixableDiagnosticIds { get; } = ImmutableArray.Create(Descriptors.MessageComment.Id); public override async Task RegisterCodeFixesAsync(CodeFixContext context) { var syntaxRoot = await context.Document.GetSyntaxRootAsync(context.CancellationToken).ConfigureAwait(false); var diagnostic = context.Diagnostics[0]; var xmlElementSyntax = (XmlElementSyntax) syntaxRoot.FindNode(diagnostic.Location.SourceSpan, true); var title = diagnostic.Descriptor.Title.ToString(); context.RegisterCodeFix(CodeAction.Create(title, cancellationToken => SetDefaultXmlCommentForMessage(context.Document, syntaxRoot, xmlElementSyntax), title), diagnostic); } public override FixAllProvider GetFixAllProvider() => null; private static Task SetDefaultXmlCommentForMessage(Document document, SyntaxNode syntaxRoot, XmlElementSyntax xmlElementSyntax) => Task.FromResult( document.WithSyntaxRoot( syntaxRoot.ReplaceNode( xmlElementSyntax, xmlElementSyntax .WithContent( new SyntaxList( XmlText(MessageConstants.DefaultComment)))))); } }ParameterNameXmlCommentFix.cs000066400000000000000000000043071470750352700340610ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.InternalRoslynAnalyzersusing System.Collections.Immutable; using System.Composition; using System.Threading.Tasks; using Microsoft.CodeAnalysis; using Microsoft.CodeAnalysis.CodeActions; using Microsoft.CodeAnalysis.CodeFixes; using Microsoft.CodeAnalysis.CSharp.Syntax; using static Microsoft.CodeAnalysis.CSharp.SyntaxFactory; namespace Light.GuardClauses.InternalRoslynAnalyzers { [ExportCodeFixProvider(LanguageNames.CSharp), Shared] public sealed class ParameterNameXmlCommentFix : CodeFixProvider { public override ImmutableArray FixableDiagnosticIds { get; } = ImmutableArray.Create(Descriptors.ParameterNameComment.Id); public override async Task RegisterCodeFixesAsync(CodeFixContext context) { var syntaxRoot = await context.Document.GetSyntaxRootAsync(context.CancellationToken).ConfigureAwait(false); var diagnostic = context.Diagnostics[0]; var xmlElementSyntax = (XmlElementSyntax) syntaxRoot.FindNode(diagnostic.Location.SourceSpan, true); var title = diagnostic.Descriptor.Title.ToString(); context.RegisterCodeFix(CodeAction.Create(title, cancellationToken => SetDefaultXmlCommentForParameterName(context.Document, syntaxRoot, xmlElementSyntax), title), diagnostic); } public override FixAllProvider GetFixAllProvider() => null; private static Task SetDefaultXmlCommentForParameterName(Document document, SyntaxNode syntaxRoot, XmlElementSyntax xmlElementSyntax) => Task.FromResult( document.WithSyntaxRoot( syntaxRoot.ReplaceNode( xmlElementSyntax, xmlElementSyntax.WithContent( new SyntaxList( XmlText(ParameterNameConstants.DefaultComment)))))); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.InternalRoslynAnalyzers/XmlCommentAnalyzer.cs000066400000000000000000000041551470750352700325360ustar00rootroot00000000000000using System.Collections.Immutable; using System.Linq; using Microsoft.CodeAnalysis; using Microsoft.CodeAnalysis.CSharp; using Microsoft.CodeAnalysis.CSharp.Syntax; using Microsoft.CodeAnalysis.Diagnostics; namespace Light.GuardClauses.InternalRoslynAnalyzers { [DiagnosticAnalyzer(LanguageNames.CSharp)] public sealed class XmlCommentAnalyzer : DiagnosticAnalyzer { private static readonly ImmutableArray InternalSupportedDiagnostics = ImmutableArray.CreateRange(new[] { Descriptors.ParameterNameComment, Descriptors.MessageComment }); public override ImmutableArray SupportedDiagnostics => InternalSupportedDiagnostics; public override void Initialize(AnalysisContext context) { context.ConfigureGeneratedCodeAnalysis(GeneratedCodeAnalysisFlags.Analyze | GeneratedCodeAnalysisFlags.ReportDiagnostics); context.EnableConcurrentExecution(); context.RegisterSymbolAction(AnalyzeXmlCommentsForParameterNameAndMessage, SymbolKind.Method); } private static void AnalyzeXmlCommentsForParameterNameAndMessage(SymbolAnalysisContext symbolAnalysisContext) { var methodSymbol = (IMethodSymbol) symbolAnalysisContext.Symbol; if (!methodSymbol.IsStandardExceptionAssertion()) return; if (methodSymbol.DeclaringSyntaxReferences.Length != 1 || !(methodSymbol.DeclaringSyntaxReferences[0].GetSyntax() is MethodDeclarationSyntax methodDeclarationSyntax) || !(methodDeclarationSyntax.DescendantTrivia() .SingleOrDefault(trivia => trivia.IsKind(SyntaxKind.SingleLineDocumentationCommentTrivia)) .GetStructure() is DocumentationCommentTriviaSyntax documentationSyntax)) return; symbolAnalysisContext.ReportNonDefaultParameterNameComment(documentationSyntax); symbolAnalysisContext.ReportMessageComment(documentationSyntax); } } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/000077500000000000000000000000001470750352700237765ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/CollectionAssertions/000077500000000000000000000000001470750352700301445ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/CollectionAssertions/CountBenchmark.cs000066400000000000000000000052451470750352700334040ustar00rootroot00000000000000using System; using System.Collections; using System.Collections.Generic; using System.Linq; using BenchmarkDotNet.Attributes; using Light.GuardClauses.FrameworkExtensions; namespace Light.GuardClauses.Performance.CollectionAssertions; public class ListCountBenchmark { public List List; // ReSharper disable once UnusedAutoPropertyAccessor.Global [Params(100, 1000)] public int NumberOfItems { get; set; } [GlobalSetup] public void Setup() => List = Enumerable.Range(1, NumberOfItems).ToList(); // ReSharper disable once UseCollectionCountProperty [Benchmark(Baseline = true)] public int LinqCount() => List.Count(); [Benchmark] public int ExistingEnumerableCount() => EnumerableExtensions.Count(List); [Benchmark] public int NewEnumerableOfTGetCount() => List.GetCount(); } public class StringCountBenchmark { public string String; // ReSharper disable once UnusedAutoPropertyAccessor.Global [Params(100, 1000)] public int NumberOfItems { get; set; } [GlobalSetup] public void Setup() { var random = new Random(42); var array = new char[NumberOfItems]; for (var i = 0; i < array.Length; i++) { array[i] = (char) random.Next('a', 'z' + 1); } String = new (array); } // ReSharper disable once UseCollectionCountProperty [Benchmark(Baseline = true)] public int LinqCount() => String.Count(); [Benchmark] public int ExistingEnumerableCount() => EnumerableExtensions.Count(String); [Benchmark] public int NewEnumerableOfTGetCount() => String.GetCount(); } public class MyImmutableArrayCountBenchmark { public MyImmutableArray MyArray; // ReSharper disable once UnusedAutoPropertyAccessor.Global [Params(100, 1000)] public int NumberOfItems { get; set; } [GlobalSetup] public void Setup() => MyArray = new (Enumerable.Range(1, NumberOfItems).ToArray()); // ReSharper disable once UseCollectionCountProperty [Benchmark(Baseline = true)] public int LinqCount() => MyArray.Count(); [Benchmark] public int ExistingEnumerableCount() => EnumerableExtensions.Count(MyArray); [Benchmark] public int NewEnumerableOfTGetCount() => MyArray.GetCount(); } public sealed class MyImmutableArray : IReadOnlyList { private readonly T[] _array; public MyImmutableArray(T[] array) => _array = array; public IEnumerator GetEnumerator() => ((IEnumerable) _array).GetEnumerator(); IEnumerator IEnumerable.GetEnumerator() => _array.GetEnumerator(); public int Count => _array.Length; public T this[int index] => _array[index]; } IsNullOrEmptyBenchmark.cs000066400000000000000000000032761470750352700347650ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/CollectionAssertionsusing System.Collections.Generic; using System.Collections.ObjectModel; using System.Linq; using BenchmarkDotNet.Attributes; namespace Light.GuardClauses.Performance.CollectionAssertions { public class IsNullOrEmptyBenchmark { public List CollectionWithItems = new List { "Foo", "Bar", "Baz" }; public ObservableCollection EmptyCollection = new ObservableCollection(); public IEnumerable LazyEnumerable = CreateLazyEnumerable(); public IReadOnlyList NullCollection = null; private static IEnumerable CreateLazyEnumerable() { yield return "Foo"; yield return "Bar"; yield return "Baz"; } [Benchmark(Baseline = true)] public bool ImperativeNull() => NullCollection == null || NullCollection.Count == 0; [Benchmark] public bool ImperativeEmpty() => EmptyCollection == null || EmptyCollection.Count == 0; [Benchmark] public bool ImperativeNotEmpty() => CollectionWithItems == null || CollectionWithItems.Count == 0; [Benchmark] public bool ImperativeLazyEnumerable() => LazyEnumerable == null || !LazyEnumerable.Any(); [Benchmark] public bool LightGuardClausesNull() => NullCollection.IsNullOrEmpty(); [Benchmark] public bool LightGuardClausesEmpty() => EmptyCollection.IsNullOrEmpty(); [Benchmark] public bool LightGuardClausesNotEmpty() => CollectionWithItems.IsNullOrEmpty(); [Benchmark] public bool LightGuardClausesLazyEnumerable() => LazyEnumerable.IsNullOrEmpty(); } }IsOneOfBenchmark.cs000066400000000000000000000100221470750352700335240ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/CollectionAssertionsusing System.Collections.Generic; using System.Linq; using BenchmarkDotNet.Attributes; namespace Light.GuardClauses.Performance.CollectionAssertions { public class IsOneOfBenchmark { public IList InterfaceList; public IEnumerable LazyEnumerable; public List List = new List { 84, 2003, -45423, 2, 50000 }; public int ValueA = 2003; public int ValueB = 100410; public IsOneOfBenchmark() { InterfaceList = List; LazyEnumerable = InitializeLazyEnumerable(); } private static IEnumerable InitializeLazyEnumerable() { yield return 84; yield return 2003; yield return -45423; yield return 2; yield return 50000; } [Benchmark(Baseline = true)] public bool ImperativeList() => List.Contains(ValueA); [Benchmark] public bool ImperativeListNoHit() => List.Contains(ValueB); [Benchmark] public bool ImperativeInterface() => InterfaceList.Contains(ValueA); [Benchmark] public bool ImperativeInterfaceNotHit() => InterfaceList.Contains(ValueB); [Benchmark] public bool ImperativeInterfaceForLoop() { for (var i = 0; i < InterfaceList.Count; ++i) { if (InterfaceList[i] == ValueA) return true; } return false; } [Benchmark] public bool ImperativeInterfaceForLoopNoHit() { for (var i = 0; i < InterfaceList.Count; ++i) { if (InterfaceList[i] == ValueB) return true; } return false; } [Benchmark] public bool ImperativeInterfaceForeachLoop() { foreach (var item in InterfaceList) { if (item == ValueA) return true; } return false; } [Benchmark] public bool ImperativeInterfaceForeachLoopNotHit() { foreach (var item in InterfaceList) { if (item == ValueB) return true; } return false; } [Benchmark] public bool ImperativeLazy() { foreach (var item in LazyEnumerable) { if (item == ValueA) return true; } return false; } [Benchmark] public bool ImperativeLazyNoHit() { foreach (var item in LazyEnumerable) { if (item == ValueB) return true; } return false; } [Benchmark] public bool ImperativeLazyToList() { var list = LazyEnumerable.ToList(); foreach (var item in list) { if (item == ValueA) return true; } return false; } [Benchmark] public bool ImperativeLazyToListNoHit() { var list = LazyEnumerable.ToList(); foreach (var item in list) { if (item == ValueB) return true; } return false; } [Benchmark] public bool LightGuardClausesList() => ValueA.IsOneOf(List); [Benchmark] public bool LightGuardClausesListNoHit() => ValueB.IsOneOf(List); [Benchmark] public bool LightGuardClausesInterface() => ValueA.IsOneOf(InterfaceList); [Benchmark] public bool LightGuardClausesInterfaceNoHit() => ValueB.IsOneOf(InterfaceList); [Benchmark] public bool LightGuardClausesLazy() => ValueA.IsOneOf(LazyEnumerable); [Benchmark] public bool LightGuardClausesLazyNoHit() => ValueB.IsOneOf(LazyEnumerable); } }MustBeOneOfBenchmark.cs000066400000000000000000000045001470750352700343540ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/CollectionAssertionsusing System; using System.Collections.Generic; using System.Collections.ObjectModel; using System.Linq; using System.Text; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; using Light.GuardClauses.FrameworkExtensions; namespace Light.GuardClauses.Performance.CollectionAssertions { public class MustBeOneOfBenchmark { public int Value = 4; public IList Items = new ObservableCollection { 1, 2, 3, 4, 5 }; [Benchmark(Baseline = true)] public int ImperativeVersion() { if (!Items.Contains(Value)) throw new ValueIsNotOneOfException(nameof(Value)); return Value; } [Benchmark] public int LightGuardClauses() => Value.MustBeOneOf(Items, nameof(Value)); [Benchmark] public int LightGuardClausesCustomException() => Value.MustBeOneOf(Items, (v, i) => new Exception($"{i} is simply wrong")); [Benchmark] public int OldVersion() => Value.OldMustBeOneOf(Items, parameterName: nameof(Value)); } public static class MustBeOneOfExtensions { public static T OldMustBeOneOf(this T parameter, IEnumerable items, IEqualityComparer equalityComparer = null, string parameterName = null, string message = null, Func exception = null) { // ReSharper disable PossibleMultipleEnumeration items.MustNotBeNull(nameof(items)); equalityComparer = equalityComparer ?? EqualityComparer.Default; if (items.Contains(parameter, equalityComparer)) return parameter; throw exception?.Invoke() ?? new ArgumentOutOfRangeException(parameterName, parameter, message ?? new StringBuilder().AppendLine($"{parameterName ?? "The value"} must be one of the items") .AppendItemsWithNewLine(items) .AppendLine($"but you specified {parameter}.") .ToString()); // ReSharper restore PossibleMultipleEnumeration } } }MustContainBenchmark.cs000066400000000000000000000041141470750352700344730ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/CollectionAssertionsusing System; using System.Collections.Generic; using System.Linq; using System.Text; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; using Light.GuardClauses.FrameworkExtensions; namespace Light.GuardClauses.Performance.CollectionAssertions { public class MustContainBenchmark { public IList Collection = new[] { 42, 35, 89 }; [Benchmark(Baseline = true)] public IList ImperativeVersion() { if (Collection == null) throw new ArgumentNullException(nameof(Collection)); if (!Collection.Contains(89)) throw new MissingItemException(nameof(Collection)); return Collection; } [Benchmark] public IList LightGuardClauses() => Collection.MustContain(89, nameof(Collection)); [Benchmark] public IList LightGuardClausesCustomException() => Collection.MustContain(89, (c, i) => new Exception($"Collection does not contain {i}.")); [Benchmark] public IEnumerable OldVersion() => Collection.OldMustContain(89, nameof(Collection)); } public static class MustContainExtensions { public static IEnumerable OldMustContain(this IEnumerable parameter, T item, string parameterName = null, string message = null, Func exception = null) { // ReSharper disable PossibleMultipleEnumeration parameter.MustNotBeNull(parameterName); if (parameter.Contains(item)) return parameter; throw exception?.Invoke() ?? new CollectionException(message ?? new StringBuilder().AppendLine($"{parameterName ?? "The collection"} must contain value \"{item.ToStringOrNull()}\", but does not.") .AppendCollectionContent(parameter) .ToString(), parameterName); // ReSharper restore PossibleMultipleEnumeration } } }MustHaveCountBenchmark.cs000066400000000000000000000053231470750352700347770ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/CollectionAssertionsusing System; using System.Collections.Generic; using System.Linq; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses.Performance.CollectionAssertions { public class MustHaveCountBenchmark { public List Collection = new List{"Foo", "Bar"}; public string String = "Baz"; [Benchmark(Baseline = true)] public List ImperativeVersionCollection() { if (Collection == null) throw new ArgumentNullException(nameof(Collection)); if (Collection.Count != 2) throw new InvalidCollectionCountException(nameof(Collection)); return Collection; } [Benchmark] public string ImperativeVersionString() { if (String == null) throw new ArgumentNullException(nameof(String)); if (String.Length != 3) throw new InvalidCollectionCountException(nameof(String)); return String; } [Benchmark] public List LightGuardClausesCollection() => Collection.MustHaveCount(2, nameof(Collection)); [Benchmark] public string LightGuardClausesString() => String.MustHaveCount(3, nameof(String)); [Benchmark] public List LightGuardClausesCustomExceptionCollection() => Collection.MustHaveCount(2, (collection, count) => new Exception($"Collection has not count {count}")); [Benchmark] public string LightGuardClausesCustomExceptionString() => String.MustHaveCount(3, (collection, count) => new Exception($"Collection has not count {count}")); [Benchmark] public IEnumerable OldVersionCollection() => Collection.OldMustHaveCount(2, nameof(Collection)); [Benchmark] public IEnumerable OldVersionString() => String.OldMustHaveCount(3, nameof(String)); } public static class MustHaveCountExtensions { public static IEnumerable OldMustHaveCount(this IEnumerable parameter, int count, string parameterName = null, string message = null, Func exception = null) { // ReSharper disable PossibleMultipleEnumeration parameter.MustNotBeNull(); count.MustNotBeLessThan(0, nameof(count)); if (parameter.Count() == count) return parameter; throw exception?.Invoke() ?? new CollectionException(message ?? $"{parameterName ?? "The collection"} must have count {count}, but you specified a collection with count {parameter.Count()}.", parameterName); // ReSharper restore PossibleMultipleEnumeration } } } MustHaveMaximumCountBenchmark.cs000066400000000000000000000045311470750352700363350ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/CollectionAssertionsusing System; using System.Collections.Generic; using System.Text; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; using Light.GuardClauses.FrameworkExtensions; namespace Light.GuardClauses.Performance.CollectionAssertions { public class MustHaveMaximumCountBenchmark { public ICollection Collection = new[] { 1, 2, 3, 4, 5 }; public int MaximumCount = 5; [Benchmark(Baseline = true)] public ICollection ImperativeVersion() { if (Collection == null) throw new ArgumentNullException(nameof(Collection)); if (Collection.Count > MaximumCount) throw new InvalidCollectionCountException(nameof(Collection)); return Collection; } [Benchmark] public ICollection LightGuardClauses() => Collection.MustHaveMaximumCount(MaximumCount, nameof(Collection)); [Benchmark] public ICollection LightGuardClausesCustomException() => Collection.MustHaveMaximumCount(MaximumCount, (i, c) => new Exception($"Too much items, man, too much items ({c})")); [Benchmark] public IEnumerable OldVersion() => Collection.OldMustHaveMaximumCount(MaximumCount, nameof(Collection)); } public static class MustHaveMaximumCountExtensions { public static IEnumerable OldMustHaveMaximumCount(this IEnumerable parameter, int count, string parameterName = null, string message = null, Func exception = null) { // ReSharper disable PossibleMultipleEnumeration parameter.MustNotBeNull(parameterName); count.MustNotBeLessThan(0); var collectionCount = parameter.Count(); if (collectionCount <= count) return parameter; throw exception?.Invoke() ?? new CollectionException(message ?? new StringBuilder().AppendLine($"{parameterName ?? "The collection"} must have at most count {count}, but it actually has count {collectionCount}.") .AppendCollectionContent(parameter) .ToString(), parameterName); // ReSharper restore PossibleMultipleEnumeration } } } MustHaveMinimumCountBenchmark.cs000066400000000000000000000045441470750352700363370ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/CollectionAssertionsusing System; using System.Collections.Generic; using System.Text; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; using Light.GuardClauses.FrameworkExtensions; namespace Light.GuardClauses.Performance.CollectionAssertions { public class MustHaveMinimumCountBenchmark { public IReadOnlyList Collection = new List{"Foo", "Bar", "Baz"}; public int MinimumCount = 3; [Benchmark(Baseline = true)] public IReadOnlyList ImperativeVersion() { if (Collection == null) throw new ArgumentNullException(nameof(Collection)); if (Collection.Count < MinimumCount) throw new InvalidCollectionCountException(nameof(Collection)); return Collection; } [Benchmark] public IReadOnlyList LightGuardClauses() => Collection.MustHaveMinimumCount(MinimumCount, nameof(Collection)); [Benchmark] public IReadOnlyList LightGuardClausesCustomException() => Collection.MustHaveMinimumCount(MinimumCount, (i, c) => new Exception("More items for collection")); [Benchmark] public IEnumerable OldVersion() => Collection.OldMustHaveMinimumCount(MinimumCount, nameof(Collection)); } public static class MustHaveMinimumCountExtensions { public static IEnumerable OldMustHaveMinimumCount(this IEnumerable parameter, int count, string parameterName = null, string message = null, Func exception = null) { // ReSharper disable PossibleMultipleEnumeration parameter.MustNotBeNull(parameterName); count.MustNotBeLessThan(0); var collectionCount = parameter.Count(); if (collectionCount >= count) return parameter; throw exception?.Invoke() ?? new CollectionException(message ?? new StringBuilder().AppendLine($"{parameterName ?? "The collection"} must have at least count {count}, but it actually has count {count}.") .AppendCollectionContent(parameter) .ToString(), parameterName); // ReSharper restore PossibleMultipleEnumeration } } } MustNotBeNullOrEmptyBenchmark.cs000066400000000000000000000034001470750352700362570ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/CollectionAssertionsusing System; using System.Collections.Generic; using System.Linq; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses.Performance.CollectionAssertions { public class MustNotBeNullOrEmptyBenchmark { public List Collection = new List { "Foo", "Bar", "Baz", "Qux" }; [Benchmark(Baseline = true)] public List ImperativeVersion() { if (Collection == null) throw new ArgumentNullException(nameof(Collection)); if (Collection.Count == 0) throw new EmptyCollectionException(nameof(Collection)); return Collection; } [Benchmark] public List LightGuardClauses() => Collection.MustNotBeNullOrEmpty(nameof(Collection)); [Benchmark] public List LightGuardClausesCustomException() => Collection.MustNotBeNullOrEmpty(c => new Exception("The collection is empty, you fool")); [Benchmark] public IEnumerable OldVersion() => Collection.OldMustNotBeNullOrEmpty(nameof(Collection)); } public static class MustNotBeNullOrEmptyExtensions { public static IEnumerable OldMustNotBeNullOrEmpty(this IEnumerable parameter, string parameterName = null, string message = null, Func exception = null) { // ReSharper disable PossibleMultipleEnumeration parameter.MustNotBeNull(parameterName); if (parameter.Any()) return parameter; throw exception != null ? exception() : (message == null ? new EmptyCollectionException(parameterName) : new EmptyCollectionException(message, parameterName)); // ReSharper restore PossibleMultipleEnumeration } } }MustNotBeOneOfBenchmark.cs000066400000000000000000000044411470750352700350410ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/CollectionAssertionsusing System; using System.Collections.Generic; using System.Linq; using System.Text; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; using Light.GuardClauses.FrameworkExtensions; namespace Light.GuardClauses.Performance.CollectionAssertions { public class MustNotBeOneOfBenchmark { public int Value = 42; public IList Items = new[] { 1, 4, 6, 5 }; [Benchmark(Baseline = true)] public int ImperativeVersion() { if (Items.Contains(Value)) throw new ValueIsOneOfException(nameof(Value)); return Value; } [Benchmark] public int LightGuardClauses() => Value.MustNotBeOneOf(Items, nameof(Value)); [Benchmark] public int LightGuardClausesCustomException() => Value.MustNotBeOneOf(Items, (v, i) => new Exception($"{v} is present, you fool")); [Benchmark] public int OldVersion() => Value.OldMustNotBeOneOf(Items, parameterName: nameof(Value)); } public static class MustNotBeOneOfExtensions { public static T OldMustNotBeOneOf(this T parameter, IEnumerable items, IEqualityComparer equalityComparer = null, string parameterName = null, string message = null, Func exception = null) { // ReSharper disable PossibleMultipleEnumeration items.MustNotBeNull(nameof(items)); equalityComparer = equalityComparer ?? EqualityComparer.Default; if (items.Contains(parameter, equalityComparer) == false) return parameter; throw exception?.Invoke() ?? new ArgumentOutOfRangeException(parameterName, parameter, message ?? new StringBuilder().AppendLine($"{parameterName ?? "The value"} must not be one of the items") .AppendItemsWithNewLine(items) .AppendLine($"but you specified {parameter}.") .ToString()); // ReSharper restore PossibleMultipleEnumeration } } } MustNotContainBenchmark.cs000066400000000000000000000042141470750352700351550ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/CollectionAssertionsusing System; using System.Collections.Generic; using System.Linq; using System.Text; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; using Light.GuardClauses.FrameworkExtensions; namespace Light.GuardClauses.Performance.CollectionAssertions { public class MustNotContainBenchmark { public List Collection = new List { "Foo", "Bar", "Baz", "Qux" }; public string Item = "Corge"; [Benchmark(Baseline = true)] public List ImperativeVersion() { if (Collection == null) throw new ArgumentNullException(nameof(Collection)); if (Collection.Contains(Item)) throw new ExistingItemException(nameof(Collection)); return Collection; } [Benchmark] public List LightGuardClauses() => Collection.MustNotContain(Item, nameof(Collection)); [Benchmark] public List LightGuardClausesCustomException() => Collection.MustNotContain(Item, (c, i) => new Exception($"The collection contain {i}.")); [Benchmark] public IEnumerable OldVersion() => Collection.OldMustNotContain(Item, nameof(Collection)); } public static class MustNotContainExtensions { public static IEnumerable OldMustNotContain(this IEnumerable parameter, T item, string parameterName = null, string message = null, Func exception = null) { // ReSharper disable PossibleMultipleEnumeration parameter.MustNotBeNull(parameterName); if (parameter.Contains(item) == false) return parameter; throw exception?.Invoke() ?? new CollectionException(message ?? new StringBuilder($"{parameterName ?? "The collection"} must not contain value \"{item.ToStringOrNull()}\", but it does.") .AppendCollectionContent(parameter) .ToString(), parameterName); // ReSharper restore PossibleMultipleEnumeration } } }SpanMustHaveLengthBenchmark.cs000066400000000000000000000047651470750352700357630ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/CollectionAssertionsusing System; using System.Runtime.CompilerServices; using System.Text; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses.Performance.CollectionAssertions { public class SpanMustHaveLengthBenchmark { public byte[] Source = Encoding.UTF8.GetBytes("Some old wounds never truly heal, and bleed again at the slightest word."); [Benchmark(Baseline = true)] public Span ImperativeVersion() { var span = new Span(Source, 0, 32); if (span.Length != 32) throw new InvalidCollectionCountException(nameof(span)); return span; } [Benchmark] public Span LightGuardClausesCopyByValue() => new Span(Source, 0, 32).MustHaveLengthCopyByValue(32, "span"); [Benchmark] public Span LightGuardClausesInParameter() { var span = new Span(Source, 0, 32); span.MustHaveLengthInParameter(32, nameof(span)); return span; } [Benchmark] public Span LightGuardClausesInOut() { var span = new Span(Source, 0, 32); span.MustHaveLengthInOut(32, nameof(span)); return span; } } public static class SpanMustHaveLengthExtensions { [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Span MustHaveLengthCopyByValue(this Span parameter, int length, string parameterName = null, string message = null) { if (parameter.Length != length) Throw.InvalidSpanLength(parameter, length, parameterName, message); return parameter; } [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Span MustHaveLengthInParameter(in this Span parameter, int length, string parameterName = null, string message = null) { if (parameter.Length != length) Throw.InvalidSpanLength(parameter, length, parameterName, message); return parameter; } [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ref Span MustHaveLengthInOut(ref this Span parameter, int length, string parameterName = null, string message = null) { if (parameter.Length != length) Throw.InvalidSpanLength(parameter, length, parameterName, message); return ref parameter; } } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/CommonAssertions/000077500000000000000000000000001470750352700273015ustar00rootroot00000000000000InvalidArgumentBenchmark.cs000066400000000000000000000030031470750352700344510ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/CommonAssertionsusing System; using BenchmarkDotNet.Attributes; namespace Light.GuardClauses.Performance.CommonAssertions { public class InvalidArgumentBenchmark { public bool Condition = false; public const string Message = "You must not call this method when Condition is true"; public const string ParameterName = "parameter"; [Benchmark(Baseline = true)] public bool ImperativeVersion() { if (Condition) throw new ArgumentException(Message, ParameterName); return Condition; } [Benchmark] public bool LightGuardClauses() { Check.InvalidArgument(Condition, ParameterName, Message); return Condition; } [Benchmark] public bool LightGuardClausesCustomException() { Check.InvalidArgument(Condition, () => new ArgumentException(Message, ParameterName)); return Condition; } [Benchmark] public bool LightGuardClausesCustomExceptionManualInlining() { if (Condition) Exceptions.Throw.CustomException(() => new ArgumentException(Message, ParameterName)); return Condition; } [Benchmark] public bool LightGuardClausesCustomExceptionWithParameter() { Check.InvalidArgument(Condition, null, _ => new ArgumentException(Message, ParameterName)); return Condition; } } }InvalidOperationBenchmark.cs000066400000000000000000000012351470750352700346340ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/CommonAssertionsusing System; using BenchmarkDotNet.Attributes; namespace Light.GuardClauses.Performance.CommonAssertions { public class InvalidOperationBenchmark { public bool Condition = false; public const string Message = "You must not call this method when Condition is true"; [Benchmark(Baseline = true)] public bool ImperativeVersion() { if (Condition) throw new InvalidOperationException(Message); return Condition; } [Benchmark] public bool LightGuardClauses() { Check.InvalidOperation(Condition, Message); return Condition; } } }InvalidStateBenchmark.cs000066400000000000000000000012171470750352700337540ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/CommonAssertionsusing BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses.Performance.CommonAssertions { public class InvalidStateBenchmark { public const string Message = "Condition must not be true."; public bool Condition = false; [Benchmark(Baseline = true)] public bool ImperativeVersion() { if (Condition) throw new InvalidStateException(Message); return Condition; } [Benchmark] public bool LightGuardClauses() { Check.InvalidState(Condition, Message); return Condition; } } }IsApproximatelyBenchmark.cs000066400000000000000000000050021470750352700345130ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/CommonAssertionsusing System; using BenchmarkDotNet.Attributes; namespace Light.GuardClauses.Performance.CommonAssertions { public class IsApproximatelyDoubleBenchmark { public double DoubleX = 35.5; public double DoubleY = 35.8; public double DoubleZ = 35.5000000121; public double CustomTolerance = 0.01; [Benchmark(Baseline = true)] public bool ImperativeConstantToleranceFalse() => Math.Abs(DoubleX - DoubleY) < 0.0001; [Benchmark] public bool ImperativeConstantToleranceTrue() => Math.Abs(DoubleX - DoubleZ) < 0.0001; [Benchmark] public bool ImperativeCustomToleranceFalse() => Math.Abs(DoubleX - DoubleY) < CustomTolerance; [Benchmark] public bool ImperativeCustomToleranceTrue() => Math.Abs(DoubleX - DoubleZ) < CustomTolerance; [Benchmark] public bool LightGuardClausesConstantToleranceFalse() => DoubleX.IsApproximately(DoubleY); [Benchmark] public bool LightGuardClausesConstantToleranceTrue() => DoubleX.IsApproximately(DoubleZ); [Benchmark] public bool LightGuardClausesCustomToleranceFalse() => DoubleX.IsApproximately(DoubleY, CustomTolerance); [Benchmark] public bool LightGuardClausesCustomToleranceTrue() => DoubleX.IsApproximately(DoubleZ, CustomTolerance); } public class IsApproximatelyFloatBenchmark { public float FloatX = 17.99f; public float FloatY = 18.01f; public float FloatZ = 17.9999f; public float CustomTolerance = 0.0001f; [Benchmark(Baseline = true)] public bool ImperativeConstantToleranceFalse() => Math.Abs(FloatX - FloatY) < 0.0001f; [Benchmark] public bool ImperativeConstantToleranceTrue() => Math.Abs(FloatX - FloatZ) < 0.0001f; [Benchmark] public bool ImperativeCustomToleranceFalse() => Math.Abs(FloatX - FloatY) < CustomTolerance; [Benchmark] public bool ImperativeCustomToleranceTrue() => Math.Abs(FloatX - FloatZ) < CustomTolerance; [Benchmark] public bool LightGuardClausesConstantToleranceFalse() => FloatX.IsApproximately(FloatY); [Benchmark] public bool LightGuardClausesConstantToleranceTrue() => FloatX.IsApproximately(FloatZ); [Benchmark] public bool LightGuardClausesCustomToleranceFalse() => FloatX.IsApproximately(FloatY, CustomTolerance); [Benchmark] public bool LightGuardClausesCustomToleranceTrue() => FloatX.IsApproximately(FloatZ, CustomTolerance); } }IsEmptyGuidBenchmark.cs000066400000000000000000000005741470750352700335750ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/CommonAssertionsusing System; using BenchmarkDotNet.Attributes; namespace Light.GuardClauses.Performance.CommonAssertions { public class IsEmptyGuidBenchmark { public Guid Guid = Guid.NewGuid(); [Benchmark(Baseline = true)] public bool Imperative() => Guid == Guid.Empty; [Benchmark] public bool LightGuardClauses() => Guid.IsEmpty(); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/CommonAssertions/IsSameAsBenchmark.cs000066400000000000000000000011151470750352700331060ustar00rootroot00000000000000using BenchmarkDotNet.Attributes; namespace Light.GuardClauses.Performance.CommonAssertions { public class IsSameAsBenchmark { public object First = new object(); public object Second = new object(); [Benchmark(Baseline = true)] public bool EqualityOperator() => First == Second; [Benchmark] public bool ReferenceEquals() => ReferenceEquals(First, Second); [Benchmark] public bool Equals() => First.Equals(Second); [Benchmark] public bool LightGuardClauses() => First.IsSameAs(Second); } }IsValidEnumValueBenchmark.cs000066400000000000000000000013061470750352700345410ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/CommonAssertionsusing System; using BenchmarkDotNet.Attributes; namespace Light.GuardClauses.Performance.CommonAssertions { public class IsValidEnumValueBenchmark { public AttributeTargets AttributeTargets = AttributeTargets.Class | AttributeTargets.Struct | AttributeTargets.Interface; public StringComparison ComparisonType = StringComparison.Ordinal; [Benchmark(Baseline = true)] public bool Imperative() => Enum.IsDefined(typeof(StringComparison), ComparisonType); [Benchmark] public bool LightGuardClauses() => ComparisonType.IsValidEnumValue(); [Benchmark] public bool LightGuardClausesFlags() => AttributeTargets.IsValidEnumValue(); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/CommonAssertions/MustBeBenchmark.cs000066400000000000000000000071001470750352700326400ustar00rootroot00000000000000using System; using System.Collections.Generic; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses.Performance.CommonAssertions { public class MustBeInt32Benchmark { public int NumberA = 284930; public int NumberB; public EqualityComparer EqualityComparer = EqualityComparer.Default; public MustBeInt32Benchmark() => NumberB = NumberA; [Benchmark(Baseline = true)] public int Imperative() { if (NumberA != NumberB) throw new ValuesNotEqualException(nameof(NumberA), "The two numbers are not equal"); return NumberA; } [Benchmark] public int LightGuardClauses() => NumberA.MustBe(NumberB, nameof(NumberA)); [Benchmark] public int LightGuardClausesCustomEqualityComparer() => NumberA.MustBe(NumberB, EqualityComparer, nameof(NumberA)); [Benchmark] public int LightGuardClausesCustomException() => NumberA.MustBe(NumberB, (x, y) => new Exception($"{x} and {y} are not equal")); [Benchmark] public int LightGuardClausesCustomExceptionCustomEqualityComparer() => NumberA.MustBe(NumberB, EqualityComparer, (x, y, comparer) => new Exception($"{x} and {y} are not equal")); } public class MustBeGuidBenchmark { public Guid GuidA = Guid.NewGuid(); public Guid GuidB; public EqualityComparer EqualityComparer = EqualityComparer.Default; public MustBeGuidBenchmark() => GuidB = GuidA; [Benchmark(Baseline = true)] public Guid Imperative() { if (GuidA != GuidB) throw new ValuesNotEqualException(nameof(GuidA), "The two GUIDs are not equal"); return GuidA; } [Benchmark] public Guid LightGuardClauses() => GuidA.MustBe(GuidB, nameof(GuidA)); [Benchmark] public Guid LightGuardClausesCustomEqualityComparer() => GuidA.MustBe(GuidB, EqualityComparer, nameof(GuidA)); [Benchmark] public Guid LightGuardClausesCustomException() => GuidA.MustBe(GuidB, (x, y) => new Exception($"{x} and {y} are not equal")); [Benchmark] public Guid LightGuardClausesCustomExceptionCustomEqualityComparer() => GuidA.MustBe(GuidB, EqualityComparer, (x, y, comparer) => new Exception($"{x} and {y} are not equal")); } public class MustBeStringBenchmark { public string StringA = "This is a relatively long string"; public string StringB; public EqualityComparer EqualityComparer = EqualityComparer.Default; public MustBeStringBenchmark() => StringB = new string(StringA.ToCharArray()); [Benchmark(Baseline = true)] public string Imperative() { if (StringA != StringB) throw new ValuesNotEqualException(nameof(StringA), "The two strings are not equal"); return StringA; } [Benchmark] public string LightGuardClauses() => StringA.MustBe(StringB, nameof(StringA)); [Benchmark] public string LightGuardClausesCustomEqualityComparer() => StringA.MustBe(StringB, EqualityComparer, nameof(StringA)); [Benchmark] public string LightGuardClausesCustomException() => StringA.MustBe(StringB, (x, y) => new Exception($"{x} and {y} are not equal")); [Benchmark] public string LightGuardClausesCustomExceptionCustomEqualityComparer() => StringA.MustBe(StringB, EqualityComparer, (x, y, comparer) => new Exception($"{x} and {y} are not equal")); } }MustBeOfTypeBenchmark.cs000066400000000000000000000031111470750352700337060ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/CommonAssertionsusing System; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses.Performance.CommonAssertions { public class MustBeOfTypeBenchmark { public object Instance = new SampleEntity(Guid.NewGuid()); [Benchmark(Baseline = true)] public SampleEntity BaseVersion() { if (Instance == null) throw new ArgumentNullException(nameof(Instance)); if (!(Instance is SampleEntity entity)) throw new TypeCastException(nameof(Instance)); return entity; } [Benchmark] public SampleEntity LightGuardClausesWithParameterName() => Instance.MustBeOfType(nameof(Instance)); [Benchmark] public SampleEntity LightGuardClausesWithCustomException() => Instance.MustBeOfType(r => new Exception($"\"{r}\" is not the correct type.")); [Benchmark] public SampleEntity OldVersion() => Instance.OldMustBeOfType(nameof(Instance)); } public static class MustBeOfTypeExtensionMethods { public static T OldMustBeOfType(this object parameter, string parameterName = null, string message = null, Func exception = null) { { if (parameter is T castedValue) return castedValue; throw exception?.Invoke() ?? new TypeCastException(parameterName, message ?? $"{parameterName ?? "The object"} is of type {parameter.GetType().FullName} and cannot be downcasted to {typeof(T).FullName}."); } } } }MustBeValidEnumValueBenchmark.cs000066400000000000000000000040361470750352700353700ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/CommonAssertionsusing System; using System.Reflection; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses.Performance.CommonAssertions { public class MustBeValidEnumValueBenchmark { public ConsoleColor EnumValue = ConsoleColor.Blue; public BindingFlags FlagsEnumValue = BindingFlags.Static | BindingFlags.Public | BindingFlags.DeclaredOnly; [Benchmark(Baseline = true)] public ConsoleColor NoFlagsBaseVersion() { if (Enum.IsDefined(typeof(ConsoleColor), EnumValue) == false) throw new EnumValueNotDefinedException(nameof(EnumValue)); return EnumValue; } [Benchmark] public ConsoleColor LightGuardClausesNoFlagsWithParameterName() => EnumValue.MustBeValidEnumValue(nameof(EnumValue)); [Benchmark] public ConsoleColor LightGuardClausesNoFlagsWithCustomException() => EnumValue.MustBeValidEnumValue(v => new Exception($"Value {v} is not defined in enum.")); [Benchmark] public ConsoleColor OldVersionNoFlags() => EnumValue.OldMustBeValidEnumValue(nameof(EnumValue)); [Benchmark] public BindingFlags LightGuardClausesFlagsWithParameterName() => FlagsEnumValue.MustBeValidEnumValue(nameof(FlagsEnumValue)); [Benchmark] public BindingFlags LightGuardClausesFlagsWithCustomException() => FlagsEnumValue.MustBeValidEnumValue(v => new Exception($"Value {v} is not defined in enum.")); } public static class MustBeValidEnumValueExtensionMethods { public static T OldMustBeValidEnumValue(this T parameter, string parameterName = null, string message = null, Func exception = null) where T : struct, Enum { if (parameter.IsValidEnumValue()) return parameter; throw exception?.Invoke() ?? new EnumValueNotDefinedException(parameterName, message ?? $"{parameterName ?? "The value"} \"{parameter}\" must be one of the defined constants of enum \"{parameter.GetType()}\", but it is not."); } } }MustHaveValueBenchmark.cs000066400000000000000000000052251470750352700341210ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/CommonAssertionsusing System; using System.Runtime.CompilerServices; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses.Performance.CommonAssertions { public class MustHaveValueIntBenchmark { public int? Nullable = 42; [Benchmark(Baseline = true)] public int BaseVersion() { if (Nullable.HasValue == false) throw new NullableHasNoValueException(nameof(Nullable)); return Nullable.Value; } [Benchmark] public int OldVersionWithParameterName() => Nullable.OldMustHaveValue(nameof(Nullable)); [Benchmark] public int LightGuardClausesWithParameterName() => Nullable.MustHaveValue(nameof(Nullable)); [Benchmark] public int NewVersionReturnFast() => Nullable.NewMustHaveValueReturnFast(nameof(Nullable)); [Benchmark] public int LightGuardClausesWithCustomException() => Nullable.MustHaveValue(() => new Exception()); } public class MustHaveValueDoubleBenchmark { public double? Nullable = 42.74; [Benchmark(Baseline = true)] public double BaseVersion() { if (Nullable.HasValue == false) throw new NullableHasNoValueException(nameof(Nullable)); return Nullable.Value; } [Benchmark] public double OldVersionWithParameterName() => Nullable.OldMustHaveValue(nameof(Nullable)); [Benchmark] public double LightGuardClausesWithParameterName() => Nullable.MustHaveValue(nameof(Nullable)); [Benchmark] public double NewVersionReturnFast() => Nullable.NewMustHaveValueReturnFast(nameof(Nullable)); [Benchmark] public double LightGuardClausesWithCustomException() => Nullable.MustHaveValue(() => new Exception()); } public static class MustHaveValueExtensionMethods { public static T OldMustHaveValue(this T? parameter, string parameterName = null, string message = null, Func exception = null) where T : struct { if (parameter.HasValue) return parameter.Value; throw exception?.Invoke() ?? (message != null ? new NullableHasNoValueException(message, parameterName) : new NullableHasNoValueException(parameterName)); } [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T NewMustHaveValueReturnFast(this T? parameter, string parameterName = null, string message = null) where T : struct { if (parameter.HasValue) return parameter.Value; Throw.NullableHasNoValue(parameterName, message); return default; } } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/CommonAssertions/MustNotBeBenchmark.cs000066400000000000000000000072201470750352700333240ustar00rootroot00000000000000using System; using System.Collections.Generic; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses.Performance.CommonAssertions { public class MustNotBeDoubleBenchmark { public EqualityComparer EqualityComparer = EqualityComparer.Default; public double NumberA = 42.85; public double NumberB = -1592.642; [Benchmark(Baseline = true)] public double Imperative() { // ReSharper disable once CompareOfFloatsByEqualityOperator if (NumberA == NumberB) throw new ValuesEqualException(nameof(NumberA), "The two numbers are equal."); return NumberA; } [Benchmark] public double LightGuardClauses() => NumberA.MustNotBe(NumberB, nameof(NumberA)); [Benchmark] public double LightGuardClausesCustomEqualityComparer() => NumberA.MustNotBe(NumberB, EqualityComparer, nameof(NumberA)); [Benchmark] public double LightGuardClausesCustomException() => NumberA.MustNotBe(NumberB, (x, y) => new Exception($"{x} and {y} are equal.")); [Benchmark] public double LightGuardClausesCustomExceptionCustomEqualityComparer() => NumberA.MustNotBe(NumberB, EqualityComparer, (x, y, _) => new Exception($"{x} and {y} are equal.")); } public class MustNotBeGuidBenchmark { public EqualityComparer EqualityComparer = EqualityComparer.Default; public Guid GuidA = Guid.NewGuid(); public Guid GuidB = Guid.NewGuid(); [Benchmark(Baseline = true)] public Guid Imperative() { // ReSharper disable once CompareOfFloatsByEqualityOperator if (GuidA == GuidB) throw new ValuesEqualException(nameof(GuidA), "The two GUIDs are equal."); return GuidA; } [Benchmark] public Guid LightGuardClauses() => GuidA.MustNotBe(GuidB, nameof(GuidA)); [Benchmark] public Guid LightGuardClausesCustomEqualityComparer() => GuidA.MustNotBe(GuidB, EqualityComparer, nameof(GuidA)); [Benchmark] public Guid LightGuardClausesCustomException() => GuidA.MustNotBe(GuidB, (x, y) => new Exception($"{x} and {y} are equal.")); [Benchmark] public Guid LightGuardClausesCustomExceptionCustomEqualityComparer() => GuidA.MustNotBe(GuidB, EqualityComparer, (x, y, _) => new Exception($"{x} and {y} are equal.")); } public class MustNotBeStringBenchmark { public EqualityComparer EqualityComparer = EqualityComparer.Default; public string StringA = "The things I do for love."; public string StringB = "The things I do for you."; [Benchmark(Baseline = true)] public string Imperative() { // ReSharper disable once CompareOfFloatsByEqualityOperator if (StringA == StringB) throw new ValuesEqualException(nameof(StringA), "The two strings are equal."); return StringA; } [Benchmark] public string LightGuardClauses() => StringA.MustNotBe(StringB, nameof(StringA)); [Benchmark] public string LightGuardClausesCustomEqualityComparer() => StringA.MustNotBe(StringB, EqualityComparer, nameof(StringA)); [Benchmark] public string LightGuardClausesCustomException() => StringA.MustNotBe(StringB, (x, y) => new Exception($"{x} and {y} are equal.")); [Benchmark] public string LightGuardClausesCustomExceptionCustomEqualityComparer() => StringA.MustNotBe(StringB, EqualityComparer, (x, y, _) => new Exception($"{x} and {y} are equal.")); } }MustNotBeDefaultBenchmark.cs000066400000000000000000000104061470750352700345520ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/CommonAssertionsusing System; using System.Runtime.CompilerServices; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses.Performance.CommonAssertions { public class MustNotBeDefaultBenchmark { public SampleEntity Reference = new SampleEntity(Guid.NewGuid()); public readonly int Value = 42; [Benchmark(Baseline = true)] public int ImperativeVersionForValueType() { if (Value == default) throw new ArgumentDefaultException(nameof(Value)); return Value; } [Benchmark] public int MustNotBeDefaultValueV1() => Value.MustNotBeDefaultV1(nameof(Value)); [Benchmark] public int MustNotBeDefaultValueV2() => Value.MustNotBeDefaultV2(nameof(Value)); [Benchmark] public int OldVersionForValueType() => Value.OldMustNotBeDefault(nameof(Value)); [Benchmark] public int LightGuardClausesValueType() => Value.MustNotBeDefault(nameof(Value)); [Benchmark] public int LightGuardClausesValueTypeCustomException() => Value.MustNotBeDefault(() => new Exception()); [Benchmark] public SampleEntity ImperativeVersionForReferenceType() { if (Reference == null) throw new ArgumentNullException(nameof(Reference)); return Reference; } [Benchmark] public SampleEntity MustNotBeDefaultReferenceV1() => Reference.MustNotBeDefaultV1(nameof(Reference)); [Benchmark] public SampleEntity MustNotBeDefaultReferenceV2() => Reference.MustNotBeDefaultV2(nameof(Reference)); [Benchmark] public SampleEntity OldVersionForReferenceType() => Reference.OldMustNotBeDefault(nameof(Reference)); [Benchmark] public SampleEntity LightGuardClausesReferenceType() => Reference.MustNotBeDefault(nameof(Reference)); [Benchmark] public SampleEntity LightGuardClausesReferenceTypeCustomException() => Reference.MustNotBeDefault(() => new Exception()); } public static class MustNotBeDefaultExtensionMethods { [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T MustNotBeDefaultV1(this T parameter, string parameterName = null, string message = null) { if (default(T) == null) { if (parameter != null) return parameter; ThrowMustNotBeNullException(parameterName, message); return default; } if (parameter.Equals(default(T)) == false) return parameter; ThrowParameterDefaultException(parameterName, message); return default; } [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T MustNotBeDefaultV2(this T parameter, string parameterName = null, string message = null) { if (parameter == null) ThrowMustNotBeNullException(parameterName, message); // ReSharper disable once PossibleNullReferenceException if (parameter.Equals(default(T))) ThrowParameterDefaultException(parameterName, message); return parameter; } private static void ThrowParameterDefaultException(string parameterName, string message) { throw new ArgumentException(message ?? $"{parameterName ?? "The value"} must not be the default value.", parameterName); } private static void ThrowMustNotBeNullException(string parameterName, string message) { throw new ArgumentNullException(parameterName, message ?? $"{parameterName ?? "The value"} must not be null."); } public static T OldMustNotBeDefault(this T parameter, string parameterName = null, string message = null, Func exception = null) { if (parameter == null) throw exception?.Invoke() ?? new ArgumentNullException(parameterName, message ?? $"{parameterName ?? "The value"} must not be null."); if (parameter.Equals(default(T))) throw exception?.Invoke() ?? new ArgumentDefaultException(parameterName, message ?? $"{parameterName ?? "The value"} must not be the default value."); return parameter; } } }MustNotBeEmptyGuidBenchmark.cs000066400000000000000000000024041470750352700350740ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/CommonAssertionsusing System; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses.Performance.CommonAssertions { public class MustNotBeEmptyGuidBenchmark { public Guid Guid = Guid.NewGuid(); [Benchmark(Baseline = true)] public Guid Imperative() { if (Guid == Guid.Empty) throw new EmptyGuidException(nameof(Guid)); return Guid; } [Benchmark] public Guid LightGuardClausesWithParameterName() => Guid.MustNotBeEmpty(nameof(Guid)); [Benchmark] public Guid LightGuardClausesWithCustomException() => Guid.MustNotBeEmpty(() => new Exception()); [Benchmark] public Guid OldVersion() => Guid.OldMustNotBeEmpty(nameof(Guid)); } public static class GuidMustNotBeEmptyExtensionMethods { public static Guid OldMustNotBeEmpty(this Guid parameter, string parameterName = null, string message = null, Func exception = null) { if (parameter != Guid.Empty) return parameter; throw exception?.Invoke() ?? new EmptyGuidException(parameterName, message ?? $"{parameterName ?? "The value"} must be a valid GUID, but it actually is an empty one."); } } }MustNotBeNullBenchmark.cs000066400000000000000000000262601470750352700341050ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/CommonAssertionsusing System; using System.Runtime.CompilerServices; using BenchmarkDotNet.Attributes; namespace Light.GuardClauses.Performance.CommonAssertions { public class MustNotBeNullBenchmark { public SampleEntity Instance = new SampleEntity(Guid.NewGuid()); [Benchmark(Baseline = true)] public SampleEntity Imperative() { if (Instance == null) throw new ArgumentNullException(nameof(Instance)); return Instance; } [Benchmark] public SampleEntity ImperativeWithNullcoalescing() => Instance ?? throw new ArgumentNullException(nameof(Instance)); [Benchmark] public SampleEntity CustomParameterV1() => Instance.MustNotBeNullV1(nameof(Instance)); [Benchmark] public SampleEntity CustomParameterV2() => Instance.MustNotBeNullV2(nameof(Instance)); [Benchmark] public SampleEntity CustomParameterV3() => Instance.MustNotBeNullV3(nameof(Instance)); [Benchmark] public SampleEntity CustomParameterV4() => Instance.MustNotBeNullV4(nameof(Instance)); [Benchmark] public SampleEntity CustomParameterV5() => Instance.MustNotBeNullV5(nameof(Instance)); [Benchmark] public SampleEntity CustomParameterV6() { Instance.MustNotBeNullV6(nameof(Instance)); return Instance; } [Benchmark] public SampleEntity CustomParameterV7() => Instance.MustNotBeNullV7(nameof(Instance)); [Benchmark] public SampleEntity CustomParameterV8() => Instance.MustNotBeNullV8(nameof(Instance)); [Benchmark] public SampleEntity CustomParameterV10() => Instance.MustNotBeNullV10(nameof(Instance)); [Benchmark] public SampleEntity LightGuardClausesCustomParameter() => Instance.MustNotBeNull(nameof(Instance)); [Benchmark] public SampleEntity ImperativeCustomException() { if (Instance == null) throw new ArgumentException("Instance must not be null.", nameof(Instance)); return Instance; } [Benchmark] public SampleEntity CustomExceptionV1() => Instance.MustNotBeNullV1(exception: () => new ArgumentException("Instance must not be null.", nameof(Instance))); [Benchmark] public SampleEntity CustomExceptionV2() => Instance.MustNotBeNullV2(exception: () => new ArgumentException("Instance must not be null.", nameof(Instance))); [Benchmark] public SampleEntity CustomExceptionV5() => Instance.MustNotBeNullV5(exception: () => new ArgumentException("Instance must not be null.", nameof(Instance))); [Benchmark] public SampleEntity CustomExceptionV6() { Instance.MustNotBeNullV6(exception: () => new ArgumentException("Instance must not be null.", nameof(Instance))); return Instance; } [Benchmark] public SampleEntity CustomExceptionV7() => Instance.MustNotBeNullV7(exception: () => new ArgumentException("Instance must not be null.", nameof(Instance))); [Benchmark] public SampleEntity CustomExceptionV9() => Instance.MustNotBeNullV9(() => new ArgumentException("Instance must not be null.", nameof(Instance))); [Benchmark] public SampleEntity CustomExceptionV11() => Instance.MustNotBeNullV11(() => new ArgumentException("Instance must not be null.", nameof(Instance))); [Benchmark] public SampleEntity CustomExceptionV12() => Instance.MustNotBeNullV12(() => new ArgumentException("Instance must not be null.", nameof(Instance))); [Benchmark] public SampleEntity LightGuardClausesCustomException() => Instance.MustNotBeNull(() => new ArgumentException("Instance must not be null.", nameof(Instance))); } public static class MustNotBeNullExtensionMethods { /* * All parameters * No aggressive inlining * Throws exception in same method * Returns fast */ public static T MustNotBeNullV1(this T parameter, string parameterName = null, string message = null, Func exception = null) where T : class { if (parameter != null) return parameter; throw exception?.Invoke() ?? throw new ArgumentNullException(parameterName, message ?? $"{parameterName ?? "The value"} must not be null."); } /* * All parameters * Aggressive inlining * Throws exception in same method * Returns fast */ [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T MustNotBeNullV2(this T parameter, string parameterName = null, string message = null, Func exception = null) where T : class { if (parameter != null) return parameter; throw exception?.Invoke() ?? throw new ArgumentNullException(parameterName, message ?? $"{parameterName ?? "The value"} must not be null."); } /* * Only parameterName and message parameters * Aggressive inlining * Throws exception in different method * Returns fast */ [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T MustNotBeNullV3(this T parameter, string parameterName = null, string message = null) where T : class { if (parameter != null) return parameter; ThrowMustNotBeNullException(parameterName, message); return null; } /* * Only parameterName parameter * Aggressive inlining * Throws exception in different method * Returns fast */ [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T MustNotBeNullV4(this T parameter, string parameterName = null) where T : class { if (parameter != null) return parameter; ThrowMustNotBeNullException(parameterName); return null; } /* * All parameters * Aggressive inlining * Throws exception in same method * Returns fast * No generic restriction */ [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T MustNotBeNullV5(this T parameter, string parameterName = null, string message = null, Func exception = null) { if (parameter != null) return parameter; throw exception?.Invoke() ?? throw new ArgumentNullException(parameterName, message ?? $"{parameterName ?? "The value"} must not be null."); } /* * All parameters * Aggressive inlining * Throws exception in same method * Returns fast * No generics * No return parameter */ [MethodImpl(MethodImplOptions.AggressiveInlining)] public static void MustNotBeNullV6(this object parameter, string parameterName = null, string message = null, Func exception = null) { if (parameter != null) return; throw exception?.Invoke() ?? throw new ArgumentNullException(parameterName, message ?? $"{parameterName ?? "The value"} must not be null."); } /* * All parameters * Aggressive inlining * Throws exception in same method * if block throws exception */ [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T MustNotBeNullV7(this T parameter, string parameterName = null, string message = null, Func exception = null) where T : class { if (parameter == null) throw exception?.Invoke() ?? throw new ArgumentNullException(parameterName, message ?? $"{parameterName ?? "The value"} must not be null."); return parameter; } /* * Only parameterName and message parameters * Aggressive inlining * Throws exception in same method * Returns fast */ [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T MustNotBeNullV8(this T parameter, string parameterName = null, string message = null) where T : class { if (parameter != null) return parameter; throw new ArgumentNullException(parameterName, message ?? $"{parameterName ?? "The value"} must not be null."); } /* * Only exception parameter * Aggressive inlining * Throws exception in same method * Returns fast */ [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T MustNotBeNullV9(this T parameter, Func exception) where T : class { if (parameter != null) return parameter; throw exception(); } /* * Only exception parameter * Aggressive inlining * Throws exception in local function * Returns fast */ [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T MustNotBeNullV10(this T parameter, string parameterName = null, string message = null) where T : class { if (parameter != null) return parameter; ThrowMustNotBeNullException(parameterName, message); return null; void ThrowMustNotBeNullException(string p, string m) { throw new ArgumentNullException(p, m ?? $"{p ?? "The value"} must not be null."); } } /* * Only exception parameter * Aggressive inlining * Throws exception in different method * Returns fast */ [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T MustNotBeNullV11(this T parameter, Func exception) where T : class { if (parameter != null) return parameter; ThrowCustomException(exception); return null; } /* * Only exception parameter * Aggressive inlining * Throws exception in different method, creating the exception in the same method * Returns fast */ [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T MustNotBeNullV12(this T parameter, Func exception) where T : class { if (parameter != null) return parameter; ThrowCustomException(exception()); return null; } private static void ThrowMustNotBeNullException(string parameterName) { throw new ArgumentNullException(parameterName); } private static void ThrowMustNotBeNullException(string parameterName, string message) { throw new ArgumentNullException(parameterName, message ?? $"{parameterName ?? "The value"} must not be null."); } private static void ThrowCustomException(Func exception) { throw exception(); } private static void ThrowCustomException(Exception exception) { throw exception; } } }MustNotBeNullReferenceBenchmark.cs000066400000000000000000000050421470750352700357170ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/CommonAssertionsusing System; using System.Runtime.CompilerServices; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses.Performance.CommonAssertions { public class MustNotBeNullReferenceBenchmark { public SampleEntity Instance = new SampleEntity(Guid.NewGuid()); public int Value = 42; [Benchmark(Baseline = true)] public int ImperativeValueType() => Value; [Benchmark] public SampleEntity ImperativeReference() { if (Instance == null) throw new ArgumentNullException(nameof(Instance)); return Instance; } [Benchmark] public SampleEntity ReferenceV1() => Instance.MustNotBeNullReferenceV1(nameof(Instance)); [Benchmark] public SampleEntity ReferenceV2() => Instance.MustNotBeNullReferenceV2(nameof(Instance)); [Benchmark] public SampleEntity LightGuardClausesReference() => Instance.MustNotBeNullReference(nameof(Instance)); [Benchmark] public SampleEntity LightGuardClausesReferenceCustomException() => Instance.MustNotBeNullReference(() => new Exception()); [Benchmark] public int ValueTypeV1() => Value.MustNotBeNullReferenceV1(nameof(Value)); [Benchmark] public int ValueTypeV2() => Value.MustNotBeNullReferenceV2(nameof(Value)); [Benchmark] public int LightGuardClausesValueType() => Value.MustNotBeNullReference(nameof(Value)); [Benchmark] public int LightGuardClausesValueTypeCustomException() => Value.MustNotBeNullReference(() => new Exception()); } public static class MustNotBeNullReferenceExtensionMethods { [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T MustNotBeNullReferenceV1(this T parameter, string parameterName = null, string message = null) { if (default(T) == null) { if (parameter != null) return parameter; Throw.ArgumentNull(parameterName, message); return default(T); } return parameter; } [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T MustNotBeNullReferenceV2(this T parameter, string parameterName = null, string message = null) { if (default(T) != null) return parameter; if (parameter != null) return parameter; Throw.ArgumentNull(parameterName, message); return default(T); } } }MustNotBeSameAsBenchmark.cs000066400000000000000000000027631470750352700343460ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/CommonAssertionsusing System; using System.Collections.Generic; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses.Performance.CommonAssertions { public class MustNotBeSameAsBenchmark { public object Reference1 = new object(); public object Reference2 = new List(); [Benchmark(Baseline = true)] public object ImperativeVersion() { if (ReferenceEquals(Reference1, Reference2)) throw new SameObjectReferenceException(nameof(Reference1)); return Reference1; } [Benchmark] public object LightGuardClauses() => Reference1.MustNotBeSameAs(Reference2); [Benchmark] public object LightGuardClausesCustomException() => Reference1.MustNotBeSameAs(Reference2, r => new Exception()); [Benchmark] public object OldVersion() => Reference1.OldMustNotBeSameAs(Reference2, nameof(Reference1)); } public static class MustNotBeSameAsExtensions { public static T OldMustNotBeSameAs(this T parameter, T other, string parameterName = null, string message = null, Func exception = null) where T : class { if (ReferenceEquals(parameter, other) == false) return parameter; throw exception?.Invoke() ?? new ArgumentException(message ?? $"{parameterName ?? "The reference"} must not point to the object instance \"{other}\", but it does.", parameterName); } } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/ComparableAssertions/000077500000000000000000000000001470750352700301165ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/ComparableAssertions/IsInBenchmark.cs000066400000000000000000000014171470750352700331250ustar00rootroot00000000000000using BenchmarkDotNet.Attributes; namespace Light.GuardClauses.Performance.ComparableAssertions { public class IsInBenchmark { private const long LowerBoundary = 8_000_000_000_000_000_000L; public Range ExistingRange = Range.FromInclusive(LowerBoundary).ToExclusive(long.MaxValue); public long Value = long.MaxValue - 100L; [Benchmark(Baseline = true)] public bool Imperative() => Value >= ExistingRange.From && Value < ExistingRange.To; [Benchmark] public bool LightGuardClausesNewRangeInstance() => Value.IsIn(Range.FromInclusive(LowerBoundary).ToExclusive(long.MaxValue)); [Benchmark] public bool LightGuardClausesExistingRangeInstance() => Value.IsIn(ExistingRange); } }IsNotInBenchmark.cs000066400000000000000000000014211470750352700335220ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/ComparableAssertionsusing BenchmarkDotNet.Attributes; namespace Light.GuardClauses.Performance.ComparableAssertions { public class IsNotInBenchmark { public const char LowerBoundary = 'A'; public const char UpperBoundary = 'G'; public Range ExistingRange = Range.FromInclusive(LowerBoundary).ToInclusive(UpperBoundary); public char Value = 'I'; [Benchmark(Baseline = true)] public bool Imperative() => Value < ExistingRange.From || Value > ExistingRange.To; [Benchmark] public bool LightGuardClausesNewRangeInstance() => Value.IsNotIn(Range.FromInclusive(LowerBoundary).ToInclusive(UpperBoundary)); [Benchmark] public bool LightGuardClausesExistingRangeInstance() => Value.IsNotIn(ExistingRange); } }MustBeGreaterThanBenchmark.cs000066400000000000000000000031671470750352700355340ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/ComparableAssertionsusing System; using BenchmarkDotNet.Attributes; namespace Light.GuardClauses.Performance.ComparableAssertions { public class MustBeGreaterThanBenchmark { public int First = 5000; public int Second = -1939; [Benchmark(Baseline = true)] public int ImperativeVersion() { if (First <= Second) throw new ArgumentOutOfRangeException(nameof(First)); return First; } [Benchmark] public int ImperativeVersionWithCompareTo() { if (First.CompareTo(Second) <= 0) throw new ArgumentOutOfRangeException(nameof(First)); return First; } [Benchmark] public int LightGuardClausesWithParameterName() => First.MustBeGreaterThan(Second, nameof(First)); [Benchmark] public int LightGuardClausesCustomException() => First.MustBeGreaterThan(Second, (p, b) => new Exception($"{p} is not less than {b}.")); [Benchmark] public int OldVersion() => First.OldMustBeGreaterThan(Second, nameof(First)); } public static class MustBeGreaterThanExtensionMethods { public static T OldMustBeGreaterThan(this T parameter, T boundary, string parameterName = null, string message = null, Func exception = null) where T : IComparable { if (parameter.CompareTo(boundary) > 0) return parameter; throw exception != null ? exception() : new ArgumentOutOfRangeException(parameterName, parameter, message ?? $"{parameterName ?? "The value"} must be less than {boundary}, but you specified {parameter}."); } } }MustBeGreaterThanOrEqualToBenchmark.cs000066400000000000000000000033071470750352700373240ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/ComparableAssertionsusing System; using BenchmarkDotNet.Attributes; namespace Light.GuardClauses.Performance.ComparableAssertions { public class MustBeGreaterThanOrEqualToBenchmark { public int First = 42; public int Second = 3; [Benchmark(Baseline = true)] public int ImperativeVersion() { if (First < Second) throw new ArgumentOutOfRangeException(nameof(First)); return First; } [Benchmark] public int ImperativeVersionWithCompareTo() { if (First.CompareTo(Second) < 0) throw new ArgumentOutOfRangeException(nameof(First)); return First; } [Benchmark] public int LightGuardClausesWithParameterName() => First.MustBeGreaterThanOrEqualTo(Second, nameof(First)); [Benchmark] public double LightGuardClausesWithExceptionTwoParameters() => First.MustBeGreaterThanOrEqualTo(Second, (p, b) => new Exception($"{p} is not greater than or equal to {b}.")); [Benchmark] public int OldVersion() => First.OldMustBeGreaterThanOrEqualTo(Second, nameof(First)); } public static class MustBeGreaterThanOrEqualToExtensionMethods { public static T OldMustBeGreaterThanOrEqualTo(this T parameter, T boundary, string parameterName = null, string message = null, Func exception = null) where T : IComparable { if (parameter.CompareTo(boundary) >= 0) return parameter; throw exception != null ? exception() : new ArgumentOutOfRangeException(parameterName, parameter, message ?? $"{parameterName ?? "The value"} must not be less than {boundary}, but you specified {parameter}."); } } }MustBeInBenchmark.cs000066400000000000000000000034251470750352700336730ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/ComparableAssertionsusing System; using BenchmarkDotNet.Attributes; namespace Light.GuardClauses.Performance.ComparableAssertions { public class MustBeInBenchmark { public Range Range = Range.FromInclusive(30).ToExclusive(50); public int Value = 42; [Benchmark(Baseline = true)] public int ImperativeVersion() { if (Value < 30 || Value >= 50) throw new ArgumentOutOfRangeException(nameof(Value)); return Value; } [Benchmark] public int LightGuardClausesNewRange() => Value.MustBeIn(Range.FromInclusive(30).ToExclusive(50), nameof(Value)); [Benchmark] public int LightGuardClausesExistingRange() => Value.MustBeIn(Range, nameof(Value)); [Benchmark] public int LightGuardClausesCustomException() => Value.MustBeIn(Range, (value, range) => new Exception($"{value} is not in {range}.")); [Benchmark] public int OldVersion() => Value.OldMustBeIn(Range, nameof(Value)); } public static class MustBeInExtensionMethod { public static T OldMustBeIn(this T parameter, Range range, string parameterName = null, string message = null, Func exception = null) where T : IComparable { if (range.IsValueWithinRange(parameter)) return parameter; var fromBoundaryKind = range.IsFromInclusive ? "inclusive" : "exclusive"; var toBoundaryKind = range.IsToInclusive ? "inclusive" : "exclusive"; throw exception != null ? exception() : new ArgumentOutOfRangeException(parameterName, parameter, message ?? $"{parameterName ?? "The value"} must be between {range.From} ({fromBoundaryKind}) and {range.To} ({toBoundaryKind}), but you specified {parameter}."); } } }MustBeLessThanBenchmark.cs000066400000000000000000000031721470750352700350450ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/ComparableAssertionsusing System; using BenchmarkDotNet.Attributes; namespace Light.GuardClauses.Performance.ComparableAssertions { public class MustBeLessThanBenchmark { public double First = 42.7; public double Second = 78.21; [Benchmark(Baseline = true)] public double ImperativeVersion() { if (First >= Second) throw new ArgumentOutOfRangeException(nameof(First)); return First; } [Benchmark] public double ImperativeVersionWithCompareTo() { if (First.CompareTo(Second) >= 0) throw new ArgumentOutOfRangeException(nameof(First)); return First; } [Benchmark] public double LightGuardClausesWithParameterName() => First.MustBeLessThan(Second, nameof(First)); [Benchmark] public double LightGuardClausesCustomException() => First.MustBeLessThan(Second, (p, b) => new Exception($"{p} is not less than {b}.")); [Benchmark] public double OldVersion() => First.OldMustBeLessThan(Second, nameof(First)); } public static class MustBeLessThanExtensionMethods { public static T OldMustBeLessThan(this T parameter, T boundary, string parameterName = null, string message = null, Func exception = null) where T : IComparable { if (parameter.CompareTo(boundary) < 0) return parameter; throw exception != null ? exception() : new ArgumentOutOfRangeException(parameterName, parameter, message ?? $"{parameterName ?? "The value"} must be less than {boundary}, but you specified {parameter}."); } } }MustBeLessThanOrEqualToBenchmark.cs000066400000000000000000000047441470750352700366470ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/ComparableAssertionsusing System; using System.Runtime.CompilerServices; using BenchmarkDotNet.Attributes; namespace Light.GuardClauses.Performance.ComparableAssertions { public class MustBeLessThanOrEqualToBenchmark { public float First = 42.7f; public float Second = 78.21f; [Benchmark(Baseline = true)] public float ImperativeVersion() { if (First > Second) throw new ArgumentOutOfRangeException(nameof(First)); return First; } [Benchmark] public float ImperativeVersionWithCompareTo() { if (First.CompareTo(Second) > 0) throw new ArgumentOutOfRangeException(nameof(First)); return First; } [Benchmark] public float LightGuardClausesParameterName() => First.MustBeLessThanOrEqualTo(Second, nameof(First)); [Benchmark] public float LightGuardClausesCustomException() => First.MustBeLessThanOrEqualTo(Second, (p, b) => new Exception($"{p} is not less than {b}.")); [Benchmark] public float OldVersion() => First.OldMustBeLessThanOrEqualTo(Second, nameof(First)); [Benchmark] public float OnlyParameterNameVersion() => First.OnlyParameterNameMustBeLessThanOrEqualTo(Second, nameof(First)); } public static class MustBeLessThanOrEqualToExtensionMethods { [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T OnlyParameterNameMustBeLessThanOrEqualTo(this T parameter, T boundary, string parameterName = null) where T : IComparable { if (parameter.CompareTo(boundary) > 0) ThrowException(parameter, boundary, parameterName); return parameter; } private static void ThrowException(T parameter, T boundary, string paramterName) { throw new ArgumentOutOfRangeException(paramterName, $"The value must be less than or equal to {boundary}, but it actually is {parameter}."); } public static T OldMustBeLessThanOrEqualTo(this T parameter, T boundary, string parameterName = null, string message = null, Func exception = null) where T : IComparable { if (parameter.CompareTo(boundary) <= 0) return parameter; throw exception != null ? exception() : new ArgumentOutOfRangeException(parameterName, parameter, message ?? $"{parameterName ?? "The value"} must be less than {boundary}, but you specified {parameter}."); } } }MustNotBeGreaterThanBenchmark.cs000066400000000000000000000032311470750352700362050ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/ComparableAssertionsusing System; using BenchmarkDotNet.Attributes; namespace Light.GuardClauses.Performance.ComparableAssertions { public class MustNotBeGreaterThanBenchmark { public long First = 14819929; public long Second = 60001200202; [Benchmark(Baseline = true)] public long ImperativeVersion() { if (First > Second) throw new ArgumentOutOfRangeException(nameof(First)); return First; } [Benchmark] public long ImperativeVersionWithCompareTo() { if (First.CompareTo(Second) > 0) throw new ArgumentOutOfRangeException(nameof(First)); return First; } [Benchmark] public long LightGuardClausesWithParameterName() => First.MustNotBeGreaterThan(Second, nameof(First)); [Benchmark] public long LightGuardClausesCustomException() => First.MustNotBeGreaterThan(Second, (p, b) => new Exception($"{p} is not less than {b}.")); [Benchmark] public long OldVersion() => First.OldMustNotBeGreaterThan(Second, nameof(First)); } public static class MustNotBeGreaterThanExtensionMethods { public static T OldMustNotBeGreaterThan(this T parameter, T boundary, string parameterName = null, string message = null, Func exception = null) where T : IComparable { if (parameter.CompareTo(boundary) <= 0) return parameter; throw exception != null ? exception() : new ArgumentOutOfRangeException(parameterName, parameter, message ?? $"{parameterName ?? "The value"} must be less than {boundary}, but you specified {parameter}."); } } }MustNotBeGreaterThanOrEqualToBenchmark.cs000066400000000000000000000034371470750352700400110ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/ComparableAssertionsusing System; using BenchmarkDotNet.Attributes; namespace Light.GuardClauses.Performance.ComparableAssertions { public class MustNotBeGreaterThanOrEqualToBenchmark { public double First = 42.7; public double Second = 78.21; [Benchmark(Baseline = true)] public double ImperativeVersion() { if (First >= Second) throw new ArgumentOutOfRangeException(nameof(First)); return First; } [Benchmark] public double ImperativeVersionWithCompareTo() { // ReSharper disable once ImpureMethodCallOnReadonlyValueField if (First.CompareTo(Second) >= 0) throw new ArgumentOutOfRangeException(nameof(First)); return First; } [Benchmark] public double LightGuardClausesWithParameterName() => First.MustNotBeGreaterThanOrEqualTo(Second, nameof(First)); [Benchmark] public double LightGuardClausesCustomException() => First.MustNotBeGreaterThanOrEqualTo(Second, (p, b) => new Exception($"{p} is not less than {b}.")); [Benchmark] public double OldVersion() => First.OldMustNotBeGreaterThanOrEqualTo(Second, nameof(First)); } public static class MustNotBeGreaterThanOrEqualToExtensionMethods { public static T OldMustNotBeGreaterThanOrEqualTo(this T parameter, T boundary, string parameterName = null, string message = null, Func exception = null) where T : IComparable { if (parameter.CompareTo(boundary) < 0) return parameter; throw exception != null ? exception() : new ArgumentOutOfRangeException(parameterName, parameter, message ?? $"{parameterName ?? "The value"} must be less than {boundary}, but you specified {parameter}."); } } }MustNotBeInBenchmark.cs000066400000000000000000000035041470750352700343520ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/ComparableAssertionsusing System; using BenchmarkDotNet.Attributes; namespace Light.GuardClauses.Performance.ComparableAssertions { public class MustNotBeInBenchmark { public Range Range = Range.FromInclusive(1000).ToExclusive(15000); public int Value = 42; [Benchmark(Baseline = true)] public int ImperativeVersion() { if (Value >= 1000 && Value <= 150000) throw new ArgumentOutOfRangeException(nameof(Value)); return Value; } [Benchmark] public int LightGuardClausesNewRange() => Value.MustNotBeIn(Range.FromInclusive(1000).ToExclusive(15000), nameof(Value)); [Benchmark] public int LightGuardClausesExistingRange() => Value.MustNotBeIn(Range, nameof(Value)); [Benchmark] public int LightGuardClausesCustomException() => Value.MustNotBeIn(Range, (value, range) => new Exception($"{value} is in {range}.")); [Benchmark] public int OldVersion() => Value.OldMustNotBeIn(Range, nameof(Value)); } public static class MustNotBeInExtensionMethod { public static T OldMustNotBeIn(this T parameter, Range range, string parameterName = null, string message = null, Func exception = null) where T : IComparable { if (range.IsValueWithinRange(parameter) == false) return parameter; var fromBoundaryKind = range.IsFromInclusive ? "inclusive" : "exclusive"; var toBoundaryKind = range.IsToInclusive ? "inclusive" : "exclusive"; throw exception != null ? exception() : new ArgumentOutOfRangeException(parameterName, parameter, message ?? $"{parameterName ?? "The value"} must not be between {range.From} ({fromBoundaryKind}) and {range.To} ({toBoundaryKind}), but you specified {parameter}."); } } }MustNotBeLessThanBenchmark.cs000066400000000000000000000031341470750352700355240ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/ComparableAssertionsusing System; using BenchmarkDotNet.Attributes; namespace Light.GuardClauses.Performance.ComparableAssertions { public class MustNotBeLessThanBenchmark { public int First = 42; public int Second = 3; [Benchmark(Baseline = true)] public int ImperativeVersion() { if (First < Second) throw new ArgumentOutOfRangeException(nameof(First)); return First; } [Benchmark] public int ImperativeVersionWithCompareTo() { if (First.CompareTo(Second) < 0) throw new ArgumentOutOfRangeException(nameof(First)); return First; } [Benchmark] public int LightGuardClausesWithParameterName() => First.MustNotBeLessThan(Second, nameof(First)); [Benchmark] public int LightGuardClausesWithCustomException() => First.MustNotBeLessThan(Second, (x, y) => new Exception()); [Benchmark] public int OldVersion() => First.OldMustNotBeLessThan(Second, nameof(First)); } public static class MustNotBeLessThanExtensionMethods { public static T OldMustNotBeLessThan(this T parameter, T boundary, string parameterName = null, string message = null, Func exception = null) where T : IComparable { if (parameter.CompareTo(boundary) >= 0) return parameter; throw exception != null ? exception() : new ArgumentOutOfRangeException(parameterName, parameter, message ?? $"{parameterName ?? "The value"} must not be less than {boundary}, but you specified {parameter}."); } } }MustNotBeLessThanOrEqualToBenchmark.cs000066400000000000000000000034251470750352700373230ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/ComparableAssertionsusing System; using BenchmarkDotNet.Attributes; namespace Light.GuardClauses.Performance.ComparableAssertions { public class MustNotBeLessThanOrEqualToBenchmark { public short First = 13; public short Second = 12; [Benchmark(Baseline = true)] public short ImperativeVersion() { if (First <= Second) throw new ArgumentOutOfRangeException(nameof(First)); return First; } [Benchmark] public double ImperativeVersionWithCompareTo() { // ReSharper disable once ImpureMethodCallOnReadonlyValueField if (First.CompareTo(Second) <= 0) throw new ArgumentOutOfRangeException(nameof(First)); return First; } [Benchmark] public short LightGuardClausesWithParameterName() => First.MustNotBeLessThanOrEqualTo(Second, nameof(First)); [Benchmark] public short LightGuardClausesCustomException() => First.MustNotBeLessThanOrEqualTo(Second, (p, b) => new Exception($"{p} is not greater than {b}.")); [Benchmark] public short OldVersion() => First.OldMustNotBeLessThanOrEqualTo(Second, nameof(First)); } public static class MustNotBeLessThanOrEqualToExtensionMethods { public static T OldMustNotBeLessThanOrEqualTo(this T parameter, T boundary, string parameterName = null, string message = null, Func exception = null) where T : IComparable { if (parameter.CompareTo(boundary) > 0) return parameter; throw exception != null ? exception() : new ArgumentOutOfRangeException(parameterName, parameter, message ?? $"{parameterName ?? "The value"} must not be less than or equal to {boundary}, but you specified {parameter}."); } } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/DateTimeAssertions/000077500000000000000000000000001470750352700275455ustar00rootroot00000000000000MustBeLocalBenchmark.cs000066400000000000000000000026241470750352700340060ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/DateTimeAssertionsusing System; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses.Performance.DateTimeAssertions { public class MustBeLocalBenchmark { public DateTime LocalDateTime = DateTime.Now; [Benchmark(Baseline = true)] public DateTime ImperativeVersion() { if (LocalDateTime.Kind != DateTimeKind.Local) throw new InvalidDateTimeException(nameof(DateTime)); return LocalDateTime; } [Benchmark] public DateTime LightGuardClausesParameterName() => LocalDateTime.MustBeLocal(nameof(DateTime)); [Benchmark] public DateTime LightGuardClausesCustomException() => LocalDateTime.MustBeLocal(dt => new Exception($"{dt} is not local")); [Benchmark] public DateTime OldVersion() => LocalDateTime.OldMustBeLocal(nameof(DateTime)); } public static class MustBeLocalExtensionMethods { public static DateTime OldMustBeLocal(this DateTime dateTime, string parameterName = null, string message = null, Func exception = null) { if (dateTime.Kind == DateTimeKind.Local) return dateTime; throw exception != null ? exception() : new InvalidDateTimeException(parameterName, message ?? $"The specified date time \"{dateTime:O}\" must be of kind {DateTimeKind.Local}, but actually is {dateTime.Kind}."); } } }MustBeUnspecifiedBenchmark.cs000066400000000000000000000027451470750352700352160ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/DateTimeAssertionsusing System; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses.Performance.DateTimeAssertions { public class MustBeUnspecifiedBenchmark { public DateTime DateTime = new DateTime(2018, 2, 18, 16, 43, 00, DateTimeKind.Unspecified); [Benchmark(Baseline = true)] public DateTime ImperativeVersion() { if (DateTime.Kind != DateTimeKind.Unspecified) throw new InvalidDateTimeException(nameof(DateTime)); return DateTime; } [Benchmark] public DateTime LightGuardClausesParameterName() => DateTime.MustBeUnspecified(nameof(DateTime)); [Benchmark] public DateTime LightGuardClausesCustomException() => DateTime.MustBeUnspecified(dt => new Exception($"{dt} is not unspecified")); [Benchmark] public DateTime OldVersion() => DateTime.OldMustBeUnspecified(nameof(DateTime)); } public static class MustBeUnspecifiedExtensionMethods { public static DateTime OldMustBeUnspecified(this DateTime dateTime, string parameterName = null, string message = null, Func exception = null) { if (dateTime.Kind == DateTimeKind.Unspecified) return dateTime; throw exception != null ? exception() : new InvalidDateTimeException(parameterName, message ?? $"The specified date time \"{dateTime:O}\" must be of kind {DateTimeKind.Unspecified}, but actually is {dateTime.Kind}."); } } }MustBeUtcBenchmark.cs000066400000000000000000000026721470750352700335120ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/DateTimeAssertionsusing System; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses.Performance.DateTimeAssertions { public class MustBeUtcBenchmark { public DateTime UtcDateTime = DateTime.UtcNow; [Benchmark(Baseline = true)] public DateTime ImperativeVersion() { if (UtcDateTime.Kind != DateTimeKind.Utc) throw new InvalidDateTimeException(nameof(UtcDateTime)); return UtcDateTime; } [Benchmark] public DateTime LightGuardClauses() => UtcDateTime.MustBeUtc(nameof(UtcDateTime)); [Benchmark] public DateTime LightGuardClausesCustomException() => UtcDateTime.MustBeUtc(date => new Exception("Why do you not use UTC? Are you crazy?")); // https://nodatime.org/2.3.x/userguide/trivia [Benchmark] public DateTime OldVersion() => UtcDateTime.OldMustBeUtc(nameof(UtcDateTime)); } public static class MustBeUtcExtensionMethods { public static DateTime OldMustBeUtc(this DateTime dateTime, string parameterName = null, string message = null, Func exception = null) { if (dateTime.Kind == DateTimeKind.Utc) return dateTime; throw exception != null ? exception() : new InvalidDateTimeException(parameterName, message ?? $"The specified date time \"{dateTime:O}\" must be of kind {DateTimeKind.Utc}, but actually is {dateTime.Kind}."); } } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/FrameworkExtensions/000077500000000000000000000000001470750352700300135ustar00rootroot00000000000000HashFunctionBenchmark.cs000066400000000000000000000452021470750352700344720ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/FrameworkExtensionsusing System; using System.Collections.Generic; using System.Runtime.CompilerServices; using BenchmarkDotNet.Attributes; using Light.GuardClauses.FrameworkExtensions; namespace Light.GuardClauses.Performance.FrameworkExtensions { public class HashFunctionStringBenchmark { public string Bar = "Bar"; public string Baz = "Baz"; public string Foo = "Foo"; public string Qux = "Qux"; [Benchmark] public int ReSharperHash2Parameters() => ReSharperHash.CalculateHashCode(Foo, Bar); [Benchmark] public int ReSharperHash3Parameters() => ReSharperHash.CalculateHashCode(Foo, Bar, Baz); [Benchmark] public int ReSharperHash4Parameters() => ReSharperHash.CalculateHashCode(Foo, Bar, Baz, Qux); [Benchmark] public int Fnv1A2Parameters() => Fnv1AHash.CalculateHashCode(Foo, Bar); [Benchmark] public int Fnv1A3Parameters() => Fnv1AHash.CalculateHashCode(Foo, Bar, Baz); [Benchmark] public int Fnv1A4Parameters() => Fnv1AHash.CalculateHashCode(Foo, Bar, Baz, Qux); [Benchmark] public int XxHash2Parameters() => HashCode.Combine(Foo, Bar); [Benchmark] public int XxHash3Parameters() => HashCode.Combine(Foo, Bar, Baz); [Benchmark] public int XxHash4Parameters() => HashCode.Combine(Foo, Bar, Baz, Qux); [Benchmark] public int MultiplyAdd2Parameters() => MultiplyAddHash.CreateHashCode(Foo, Bar); [Benchmark] public int MultiplyAdd3Parameters() => MultiplyAddHash.CreateHashCode(Foo, Bar, Baz); [Benchmark] public int MultiplyAdd4Parameters() => MultiplyAddHash.CreateHashCode(Foo, Bar, Baz, Qux); } public class HashFunctionIntBenchmark { public int First = 475940556; public int Fourth = 2041509450; public int Second = 436669774; public int Third = 2103655226; [Benchmark] public int ReSharperHash2Parameters() => ReSharperHash.CalculateHashCode(First, Second); [Benchmark] public int ReSharperHash3Parameters() => ReSharperHash.CalculateHashCode(First, Second, Third); [Benchmark] public int ReSharperHash4Parameters() => ReSharperHash.CalculateHashCode(First, Second, Third, Fourth); [Benchmark] public int Fnv1A2Parameters() => Fnv1AHash.CalculateHashCode(First, Second); [Benchmark] public int Fnv1A3Parameters() => Fnv1AHash.CalculateHashCode(First, Second, Third); [Benchmark] public int Fnv1A4Parameters() => Fnv1AHash.CalculateHashCode(First, Second, Third, Fourth); [Benchmark] public int XxHash2Parameters() => HashCode.Combine(First, Second); [Benchmark] public int XxHash3Parameters() => HashCode.Combine(First, Second, Third); [Benchmark] public int XxHash4Parameters() => HashCode.Combine(First, Second, Third, Fourth); [Benchmark] public int MultiplyAdd2Parameters() => MultiplyAddHash.CreateHashCode(First, Second); [Benchmark] public int MultiplyAdd3Parameters() => MultiplyAddHash.CreateHashCode(First, Second, Third); [Benchmark] public int MultiplyAdd4Parameters() => MultiplyAddHash.CreateHashCode(First, Second, Third, Fourth); } public static class ReSharperHash { public const int Prime = 397; [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CalculateHashCode(T1 value1, T2 value2) { unchecked { var hashCode = value1.GetHashCode(); hashCode = (hashCode * Prime) ^ value2.GetHashCode(); return hashCode; } } [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CalculateHashCode(T1 value1, T2 value2, T3 value3) { unchecked { var hashCode = value1.GetHashCode(); hashCode = (hashCode * Prime) ^ value2.GetHashCode(); hashCode = (hashCode * Prime) ^ value3.GetHashCode(); return hashCode; } } [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CalculateHashCode(T1 value1, T2 value2, T3 value3, T4 value4) { unchecked { var hashCode = value1.GetHashCode(); hashCode = (hashCode * Prime) ^ value2.GetHashCode(); hashCode = (hashCode * Prime) ^ value3.GetHashCode(); hashCode = (hashCode * Prime) ^ value4.GetHashCode(); return hashCode; } } } public static class Fnv1AHash { public const int OffsetBasis = -2128831035; public const int FnvPrime = 16777619; [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CalculateHashCode(T1 value1, T2 value2) { unchecked { var hashCode = OffsetBasis; hashCode = (hashCode ^ value1.GetHashCode()) * FnvPrime; hashCode = (hashCode ^ value2.GetHashCode()) * FnvPrime; return hashCode; } } [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CalculateHashCode(T1 value1, T2 value2, T3 value3) { unchecked { var hashCode = OffsetBasis; hashCode = (hashCode ^ value1.GetHashCode()) * FnvPrime; hashCode = (hashCode ^ value2.GetHashCode()) * FnvPrime; hashCode = (hashCode ^ value3.GetHashCode()) * FnvPrime; return hashCode; } } [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CalculateHashCode(T1 value1, T2 value2, T3 value3, T4 value4) { unchecked { var hashCode = OffsetBasis; hashCode = (hashCode ^ value1.GetHashCode()) * FnvPrime; hashCode = (hashCode ^ value2.GetHashCode()) * FnvPrime; hashCode = (hashCode ^ value3.GetHashCode()) * FnvPrime; hashCode = (hashCode ^ value4.GetHashCode()) * FnvPrime; return hashCode; } } } // xxHash32 is used for the hash code. // https://github.com/Cyan4973/xxHash public struct HashCode { private static readonly uint s_seed = GenerateGlobalSeed(); private const uint Prime1 = 2654435761U; private const uint Prime2 = 2246822519U; private const uint Prime3 = 3266489917U; private const uint Prime4 = 668265263U; private const uint Prime5 = 374761393U; private uint _v1, _v2, _v3, _v4; private uint _queue1, _queue2, _queue3; private uint _length; private static uint GenerateGlobalSeed() { unchecked { return (uint) new Random().Next(); } } public static int Combine(T1 value1) { // Provide a way of diffusing bits from something with a limited // input hash space. For example, many enums only have a few // possible hashes, only using the bottom few bits of the code. Some // collections are built on the assumption that hashes are spread // over a larger space, so diffusing the bits may help the // collection work more efficiently. var hc1 = (uint) (value1?.GetHashCode() ?? 0); uint hash = MixEmptyState(); hash += 4; hash = QueueRound(hash, hc1); hash = MixFinal(hash); return (int) hash; } public static int Combine(T1 value1, T2 value2) { var hc1 = (uint) (value1?.GetHashCode() ?? 0); var hc2 = (uint) (value2?.GetHashCode() ?? 0); uint hash = MixEmptyState(); hash += 8; hash = QueueRound(hash, hc1); hash = QueueRound(hash, hc2); hash = MixFinal(hash); return (int) hash; } public static int Combine(T1 value1, T2 value2, T3 value3) { var hc1 = (uint) (value1?.GetHashCode() ?? 0); var hc2 = (uint) (value2?.GetHashCode() ?? 0); var hc3 = (uint) (value3?.GetHashCode() ?? 0); uint hash = MixEmptyState(); hash += 12; hash = QueueRound(hash, hc1); hash = QueueRound(hash, hc2); hash = QueueRound(hash, hc3); hash = MixFinal(hash); return (int) hash; } public static int Combine(T1 value1, T2 value2, T3 value3, T4 value4) { var hc1 = (uint) (value1?.GetHashCode() ?? 0); var hc2 = (uint) (value2?.GetHashCode() ?? 0); var hc3 = (uint) (value3?.GetHashCode() ?? 0); var hc4 = (uint) (value4?.GetHashCode() ?? 0); Initialize(out uint v1, out uint v2, out uint v3, out uint v4); v1 = Round(v1, hc1); v2 = Round(v2, hc2); v3 = Round(v3, hc3); v4 = Round(v4, hc4); uint hash = MixState(v1, v2, v3, v4); hash += 16; hash = MixFinal(hash); return (int) hash; } public static int Combine(T1 value1, T2 value2, T3 value3, T4 value4, T5 value5) { var hc1 = (uint) (value1?.GetHashCode() ?? 0); var hc2 = (uint) (value2?.GetHashCode() ?? 0); var hc3 = (uint) (value3?.GetHashCode() ?? 0); var hc4 = (uint) (value4?.GetHashCode() ?? 0); var hc5 = (uint) (value5?.GetHashCode() ?? 0); Initialize(out uint v1, out uint v2, out uint v3, out uint v4); v1 = Round(v1, hc1); v2 = Round(v2, hc2); v3 = Round(v3, hc3); v4 = Round(v4, hc4); uint hash = MixState(v1, v2, v3, v4); hash += 20; hash = QueueRound(hash, hc5); hash = MixFinal(hash); return (int) hash; } public static int Combine(T1 value1, T2 value2, T3 value3, T4 value4, T5 value5, T6 value6) { var hc1 = (uint) (value1?.GetHashCode() ?? 0); var hc2 = (uint) (value2?.GetHashCode() ?? 0); var hc3 = (uint) (value3?.GetHashCode() ?? 0); var hc4 = (uint) (value4?.GetHashCode() ?? 0); var hc5 = (uint) (value5?.GetHashCode() ?? 0); var hc6 = (uint) (value6?.GetHashCode() ?? 0); Initialize(out uint v1, out uint v2, out uint v3, out uint v4); v1 = Round(v1, hc1); v2 = Round(v2, hc2); v3 = Round(v3, hc3); v4 = Round(v4, hc4); uint hash = MixState(v1, v2, v3, v4); hash += 24; hash = QueueRound(hash, hc5); hash = QueueRound(hash, hc6); hash = MixFinal(hash); return (int) hash; } public static int Combine(T1 value1, T2 value2, T3 value3, T4 value4, T5 value5, T6 value6, T7 value7) { var hc1 = (uint) (value1?.GetHashCode() ?? 0); var hc2 = (uint) (value2?.GetHashCode() ?? 0); var hc3 = (uint) (value3?.GetHashCode() ?? 0); var hc4 = (uint) (value4?.GetHashCode() ?? 0); var hc5 = (uint) (value5?.GetHashCode() ?? 0); var hc6 = (uint) (value6?.GetHashCode() ?? 0); var hc7 = (uint) (value7?.GetHashCode() ?? 0); Initialize(out uint v1, out uint v2, out uint v3, out uint v4); v1 = Round(v1, hc1); v2 = Round(v2, hc2); v3 = Round(v3, hc3); v4 = Round(v4, hc4); uint hash = MixState(v1, v2, v3, v4); hash += 28; hash = QueueRound(hash, hc5); hash = QueueRound(hash, hc6); hash = QueueRound(hash, hc7); hash = MixFinal(hash); return (int) hash; } public static int Combine(T1 value1, T2 value2, T3 value3, T4 value4, T5 value5, T6 value6, T7 value7, T8 value8) { var hc1 = (uint) (value1?.GetHashCode() ?? 0); var hc2 = (uint) (value2?.GetHashCode() ?? 0); var hc3 = (uint) (value3?.GetHashCode() ?? 0); var hc4 = (uint) (value4?.GetHashCode() ?? 0); var hc5 = (uint) (value5?.GetHashCode() ?? 0); var hc6 = (uint) (value6?.GetHashCode() ?? 0); var hc7 = (uint) (value7?.GetHashCode() ?? 0); var hc8 = (uint) (value8?.GetHashCode() ?? 0); Initialize(out uint v1, out uint v2, out uint v3, out uint v4); v1 = Round(v1, hc1); v2 = Round(v2, hc2); v3 = Round(v3, hc3); v4 = Round(v4, hc4); v1 = Round(v1, hc5); v2 = Round(v2, hc6); v3 = Round(v3, hc7); v4 = Round(v4, hc8); uint hash = MixState(v1, v2, v3, v4); hash += 32; hash = MixFinal(hash); return (int) hash; } [MethodImpl(MethodImplOptions.AggressiveInlining)] private static uint Rol(uint value, int count) => (value << count) | (value >> (32 - count)); [MethodImpl(MethodImplOptions.AggressiveInlining)] private static void Initialize(out uint v1, out uint v2, out uint v3, out uint v4) { v1 = s_seed + Prime1 + Prime2; v2 = s_seed + Prime2; v3 = s_seed; v4 = s_seed - Prime1; } [MethodImpl(MethodImplOptions.AggressiveInlining)] private static uint Round(uint hash, uint input) { hash += input * Prime2; hash = Rol(hash, 13); hash *= Prime1; return hash; } [MethodImpl(MethodImplOptions.AggressiveInlining)] private static uint QueueRound(uint hash, uint queuedValue) { hash += queuedValue * Prime3; return Rol(hash, 17) * Prime4; } [MethodImpl(MethodImplOptions.AggressiveInlining)] private static uint MixState(uint v1, uint v2, uint v3, uint v4) { return Rol(v1, 1) + Rol(v2, 7) + Rol(v3, 12) + Rol(v4, 18); } private static uint MixEmptyState() { return s_seed + Prime5; } [MethodImpl(MethodImplOptions.AggressiveInlining)] private static uint MixFinal(uint hash) { hash ^= hash >> 15; hash *= Prime2; hash ^= hash >> 13; hash *= Prime3; hash ^= hash >> 16; return hash; } public void Add(T value) { Add(value?.GetHashCode() ?? 0); } public void Add(T value, IEqualityComparer comparer) { Add(comparer != null ? comparer.GetHashCode(value) : (value?.GetHashCode() ?? 0)); } private void Add(int value) { // The original xxHash works as follows: // 0. Initialize immediately. We can't do this in a struct (no // default ctor). // 1. Accumulate blocks of length 16 (4 uints) into 4 accumulators. // 2. Accumulate remaining blocks of length 4 (1 uint) into the // hash. // 3. Accumulate remaining blocks of length 1 into the hash. // There is no need for #3 as this type only accepts ints. _queue1, // _queue2 and _queue3 are basically a buffer so that when // ToHashCode is called we can execute #2 correctly. // We need to initialize the xxHash32 state (_v1 to _v4) lazily (see // #0) nd the last place that can be done if you look at the // original code is just before the first block of 16 bytes is mixed // in. The xxHash32 state is never used for streams containing fewer // than 16 bytes. // To see what's really going on here, have a look at the Combine // methods. var val = (uint) value; // Storing the value of _length locally shaves of quite a few bytes // in the resulting machine code. uint previousLength = _length++; uint position = previousLength % 4; // Switch can't be inlined. if (position == 0) _queue1 = val; else if (position == 1) _queue2 = val; else if (position == 2) _queue3 = val; else // position == 3 { if (previousLength == 3) Initialize(out _v1, out _v2, out _v3, out _v4); _v1 = Round(_v1, _queue1); _v2 = Round(_v2, _queue2); _v3 = Round(_v3, _queue3); _v4 = Round(_v4, val); } } public int ToHashCode() { // Storing the value of _length locally shaves of quite a few bytes // in the resulting machine code. uint length = _length; // position refers to the *next* queue position in this method, so // position == 1 means that _queue1 is populated; _queue2 would have // been populated on the next call to Add. uint position = length % 4; // If the length is less than 4, _v1 to _v4 don't contain anything // yet. xxHash32 treats this differently. uint hash = length < 4 ? MixEmptyState() : MixState(_v1, _v2, _v3, _v4); // _length is incremented once per Add(Int32) and is therefore 4 // times too small (xxHash length is in bytes, not ints). hash += length * 4; // Mix what remains in the queue // Switch can't be inlined right now, so use as few branches as // possible by manually excluding impossible scenarios (position > 1 // is always false if position is not > 0). if (position > 0) { hash = QueueRound(hash, _queue1); if (position > 1) { hash = QueueRound(hash, _queue2); if (position > 2) hash = QueueRound(hash, _queue3); } } hash = MixFinal(hash); return (int) hash; } public override int GetHashCode() => throw new NotSupportedException(); public override bool Equals(object obj) => throw new NotSupportedException(); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/Light.GuardClauses.Performance.csproj000066400000000000000000000006401470750352700331100ustar00rootroot00000000000000 Exe net8.0;net48 11 Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/Program.cs000066400000000000000000000014021470750352700257310ustar00rootroot00000000000000using BenchmarkDotNet.Configs; using BenchmarkDotNet.Diagnosers; using BenchmarkDotNet.Environments; using BenchmarkDotNet.Jobs; using BenchmarkDotNet.Running; namespace Light.GuardClauses.Performance { public static class Program { private static IConfig DefaultConfiguration => DefaultConfig .Instance .AddJob(Job.Default.WithRuntime(CoreRuntime.Core70)) .AddJob(Job.Default.WithRuntime(ClrRuntime.Net48)) .AddDiagnoser(MemoryDiagnoser.Default, new DisassemblyDiagnoser(new DisassemblyDiagnoserConfig())); public static void Main(string[] arguments) => BenchmarkSwitcher.FromAssembly(typeof(Program).Assembly).Run(arguments, DefaultConfiguration); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/SampleEntity.cs000066400000000000000000000003021470750352700267360ustar00rootroot00000000000000using System; namespace Light.GuardClauses.Performance { public sealed class SampleEntity { public readonly Guid Id; public SampleEntity(Guid id) => Id = id; } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/StringAssertions/000077500000000000000000000000001470750352700273175ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/StringAssertions/ContainsBenchmark.cs000066400000000000000000000050141470750352700332370ustar00rootroot00000000000000using System; using BenchmarkDotNet.Attributes; namespace Light.GuardClauses.Performance.StringAssertions { public class ContainsOrdinalBenchmark { public string LongString = "A mind needs books as a sword needs a whetstone, if it is to keep its edge."; public string NoSubstring = "age"; public string ShortString = "Edge"; public string Substring = "dge"; [Benchmark(Baseline = true)] public bool Short() => ShortString.Contains(Substring, StringComparison.Ordinal); [Benchmark] public bool ShortNoSubstring() => ShortString.Contains(NoSubstring, StringComparison.Ordinal); [Benchmark] public bool Long() => LongString.Contains(Substring, StringComparison.Ordinal); [Benchmark] public bool LongNoSubstring() => LongString.Contains(NoSubstring, StringComparison.Ordinal); } public class ContainsCurrentCultureBenchmark { public string LongString = "A mind needs books as a sword needs a whetstone, if it is to keep its edge."; public string NoSubstring = "age"; public string ShortString = "Edge"; public string Substring = "dge"; [Benchmark(Baseline = true)] public bool Short() => ShortString.Contains(Substring, StringComparison.CurrentCulture); [Benchmark] public bool ShortNoSubstring() => ShortString.Contains(NoSubstring, StringComparison.CurrentCulture); [Benchmark] public bool Long() => LongString.Contains(Substring, StringComparison.CurrentCulture); [Benchmark] public bool LongNoSubstring() => LongString.Contains(NoSubstring, StringComparison.CurrentCulture); } public class ContainsCurrentCultureIgnoreCaseBenchmark { public string LongString = "A mind needs books as a sword needs a whetstone, if it is to keep its edge."; public string NoSubstring = "age"; public string ShortString = "Edge"; public string Substring = "dge"; [Benchmark(Baseline = true)] public bool Short() => ShortString.Contains(Substring, StringComparison.CurrentCultureIgnoreCase); [Benchmark] public bool ShortNoSubstring() => ShortString.Contains(NoSubstring, StringComparison.CurrentCultureIgnoreCase); [Benchmark] public bool Long() => LongString.Contains(Substring, StringComparison.CurrentCultureIgnoreCase); [Benchmark] public bool LongNoSubstring() => LongString.Contains(NoSubstring, StringComparison.CurrentCultureIgnoreCase); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/StringAssertions/EqualsBenchmark.cs000066400000000000000000000066261470750352700327250ustar00rootroot00000000000000using System; using BenchmarkDotNet.Attributes; namespace Light.GuardClauses.Performance.StringAssertions { public class EqualsOrdinalBenchmark { public string StringA = "When dead men and worse come hunting… you think it matters who sits on the Iron Throne?"; public string StringB = "When dead men and worse come hunting… you think it matters who sits on the Iron Throne?"; public string StringC = "When dead men and worse come hunting… you think it matters who sits on the washing machine?"; [Benchmark(Baseline = true)] public bool ImperativeEqual() => string.Equals(StringA, StringB, StringComparison.Ordinal); [Benchmark] public bool ImperativeNotEqual() => string.Equals(StringA, StringC, StringComparison.Ordinal); [Benchmark] public bool LightGuardClausesEqual() => StringA.Equals(StringB, StringComparisonType.Ordinal); [Benchmark] public bool LightGuardClausesNotEqual() => StringA.Equals(StringC, StringComparisonType.Ordinal); } public class EqualsOrdinalIgnoreCaseBenchmark { public string StringA = "A drunken dwarf will never be the savior of the Seven Kingdoms."; public string StringB = "A DRUNKEN DWARF will never be the savior of the seven kingdoms."; public string StringC = "A drunken DWARF will never be the savior of the seven realms."; [Benchmark(Baseline = true)] public bool ImperativeEqual() => string.Equals(StringA, StringB, StringComparison.OrdinalIgnoreCase); [Benchmark] public bool ImperativeNotEqual() => string.Equals(StringA, StringC, StringComparison.OrdinalIgnoreCase); [Benchmark] public bool LightGuardClausesEqual() => StringA.Equals(StringB, StringComparisonType.OrdinalIgnoreCase); [Benchmark] public bool LightGuardClausesNotEqual() => StringA.Equals(StringC, StringComparisonType.OrdinalIgnoreCase); } public class EqualsCurrentCultureBenchmark { // I love these GoT quotes ;-) public string StringA = "If you ever call me sister again, I'll have you strangled in your sleep."; public string StringB = "If you ever call me sister again, I'll have you strangled in your sleep."; public string StringC = "If you ever call me sister again, I'll have you strangled and quartered."; [Benchmark(Baseline = true)] public bool ImperativeEqual() => string.Equals(StringA, StringB, StringComparison.CurrentCulture); [Benchmark] public bool ImperativeNotEqual() => string.Equals(StringA, StringC, StringComparison.CurrentCulture); [Benchmark] public bool LightGuardClausesEqual() => StringA.Equals(StringB, StringComparisonType.CurrentCulture); [Benchmark] public bool LightGuardClausesNotEqual() => StringA.Equals(StringC, StringComparisonType.CurrentCulture); } public class EqualsOrdinalIgnoreWhiteSpaceBenchmark { // ReSharper disable StringLiteralTypo public string JsonMinified = "{\"firstName\":\"Kenny\",\"lastName\":\"Pflug\",\"nickName\":\"feO2x\"}"; public string JsonReadable = @"{ ""firstName"": ""Kenny"", ""lastName"": ""Pflug"", ""nickName"": ""feO2x"" }"; // ReSharper restore StringLiteralTypo [Benchmark] public bool LightGuardClauses() => JsonMinified.Equals(JsonReadable, StringComparisonType.OrdinalIgnoreWhiteSpace); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/StringAssertions/IsDigitBenchmark.cs000066400000000000000000000011001470750352700330050ustar00rootroot00000000000000using BenchmarkDotNet.Attributes; namespace Light.GuardClauses.Performance.StringAssertions { public class IsDigitBenchmark { public char Digit = '9'; public char NoDigit = 't'; [Benchmark(Baseline = true)] public bool ImperativeDigit() => char.IsDigit(Digit); [Benchmark] public bool ImperativeNoDigit() => char.IsDigit(NoDigit); [Benchmark] public bool LightGuardClausesDigit() => Digit.IsDigit(); [Benchmark] public bool LightGuardClausesNoDigit() => NoDigit.IsDigit(); } }IsEmailAddressBenchmark.cs000066400000000000000000000036241470750352700342400ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/StringAssertionsusing System.Text.RegularExpressions; using BenchmarkDotNet.Attributes; namespace Light.GuardClauses.Performance.StringAssertions { public class IsEmailAddressBenchmark { public string InvalidEmail = "email@domain@domain.com"; public string ValidEmail = "firstname-lastname@domain.com"; private static readonly Regex SimpleRegex = new Regex(@"^[^@\s]+@[^@\s]+\.[^@\s]+$"); [Benchmark(Baseline = true)] public bool ImperativeValidEmail() => ValidEmail != null && RegularExpressions.EmailRegex.IsMatch(ValidEmail); [Benchmark] public bool ImperativeInvalidEmail() => InvalidEmail != null && RegularExpressions.EmailRegex.IsMatch(InvalidEmail); [Benchmark] public bool LightGuardClausesValidEmail() => ValidEmail.IsEmailAddress(); [Benchmark] public bool LightGuardClausesInvalidEmail() => InvalidEmail.IsEmailAddress(); [Benchmark] public bool LightGuardClausesSimpleRegexValidEmail() => ValidEmail.IsEmailAddress(SimpleRegex); [Benchmark] public bool LightGuardClausesSimpleRegexInvalidEmail() => InvalidEmail.IsEmailAddress(SimpleRegex); [Benchmark] public bool AllocatingVersionValidEmail() => ValidEmail.AllocatingIsEmailAddress(); [Benchmark] public bool AllocatingVersionInvalidEmail() => InvalidEmail.AllocatingIsEmailAddress(); } public static class IsEmailAddressExtensions { public static bool AllocatingIsEmailAddress(this string emailAddress) { if (emailAddress == null) return false; var regex = new Regex( @"^[\w!#$%&'*+\-/=?\^_`{|}~]+(\.[\w!#$%&'*+\-/=?\^_`{|}~]+)*@((((\w+\-?)+\.)+[a-zA-Z]{2,4})|(([0-9]{1,3}\.){3}[0-9]{1,3}))$", RegexOptions.CultureInvariant | RegexOptions.ECMAScript ); return regex.IsMatch(emailAddress); } } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/StringAssertions/IsLetterBenchmark.cs000066400000000000000000000011171470750352700332140ustar00rootroot00000000000000using BenchmarkDotNet.Attributes; namespace Light.GuardClauses.Performance.StringAssertions { public class IsLetterBenchmark { public char Letter = 'w'; public char NoLetter = '%'; [Benchmark(Baseline = true)] public bool ImperativeLetter() => char.IsLetter(Letter); [Benchmark] public bool ImperativeNoLetter() => char.IsLetter(NoLetter); [Benchmark] public bool LightGuardClausesLetter() => Letter.IsLetter(); [Benchmark] public bool LightGuardClausesNoLetter() => NoLetter.IsLetter(); } }IsLetterOrDigitBenchmark.cs000066400000000000000000000015571470750352700344270ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/StringAssertionsusing BenchmarkDotNet.Attributes; namespace Light.GuardClauses.Performance.StringAssertions { public class IsLetterOrDigitBenchmark { public char Digit = '4'; public char Letter = 'P'; public char NoLetterOrDigit = '/'; [Benchmark(Baseline = true)] public bool ImperativeLetter() => char.IsLetterOrDigit(Letter); [Benchmark] public bool ImperativeDigit() => char.IsLetterOrDigit(Digit); [Benchmark] public bool ImperativeNoLetterOrDigit() => char.IsLetterOrDigit(NoLetterOrDigit); [Benchmark] public bool LightGuardClausesLetter() => Letter.IsLetterOrDigit(); [Benchmark] public bool LightGuardClausesDigit() => Digit.IsLetterOrDigit(); [Benchmark] public bool LightGuardClausesNoLetterOrDigit() => NoLetterOrDigit.IsLetterOrDigit(); } }IsNullOrEmptyBenchmark.cs000066400000000000000000000016251470750352700341340ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/StringAssertionsusing BenchmarkDotNet.Attributes; namespace Light.GuardClauses.Performance.StringAssertions { public class IsNullOrEmptyBenchmark { public string EmptyString = ""; public string NullString = null; public string StringWithContent = "Hello"; [Benchmark(Baseline = true)] public bool ImperativeNull() => string.IsNullOrEmpty(NullString); [Benchmark] public bool ImperativeEmpty() => string.IsNullOrEmpty(EmptyString); [Benchmark] public bool ImperativeStringWithContent() => string.IsNullOrEmpty(StringWithContent); [Benchmark] public bool LightGuardClausesNull() => NullString.IsNullOrEmpty(); [Benchmark] public bool LightGuardClausesEmpty() => EmptyString.IsNullOrEmpty(); [Benchmark] public bool LightGuardClausesStringWithContent() => StringWithContent.IsNullOrEmpty(); } }IsNullOrWhiteSpaceBenchmark.cs000066400000000000000000000023301470750352700350640ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/StringAssertionsusing BenchmarkDotNet.Attributes; namespace Light.GuardClauses.Performance.StringAssertions { public class IsNullOrWhiteSpaceBenchmark { public string EmptyString = ""; public string NullString = null; public string StringWithContent = "What`s up"; public string WhiteSpaceString = " \t\r\n"; [Benchmark(Baseline = true)] public bool ImperativeNull() => string.IsNullOrWhiteSpace(NullString); [Benchmark] public bool ImperativeEmpty() => string.IsNullOrWhiteSpace(EmptyString); [Benchmark] public bool ImperativeWhiteSpace() => string.IsNullOrWhiteSpace(WhiteSpaceString); [Benchmark] public bool ImperativeStringWithContent() => string.IsNullOrWhiteSpace(StringWithContent); [Benchmark] public bool LightGuardClausesNull() => NullString.IsNullOrWhiteSpace(); [Benchmark] public bool LightGuardClausesEmpty() => EmptyString.IsNullOrWhiteSpace(); [Benchmark] public bool LightGuardClausesWhiteSpaceString() => WhiteSpaceString.IsNullOrWhiteSpace(); [Benchmark] public bool LightGuardClausesStringWithContent() => StringWithContent.IsNullOrWhiteSpace(); } }IsSubstringOfBenchmark.cs000066400000000000000000000051271470750352700341500ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/StringAssertionsusing System; using BenchmarkDotNet.Attributes; namespace Light.GuardClauses.Performance.StringAssertions { public class IsSubstringOfOrdinalBenchmark { public string LongString = "A mind needs books as a sword needs a whetstone, if it is to keep its edge."; public string NoSubstring = "age"; public string ShortString = "Edge"; public string Substring = "dge"; [Benchmark(Baseline = true)] public bool Short() => Substring.IsSubstringOf(ShortString, StringComparison.Ordinal); [Benchmark] public bool ShortNoSubstring() => NoSubstring.IsSubstringOf(ShortString, StringComparison.Ordinal); [Benchmark] public bool Long() => Substring.IsSubstringOf(LongString, StringComparison.Ordinal); [Benchmark] public bool LongNoSubstring() => NoSubstring.IsSubstringOf(LongString, StringComparison.Ordinal); } public class IsSubstringOfCurrentCultureBenchmark { public string LongString = "A mind needs books as a sword needs a whetstone, if it is to keep its edge."; public string NoSubstring = "age"; public string ShortString = "Edge"; public string Substring = "dge"; [Benchmark(Baseline = true)] public bool Short() => Substring.IsSubstringOf(ShortString, StringComparison.CurrentCulture); [Benchmark] public bool ShortNoSubstring() => NoSubstring.IsSubstringOf(ShortString, StringComparison.CurrentCulture); [Benchmark] public bool Long() => Substring.IsSubstringOf(LongString, StringComparison.CurrentCulture); [Benchmark] public bool LongNoSubstring() => NoSubstring.IsSubstringOf(LongString, StringComparison.CurrentCulture); } public class IsSubstringOfCurrentCultureIgnoreCaseBenchmark { public string LongString = "A mind needs books as a sword needs a whetstone, if it is to keep its edge."; public string NoSubstring = "age"; public string ShortString = "Edge"; public string Substring = "dge"; [Benchmark(Baseline = true)] public bool Short() => Substring.IsSubstringOf(ShortString, StringComparison.CurrentCultureIgnoreCase); [Benchmark] public bool ShortNoSubstring() => NoSubstring.IsSubstringOf(ShortString, StringComparison.CurrentCultureIgnoreCase); [Benchmark] public bool Long() => Substring.IsSubstringOf(LongString, StringComparison.CurrentCultureIgnoreCase); [Benchmark] public bool LongNoSubstring() => NoSubstring.IsSubstringOf(LongString, StringComparison.CurrentCultureIgnoreCase); } }IsWhiteSpaceBenchmark.cs000066400000000000000000000012141470750352700337300ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/StringAssertionsusing BenchmarkDotNet.Attributes; namespace Light.GuardClauses.Performance.StringAssertions { public class IsWhiteSpaceBenchmark { public char NoWhiteSpace = 'K'; public char WhiteSpace = '\t'; [Benchmark(Baseline = true)] public bool ImperativeWhiteSpace() => char.IsWhiteSpace(WhiteSpace); [Benchmark] public bool ImperativeNoWhiteSpace() => char.IsWhiteSpace(NoWhiteSpace); [Benchmark] public bool LightGuardClausesWhiteSpace() => WhiteSpace.IsWhiteSpace(); [Benchmark] public bool LightGuardClausesNoWhiteSpace() => NoWhiteSpace.IsWhiteSpace(); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/StringAssertions/MustBeBenchmark.cs000066400000000000000000000015721470750352700326650ustar00rootroot00000000000000using System; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses.Performance.StringAssertions { public class MustBeBenchmark { public string X = "{\"foo\":42}"; public string Y = "{\r\n \"foo\": 42\r\n}\r\n"; [Benchmark(Baseline = true)] public string ImperativeVersion() { if (!X.Equals(Y, StringComparisonType.OrdinalIgnoreWhiteSpace)) throw new ValuesNotEqualException(nameof(X)); return X; } [Benchmark] public string LightGuardClauses() => X.MustBe(Y, StringComparisonType.OrdinalIgnoreWhiteSpace); [Benchmark] public string LightGuardClausesCustomException() => X.MustBe(Y, StringComparisonType.OrdinalIgnoreWhiteSpace, (_, _, _) => new Exception("The strings are not equal.")); } }MustBeNewLineBenchmark.cs000066400000000000000000000015371470750352700340710ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/StringAssertionsusing System; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses.Performance.StringAssertions { public class MustBeNewLineBenchmark { public string NewLineString = "\r\n"; [Benchmark(Baseline = true)] public string ImperativeVersion() { if (NewLineString == null) throw new ArgumentNullException(nameof(NewLineString)); if (NewLineString != "\n" && NewLineString != "\r\n") throw new StringException(nameof(NewLineString)); return NewLineString; } [Benchmark] public string LightGuardClauses() => NewLineString.MustBeNewLine(nameof(NewLineString)); [Benchmark] public string LightGuardClausesCustomException() => NewLineString.MustBeNewLine(_ => new Exception("No new line string")); } }MustBeShorterThanBenchmark.cs000066400000000000000000000026351470750352700347710ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/StringAssertionsusing System; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses.Performance.StringAssertions { public class MustBeShorterThanBenchmark { public int LongLength = 111; public string LongString = "I’m quite good at spending money but a lifetime of outrageous wealth has not taught me much about managing it."; public int ShortLength = 6; public string ShortString = "Hello"; [Benchmark(Baseline = true)] public string ImperativeShort() { if (ShortString == null) throw new ArgumentNullException(nameof(ShortString)); if (ShortString.Length >= ShortLength) throw new StringLengthException(nameof(ShortString)); return ShortString; } [Benchmark] public string ImperativeLong() { if (LongString == null) throw new ArgumentNullException(nameof(ShortString)); if (LongString.Length >= LongLength) throw new StringLengthException(nameof(ShortString)); return LongString; } [Benchmark] public string LightGuardClausesShort() => ShortString.MustBeShorterThan(ShortLength, nameof(ShortString)); [Benchmark] public string LightGuardClausesLong() => LongString.MustBeShorterThan(LongLength, nameof(LongString)); } }MustBeSubstringOfBenchmark.cs000066400000000000000000000075471470750352700350040ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/StringAssertionsusing System; using System.Globalization; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses.Performance.StringAssertions { public class MustBeSubstringOfBenchmark { public string Other = "I shall wear this as a badge of honor."; public string Substring = "wear this"; [Benchmark(Baseline = true)] public string ImperativeVersion() { if (Substring == null) throw new ArgumentNullException(nameof(Substring)); if (!Other.Contains(Substring)) throw new SubstringException(nameof(Substring)); return Substring; } [Benchmark] public string ImperativeVersionCustomComparisonType() { if (Substring == null) throw new ArgumentNullException(nameof(Substring)); if (Other.IndexOf(Substring, StringComparison.CurrentCultureIgnoreCase) < 0) throw new SubstringException(nameof(Substring)); return Substring; } [Benchmark] public string LightGuardClauses() => Substring.MustBeSubstringOf(Other, nameof(Substring)); [Benchmark] public string LightGuardClausesCustomComparisonType() => Substring.MustBeSubstringOf(Other, StringComparison.CurrentCultureIgnoreCase); [Benchmark] public string LightGuardClausesCustomException() => Substring.MustBeSubstringOf(Other, (s1, s2) => new Exception($"Where is your honor, {s1}?")); [Benchmark] public string LightGuardClausesCustomExceptionCustomComparisonType() => Substring.MustBeSubstringOf(Other, StringComparison.CurrentCultureIgnoreCase, (x, y, c) => new Exception($"Where is your honor, {x}? ({c})")); [Benchmark] public string OldVersion() => Substring.OldMustBeSubstringOf(Other, parameterName: nameof(Other)); } public static class MustBeSubstringOfExtensions { public static string OldMustBeSubstringOf(this string parameter, string text, IgnoreCaseInfo ignoreCase = default, string parameterName = null, string message = null, Func exception = null) { parameter.MustNotBeNull(parameterName); text.MustNotBeNull(nameof(text)); if (text.IsContaining(parameter, ignoreCase)) return parameter; throw exception?.Invoke() ?? new StringException(message ?? $"\"{parameter}\" must be a substring of \"{text}\", but it is not.", parameterName); } public static bool IsContaining(this string @string, string text, IgnoreCaseInfo ignoreCase = default) { @string.MustNotBeNull(nameof(@string)); text.MustNotBeNull(nameof(text)); return ignoreCase.StringContains(@string, text); } } public readonly struct IgnoreCaseInfo { public readonly CultureInfo CultureInfo; public readonly CompareOptions CompareOptions; public IgnoreCaseInfo(CultureInfo cultureInfo, CompareOptions compareOptions) { CultureInfo = cultureInfo.MustNotBeNull(nameof(cultureInfo)); CompareOptions = compareOptions.MustBeValidEnumValue(nameof(compareOptions)); } public static implicit operator IgnoreCaseInfo(bool ignoreCase) { return ignoreCase ? new IgnoreCaseInfo(CultureInfo.InvariantCulture, CompareOptions.OrdinalIgnoreCase) : new IgnoreCaseInfo(); } public static implicit operator IgnoreCaseInfo(CultureInfo cultureInfo) { return new IgnoreCaseInfo(cultureInfo, CompareOptions.OrdinalIgnoreCase); } public bool StringContains(string @string, string substring) { if (CultureInfo == null) return @string.MustNotBeNull(nameof(@string)).Contains(substring); return CultureInfo.CompareInfo.IndexOf(@string, substring, CompareOptions) != -1; } } }MustContainBenchmark.cs000066400000000000000000000120241470750352700336450ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/StringAssertionsusing System; using System.Globalization; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses.Performance.StringAssertions { public class MustContainBenchmark { public string LongString = "A mind needs books as a sword needs a whetstone, if it is to keep its edge."; public string ShortString = "Edge"; public string Substring = "dge"; [Benchmark(Baseline = true)] public string ImperativeVersionShort() { if (ShortString == null) throw new ArgumentNullException(nameof(ShortString)); if (!ShortString.Contains(Substring)) throw new SubstringException(nameof(ShortString)); return ShortString; } [Benchmark] public string ImperativeVersionLong() { if (LongString == null) throw new ArgumentNullException(nameof(LongString)); if (!LongString.Contains(Substring)) throw new SubstringException(nameof(LongString)); return LongString; } [Benchmark] public string LightGuardClausesShort() => ShortString.MustContain(Substring, nameof(ShortString)); [Benchmark] public string LightGuardClausesShortCustomException() => ShortString.MustContain(Substring, (s1, s2) => new Exception("Not contained.")); [Benchmark] public string LightGuardClausesLong() => LongString.MustContain(Substring, nameof(LongString)); [Benchmark] public string LightGuardClausesLongCustomException() => LongString.MustContain(Substring, (s1, s2) => new Exception("Not contained.")); [Benchmark] public string LightGuardClausesShortCustomSearch() => ShortString.MustContain(Substring, StringComparison.OrdinalIgnoreCase, nameof(ShortString)); [Benchmark] public string LightGuardClausesShortCustomSearchCustomException() => ShortString.MustContain(Substring, StringComparison.OrdinalIgnoreCase, (s1, s2, c) => new Exception("Not contained.")); [Benchmark] public string LightGuardClausesLongCustomSearch() => LongString.MustContain(Substring, StringComparison.OrdinalIgnoreCase, nameof(ShortString)); [Benchmark] public string LightGuardClausesLongCustomSearchCustomException() => LongString.MustContain(Substring, StringComparison.OrdinalIgnoreCase, (s1, s2, c) => new Exception("Not contained.")); [Benchmark] public string OldVersionShort() => ShortString.OldMustContain(Substring, parameterName: nameof(ShortString)); [Benchmark] public string OldVersionLong() => LongString.OldMustContain(Substring, parameterName: nameof(LongString)); [Benchmark] public string OldVersionShortCustomSearch() => ShortString.OldMustContain(Substring, true, nameof(ShortString)); [Benchmark] public string OldVersionLOngCustomSearch() => LongString.OldMustContain(Substring, true, nameof(LongString)); } public static class MustContainExtensions { public static string OldMustContain(this string parameter, string text, IgnoreCaseInfo ignoreCase = default, string parameterName = null, string message = null, Func exception = null) { parameter.MustNotBeNull(parameterName); text.MustNotBeNull(nameof(text)); if (parameter.IsContaining(text, ignoreCase)) return parameter; throw exception?.Invoke() ?? new StringException(message ?? $"\"{parameter}\" must contain \"{text}\", but it does not.", parameterName); } public static bool IsContaining(this string @string, string text, IgnoreCaseInfo ignoreCase = default) { @string.MustNotBeNull(nameof(@string)); text.MustNotBeNull(nameof(text)); return ignoreCase.StringContains(@string, text); } public readonly struct IgnoreCaseInfo { public readonly CultureInfo CultureInfo; public readonly CompareOptions CompareOptions; public IgnoreCaseInfo(CultureInfo cultureInfo, CompareOptions compareOptions) { CultureInfo = cultureInfo.MustNotBeNull(nameof(cultureInfo)); CompareOptions = compareOptions.MustBeValidEnumValue(nameof(compareOptions)); } public static implicit operator IgnoreCaseInfo(bool ignoreCase) { return ignoreCase ? new IgnoreCaseInfo(CultureInfo.InvariantCulture, CompareOptions.OrdinalIgnoreCase) : new IgnoreCaseInfo(); } public static implicit operator IgnoreCaseInfo(CultureInfo cultureInfo) { return new IgnoreCaseInfo(cultureInfo, CompareOptions.OrdinalIgnoreCase); } public bool StringContains(string @string, string substring) { if (CultureInfo == null) return @string.MustNotBeNull(nameof(@string)).Contains(substring); return CultureInfo.CompareInfo.IndexOf(@string, substring, CompareOptions) != -1; } } } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/StringAssertions/MustMatchBenchmark.cs000066400000000000000000000044631470750352700333750ustar00rootroot00000000000000using System; using System.Text.RegularExpressions; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses.Performance.StringAssertions { public class MustMatchBenchmark { public Regex ComplexRegex = new Regex("^[\\w!#$%&\'*+\\-/=?\\^_`{|}~]+(\\.[\\w!#$%&\'*+\\-/=?\\^_`{|}~]+)*@((([\\-\\w]+\\.)+[a-zA-Z]{2,4})|(([0-9]{1,3}\\.){3}[0-9]{1,3}))$"); // as per https://stackoverflow.com/a/6893571/1560623 public Regex SimpleRegex = new Regex(@"\w5"); public string String = "some.email@address.com"; [Benchmark(Baseline = true)] public string ImperativeSimpleVersion() { if (String == null) throw new ArgumentNullException(nameof(String)); if (!SimpleRegex.IsMatch(String)) throw new StringDoesNotMatchException(nameof(String)); return String; } [Benchmark] public string ImperativeComplexVersion() { if (String == null) throw new ArgumentNullException(nameof(String)); if (!ComplexRegex.IsMatch(String)) throw new StringDoesNotMatchException(nameof(String)); return String; } [Benchmark] public string LightGuardClausesSimple() => String.MustMatch(SimpleRegex, nameof(String)); [Benchmark] public string LightGuardClausesComplex() => String.MustMatch(ComplexRegex, nameof(String)); [Benchmark] public string LightGuardClausesCustomExceptionSimple() => String.MustMatch(SimpleRegex, (s, r) => new Exception("It doesn't match.")); [Benchmark] public string OldVersion() => String.OldMustMatch(SimpleRegex, nameof(String)); } public static class MustMatchExtensions { public static string OldMustMatch(this string parameter, Regex pattern, string parameterName = null, string message = null, Func exception = null) { parameter.MustNotBeNull(parameterName); pattern.MustNotBeNull(nameof(pattern)); if (pattern.IsMatch(parameter)) return parameter; throw exception?.Invoke() ?? new StringDoesNotMatchException(parameterName, message ?? $"{parameterName ?? "The string"} must match the regular expression {pattern}, but you specified {parameterName}."); } } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/StringAssertions/MustNotBeBenchmark.cs000066400000000000000000000017241470750352700333450ustar00rootroot00000000000000using System; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses.Performance.StringAssertions { public class MustNotBeBenchmark { public string X = "This is the first string"; // ReSharper disable once StringLiteralTypo public string Y = "THISISTHESECONDSTRING"; [Benchmark(Baseline = true)] public string ImperativeVersion() { if (X.Equals(Y, StringComparisonType.OrdinalIgnoreCaseIgnoreWhiteSpace)) throw new ValuesEqualException(nameof(X)); return X; } [Benchmark] public string LightGuardClauses() => X.MustNotBe(Y, StringComparisonType.OrdinalIgnoreCaseIgnoreWhiteSpace); [Benchmark] public string LightGuardClausesCustomException() => X.MustNotBe(Y, StringComparisonType.OrdinalIgnoreCaseIgnoreWhiteSpace, (_, _, _) => new Exception("The strings are equal.")); } }MustNotBeNullOrEmptyBenchmark.cs000066400000000000000000000030211470750352700354310ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/StringAssertionsusing System; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses.Performance.StringAssertions { public class MustNotBeNullOrEmptyBenchmark { public string NonEmptyString = "Foo"; [Benchmark(Baseline = true)] public string ImperativeVersion() { if (NonEmptyString == null) throw new ArgumentNullException(nameof(NonEmptyString)); if (NonEmptyString == string.Empty) throw new EmptyStringException(nameof(NonEmptyString)); return NonEmptyString; } [Benchmark] public string LightGuardClauses() => NonEmptyString.MustNotBeNullOrEmpty(nameof(NonEmptyString)); [Benchmark] public string LightGuardClausesCustomException() => NonEmptyString.MustNotBeNullOrEmpty(_ => new Exception("The string must not be null or empty")); [Benchmark] public string OldVersion() => NonEmptyString.OldMustNotBeNullOrEmpty(nameof(NonEmptyString)); } public static class MustNotBeNullOrEmptyExtensions { public static string OldMustNotBeNullOrEmpty(this string parameter, string parameterName = null, string message = null, Func exception = null) { parameter.MustNotBeNull(parameterName); if (parameter == string.Empty) throw exception?.Invoke() ?? (message == null ? new EmptyStringException(parameterName) : new EmptyStringException(message, parameterName)); return parameter; } } }MustNotBeNullOrWhiteSpaceBenchmark.cs000066400000000000000000000034021470750352700363720ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/StringAssertionsusing System; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses.Performance.StringAssertions { public class MustNotBeNullOrWhiteSpaceBenchmark { public string NonEmptyString = "Foo"; [Benchmark(Baseline = true)] public string ImperativeVersion() { if (NonEmptyString == null) throw new ArgumentNullException(nameof(NonEmptyString)); if (NonEmptyString == string.Empty) throw new EmptyStringException(nameof(NonEmptyString)); if (string.IsNullOrWhiteSpace(NonEmptyString)) throw new WhiteSpaceStringException(nameof(NonEmptyString)); return NonEmptyString; } [Benchmark] public string LightGuardClauses() => NonEmptyString.MustNotBeNullOrWhiteSpace(nameof(NonEmptyString)); [Benchmark] public string LightGuardClausesCustomException() => NonEmptyString.MustNotBeNullOrWhiteSpace(_ => new Exception("The string must not contain only white space")); [Benchmark] public string OldVersion() => NonEmptyString.OldMustNotBeNullOrWhiteSpace(nameof(NonEmptyString)); } public static class MustNotBeNullOrWhiteSpaceExtensions { public static string OldMustNotBeNullOrWhiteSpace(this string parameter, string parameterName = null, string message = null, Func exception = null) { parameter.OldMustNotBeNullOrEmpty(parameterName, message, exception); // ReSharper disable once LoopCanBeConvertedToQuery foreach (var character in parameter) if (char.IsWhiteSpace(character) == false) return parameter; throw exception?.Invoke() ?? new WhiteSpaceStringException(); } } }MustNotBeSubstringOfBenchmark.cs000066400000000000000000000032141470750352700354500ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/StringAssertionsusing System; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses.Performance.StringAssertions { public class MustNotBeSubstringOfBenchmark { public string StringA = "There is no creature on earth half so terrifying as a truly just man."; public string StringB = "truly just woman"; [Benchmark(Baseline = true)] public string Imperative() { if (StringA.Contains(StringB)) throw new SubstringException(nameof(StringB)); return StringB; } [Benchmark] public string LightGuardClauses() => StringB.MustNotBeSubstringOf(StringA, nameof(StringB)); [Benchmark] public string LightGuardClausesCustomException() => StringB.MustNotBeSubstringOf(StringA, (x, y) => new Exception($"{x} is substring of {y}.")); [Benchmark] public string OldVersion() => StringB.OldMustNotBeSubstringOf(StringA, parameterName: nameof(StringB)); } public static class MustNotBeSubstringOfExtensions { public static string OldMustNotBeSubstringOf(this string parameter, string text, IgnoreCaseInfo ignoreCase = default, string parameterName = null, string message = null, Func exception = null) { parameter.MustNotBeNullOrEmpty(parameter); text.MustNotBeNullOrEmpty(nameof(text)); if (text.IsContaining(parameter, ignoreCase) == false) return parameter; throw exception?.Invoke() ?? new StringException(message ?? $"\"{parameter}\" must not be a substring of \"{text}\", but it is.", parameterName); } } }MustNotContainBenchmark.cs000066400000000000000000000031271470750352700343320ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/StringAssertionsusing System; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses.Performance.StringAssertions { public class MustNotContainBenchmark { public string Substring = "reality"; public string Text = "If you can’t tell the difference, does it matter if I'm real or not?"; [Benchmark(Baseline = true)] public string Imperative() { if (Text.Contains(Substring)) throw new SubstringException(nameof(Text), $"Text contains \"{Substring}\"."); return Text; } [Benchmark] public string LightGuardClauses() => Text.MustNotContain(Substring, nameof(Text)); [Benchmark] public string LightGuardClausesCustomException() => Text.MustNotContain(Substring, (x, y) => new Exception($"{x} contains {y}")); [Benchmark] public string OldVersion() => Text.OldMustNotContain(Substring, parameterName: nameof(Text)); } public static class MustNotContainExtensions { public static string OldMustNotContain(this string parameter, string text, IgnoreCaseInfo ignoreCase = default, string parameterName = null, string message = null, Func exception = null) { parameter.MustNotBeNull(parameterName); text.MustNotBeNull(nameof(text)); if (parameter.IsContaining(text, ignoreCase) == false) return parameter; throw exception?.Invoke() ?? new StringException(message ?? $"\"{parameter}\" must not contain \"{text}\", but it does.", parameterName); } } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/UriAssertions/000077500000000000000000000000001470750352700266105ustar00rootroot00000000000000MustBeAbsoluteUriBenchmark.cs000066400000000000000000000027551470750352700342620ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/UriAssertionsusing System; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses.Performance.UriAssertions { public class MustBeAbsoluteUriBenchmark { public Uri AbsoluteUri = new Uri("https://www.microsoft.com"); [Benchmark(Baseline = true)] public Uri ImperativeUri() { if (AbsoluteUri == null) throw new ArgumentNullException(nameof(AbsoluteUri)); if (AbsoluteUri.IsAbsoluteUri == false) throw new RelativeUriException(nameof(AbsoluteUri)); return AbsoluteUri; } [Benchmark] public Uri LightGuardClauses() => AbsoluteUri.MustBeAbsoluteUri(nameof(AbsoluteUri)); [Benchmark] public Uri LightGuardClausesCustomException() => AbsoluteUri.MustBeAbsoluteUri(uri => new Exception($"This uri {uri} is wrong")); [Benchmark] public Uri OldVersion() => AbsoluteUri.OldMustBeAbsoluteUri(nameof(AbsoluteUri)); } public static class MustBeAbsoluteUriExtensionMethods { public static Uri OldMustBeAbsoluteUri(this Uri uri, string parameterName = null, string message = null, Func exception = null) { uri.MustNotBeNull(parameterName); if (uri.IsAbsoluteUri) return uri; throw exception != null ? exception() : new ArgumentException(message ?? $"{parameterName ?? "The URI"} must be an absolute URI, but you specified \"{uri}\".", parameterName); } } }MustBeHttpOrHttpsUrlBenchmark.cs000066400000000000000000000025451470750352700347470ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/UriAssertionsusing System; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses.Performance.UriAssertions { public class MustBeHttpOrHttpsUrlBenchmark { public Uri Uri = new Uri("https://www.microsoft.com"); [Benchmark(Baseline = true)] public Uri ImperativeVersion() { if (Uri == null) throw new ArgumentNullException(nameof(Uri)); if (!Uri.IsAbsoluteUri) throw new RelativeUriException(nameof(Uri)); if (!Uri.Scheme.Equals("https") && !Uri.Scheme.Equals("http")) throw new InvalidUriSchemeException(nameof(Uri)); return Uri; } [Benchmark] public Uri LightGuardClauses() => Uri.MustBeHttpOrHttpsUrl(nameof(Uri)); [Benchmark] public Uri LightGuardClausesCustomException() => Uri.MustBeHttpOrHttpsUrl(uri => new Exception("Why don't you use HTTP services?")); [Benchmark] public Uri OldVersion() => Uri.OldMustBeHttpOrHttpsUrl(nameof(Uri)); } public static class MustBeHttpOrHttpsUrlExtensions { public static Uri OldMustBeHttpOrHttpsUrl(this Uri uri, string parameterName = null, string message = null, Func exception = null) { return uri.OldMustHaveOneSchemeOf(new[] { "http", "https" }, parameterName, message, exception); } } }MustBeRelativeUriBenchmark.cs000066400000000000000000000015411470750352700342470ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/UriAssertionsusing System; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses.Performance.UriAssertions { public class MustBeRelativeUriBenchmark { public Uri RelativeUri = new Uri("/api/login", UriKind.Relative); [Benchmark(Baseline = true)] public Uri ImperativeVersion() { if (RelativeUri == null) throw new ArgumentNullException(nameof(RelativeUri)); if (RelativeUri.IsAbsoluteUri) throw new AbsoluteUriException(nameof(RelativeUri)); return RelativeUri; } [Benchmark] public Uri LightGuardClauses() => RelativeUri.MustBeRelativeUri(nameof(RelativeUri)); [Benchmark] public Uri LightGuardClausesCustomException() => RelativeUri.MustBeRelativeUri(_ => new Exception("The URI is not relative")); } }MustHaveOneSchemeOfBenchmark.cs000066400000000000000000000052211470750352700345030ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/UriAssertionsusing System; using System.Collections.Generic; using System.Text; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; using Light.GuardClauses.FrameworkExtensions; namespace Light.GuardClauses.Performance.UriAssertions { public class MustHaveOneSchemeOfBenchmark { public List Schemes = new List { "http", "https" }; public Uri Uri = new Uri("https://www.microsoft.com"); [Benchmark(Baseline = true)] public Uri ImperativeVersion() { if (Uri == null) throw new ArgumentNullException(nameof(Uri)); if (!Uri.IsAbsoluteUri) throw new RelativeUriException(nameof(Uri)); if (!Schemes.Contains(Uri.Scheme)) throw new InvalidUriSchemeException(nameof(Uri)); return Uri; } [Benchmark] public Uri LightGuardClauses() => Uri.MustHaveOneSchemeOf(Schemes, nameof(Uri)); [Benchmark] public Uri LightGuardClausesCustomException() => Uri.MustHaveOneSchemeOf(Schemes, (u, s) => new Exception("Where is the scheme?")); [Benchmark] public Uri OldVersion() => Uri.OldMustHaveOneSchemeOf(Schemes, nameof(Uri)); } public static class MustHaveOneSchemeOfExtensionMethods { public static Uri OldMustHaveOneSchemeOf(this Uri uri, IEnumerable schemes, string parameterName = null, string message = null, Func exception = null) { uri.MustNotBeNull(parameterName); var schemesCollection = schemes.MustNotBeNullOrEmpty(nameof(schemes), "Your precondition is set up wrongly: schemes is null or an empty collection.").AsReadOnlyList(); if (uri.IsAbsoluteUri == false) goto ThrowException; for (var i = 0; i < schemesCollection.Count; i++) if (string.Equals(schemesCollection[i], uri.Scheme, StringComparison.OrdinalIgnoreCase)) return uri; ThrowException: var subclause = uri.IsAbsoluteUri ? $"but actually has scheme \"{uri.Scheme}\" (\"{uri}\")." : $"but it has none because it is a relative URI (\"{uri}\")."; throw exception != null ? exception() : new ArgumentException(message ?? new StringBuilder().Append($"{parameterName ?? "The URI"} must have one of the following schemes:") .AppendItemsWithNewLine(schemesCollection) .Append(subclause) .ToString()); } } }MustHaveSchemeBenchmark.cs000066400000000000000000000034551470750352700335630ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Performance/UriAssertionsusing System; using BenchmarkDotNet.Attributes; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses.Performance.UriAssertions { public class MustHaveSchemeBenchmarks { public Uri HttpsUrl = new Uri("https://ravendb.net"); [Benchmark(Baseline = true)] public Uri ImperativeVersion() { if (HttpsUrl == null) throw new ArgumentNullException(nameof(HttpsUrl)); if (HttpsUrl.IsAbsoluteUri == false) throw new RelativeUriException(nameof(HttpsUrl)); if ("https".Equals(HttpsUrl.Scheme) == false) throw new InvalidUriSchemeException(nameof(HttpsUrl)); return HttpsUrl; } [Benchmark] public Uri LightGuardClauses() => HttpsUrl.MustHaveScheme("https", nameof(HttpsUrl)); [Benchmark] public Uri CustomException() => HttpsUrl.MustHaveScheme("https", (uri, scheme) => new Exception($"The {uri} does not use {scheme}")); [Benchmark] public Uri OldVersion() => HttpsUrl.OldMustHaveScheme("https", nameof(HttpsUrl)); } public static class MustHaveSchemeExtensionMethods { public static Uri OldMustHaveScheme(this Uri uri, string scheme, string parameterName = null, string message = null, Func exception = null) { uri.MustNotBeNull(parameterName); if (uri.IsAbsoluteUri && string.Equals(uri.Scheme, scheme, StringComparison.OrdinalIgnoreCase)) return uri; var subclause = uri.IsAbsoluteUri ? $"but actually has scheme \"{uri.Scheme}\" (\"{uri}\")." : $"but it has none because it is a relative URI (\"{uri}\")."; throw exception != null ? exception() : new ArgumentException(message ?? $"{parameterName ?? "The URI"} must have scheme \"{scheme}\", {subclause}"); } } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Source/000077500000000000000000000000001470750352700227755ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Source/Light.GuardClauses.Source.csproj000066400000000000000000000011271470750352700311070ustar00rootroot00000000000000 netstandard2.0 12.0 Kenny Pflug Kenny Pflug Copyright © Kenny Pflug 2016 - 2023 true Light.GuardClauses-12.0.0/Code/Light.GuardClauses.SourceCodeTransformation.Tests/000077500000000000000000000000001470750352700276205ustar00rootroot00000000000000Light.GuardClauses.SourceCodeTransformation.Tests.csproj000066400000000000000000000011351470750352700424750ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.SourceCodeTransformation.Tests net6.0 false ParseCSharpFilesWithRoslynTests.cs000066400000000000000000000040141470750352700363130ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.SourceCodeTransformation.Testsusing System; using System.IO; using FluentAssertions; using Microsoft.CodeAnalysis.CSharp; using Microsoft.CodeAnalysis.CSharp.Syntax; using Xunit; namespace Light.GuardClauses.SourceCodeTransformation.Tests { public static class ParseCSharpWithRoslynTests { private static readonly DirectoryInfo CodeDirectory; static ParseCSharpWithRoslynTests() { CodeDirectory = FindCodeDirectory(); } [Fact] public static void ParseExpressionExtensionsFile() { var fileInfo = GetLightGuardClausesFile(@"FrameworkExtensions\ExpressionExtensions.cs"); var syntaxTree = CSharpSyntaxTree.ParseText(File.ReadAllText(fileInfo.FullName)); var root = (CompilationUnitSyntax) syntaxTree.GetRoot(); root.Members.Should().NotBeEmpty(); } [Fact] public static void ParseSpanDelegatesFile() { var fileInfo = GetLightGuardClausesFile("SpanDelegates.cs"); var syntaxTree = CSharpSyntaxTree.ParseText(File.ReadAllText(fileInfo.FullName), new CSharpParseOptions(LanguageVersion.CSharp7_3, preprocessorSymbols: new[] { "NETSTANDARD2_0" })); var root = (CompilationUnitSyntax) syntaxTree.GetRoot(); root.Members.Should().NotBeEmpty(); } private static DirectoryInfo FindCodeDirectory() { var currentDirectory = new DirectoryInfo("."); do { if (currentDirectory.Name == "Code") return currentDirectory; currentDirectory = currentDirectory.Parent; } while (currentDirectory != null); throw new InvalidOperationException("This test project does not reside in a folder called \"Code\" (directly or indirectly)."); } private static FileInfo GetLightGuardClausesFile(string relativeFilePath) { return new FileInfo(Path.Combine(CodeDirectory.FullName, "Light.GuardClauses", relativeFilePath)); } } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.SourceCodeTransformation/000077500000000000000000000000001470750352700265175ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.SourceCodeTransformation/ArrayTextSink.cs000066400000000000000000000011271470750352700316170ustar00rootroot00000000000000using System; namespace Light.GuardClauses.SourceCodeTransformation; internal struct ArrayTextSink { private readonly char[] _internalArray; private int _currentIndex; public ArrayTextSink(char[] internalArray) { _internalArray = internalArray.MustNotBeNull(nameof(internalArray)); _currentIndex = 0; } public void Append(ReadOnlySpan text) { for (var i = 0; i < text.Length; ++i) _internalArray[_currentIndex++] = text[i]; } public Memory ToMemory() => new Memory(_internalArray, 0, _currentIndex); }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.SourceCodeTransformation/CleanupStep.cs000066400000000000000000000102601470750352700312700ustar00rootroot00000000000000using System; namespace Light.GuardClauses.SourceCodeTransformation; public static class CleanupStep { public static Memory Cleanup(string sourceCode, SourceFileMergeOptions options) { if (options.RemoveCallerArgumentExpressions) sourceCode = sourceCode.Replace("[CallerArgumentExpression(\"parameter\")] ", string.Empty); if (options.RemoveValidatedNotNull) sourceCode = sourceCode.Replace("[ValidatedNotNull] ", string.Empty); if (options.RemoveNotNullWhen) { sourceCode = sourceCode.Replace("[NotNullWhen(true)] ", string.Empty); sourceCode = sourceCode.Replace("[NotNullWhen(false)] ", string.Empty); } var sink = new ArrayTextSink(new char[sourceCode.Length]); var parser = new LineOfCodeParser(sourceCode); LineOfCode previousLineOfCode = default; while (parser.TryGetNext(out var currentLineOfCode)) { var isEmptyLineAfterXmlComment = previousLineOfCode.Type == LineOfCodeType.XmlComment && currentLineOfCode.Type == LineOfCodeType.WhiteSpace; var isContractAnnotationThatShouldBeRemoved = options.RemoveContractAnnotations && currentLineOfCode.Type == LineOfCodeType.ContractAnnotation; var isDoesNotReturnThatShouldBeRemoved = options.RemoveDoesNotReturn && currentLineOfCode.Type == LineOfCodeType.DoesNotReturnAnnotation; if (isEmptyLineAfterXmlComment) { // Break point parking spot } if (!isEmptyLineAfterXmlComment && !isContractAnnotationThatShouldBeRemoved && !isDoesNotReturnThatShouldBeRemoved) sink.Append(currentLineOfCode.Span); previousLineOfCode = currentLineOfCode; } return sink.ToMemory(); } private ref struct LineOfCodeParser { private readonly ReadOnlySpan _sourceCode; private int _currentIndex; public LineOfCodeParser(ReadOnlySpan sourceCode) { _sourceCode = sourceCode; _currentIndex = 0; } public bool TryGetNext(out LineOfCode lineOfCode) { if (!_sourceCode.TryGetNextLine(_currentIndex, out var currentLineSpan)) { lineOfCode = default; return false; } _currentIndex += currentLineSpan.Length; var leftTrimmedSpan = currentLineSpan.TrimStart(); if (leftTrimmedSpan.StartsWith("///")) lineOfCode = new LineOfCode(LineOfCodeType.XmlComment, currentLineSpan); else if (leftTrimmedSpan.StartsWith("[ContractAnnotation(")) lineOfCode = new LineOfCode(LineOfCodeType.ContractAnnotation, currentLineSpan); else if (leftTrimmedSpan.StartsWith("[DoesNotReturn]")) lineOfCode = new LineOfCode(LineOfCodeType.DoesNotReturnAnnotation, currentLineSpan); else if (leftTrimmedSpan.IsEmpty) lineOfCode = new LineOfCode(LineOfCodeType.WhiteSpace, currentLineSpan); else lineOfCode = new LineOfCode(LineOfCodeType.Other, currentLineSpan); return true; } } private readonly ref struct LineOfCode { public readonly LineOfCodeType Type; public readonly ReadOnlySpan Span; public LineOfCode(LineOfCodeType type, ReadOnlySpan span) { Type = type; Span = span; } public override string ToString() => Span.ToString(); } private enum LineOfCodeType { Other, XmlComment, WhiteSpace, ContractAnnotation, DoesNotReturnAnnotation } public static bool TryGetNextLine(this ReadOnlySpan text, int startIndex, out ReadOnlySpan nextLine) { if (startIndex >= text.Length) { nextLine = default; return false; } nextLine = text.Slice(startIndex); var newLineIndex = nextLine.IndexOf(Environment.NewLine); if (newLineIndex == -1) return true; nextLine = nextLine.Slice(0, newLineIndex + Environment.NewLine.Length); return true; } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.SourceCodeTransformation/Extensions.cs000066400000000000000000000003241470750352700312040ustar00rootroot00000000000000using System.IO; namespace Light.GuardClauses.SourceCodeTransformation; public static class Extensions { public static string ReadContent(this FileInfo fileInfo) => File.ReadAllText(fileInfo.FullName); }Light.GuardClauses.SourceCodeTransformation.csproj000066400000000000000000000017061470750352700402770ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.SourceCodeTransformation Exe net8.0 enable PreserveNewest Light.GuardClauses-12.0.0/Code/Light.GuardClauses.SourceCodeTransformation/Program.cs000066400000000000000000000017671470750352700304700ustar00rootroot00000000000000using System; using Microsoft.Extensions.Configuration; namespace Light.GuardClauses.SourceCodeTransformation; public static class Program { public static int Main(string[] args) { Console.WriteLine("Creating configuration..."); var configuration = new ConfigurationBuilder().AddJsonFile("settings.json", true) .AddCommandLine(args) .Build(); var options = new SourceFileMergeOptions(); configuration.Bind(options); try { Console.WriteLine("Merging source files..."); SourceFileMerger.CreateSingleSourceFile(options); Console.WriteLine("Source file export completed successfully."); return 0; } catch (Exception ex) { Console.WriteLine("Exception occurred during source file export:"); Console.WriteLine(ex); return -1; } } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.SourceCodeTransformation/SourceFileMergeOptions.cs000066400000000000000000000035061470750352700334460ustar00rootroot00000000000000using System.IO; namespace Light.GuardClauses.SourceCodeTransformation; public sealed record SourceFileMergeOptions { public SourceFileMergeOptions() { try { var currentDirectory = new DirectoryInfo("."); while (currentDirectory != null && currentDirectory.Name != "Code") currentDirectory = currentDirectory.Parent; if (currentDirectory == null) return; TargetFile = Path.Combine(currentDirectory.FullName, "Light.GuardClauses.Source", "Light.GuardClauses.cs"); SourceFolder = Path.Combine(currentDirectory.FullName, "Light.GuardClauses"); } // ReSharper disable once EmptyGeneralCatchClause catch { } } public string SourceFolder { get; init; } = string.Empty; public string TargetFile { get; init; } = string.Empty; public bool ChangePublicTypesToInternalTypes { get; init; } = true; public string BaseNamespace { get; init; } = "Light.GuardClauses"; public bool RemoveContractAnnotations { get; init; } = false; public bool IncludeJetBrainsAnnotations { get; init; } = true; public bool IncludeJetBrainsAnnotationsUsing { get; init; } = true; public bool IncludeVersionComment { get; init; } = true; public bool RemoveOverloadsWithExceptionFactory { get; init; } = false; public bool IncludeCodeAnalysisNullableAttributes { get; init; } = true; public bool IncludeValidatedNotNullAttribute { get; init; } = true; public bool RemoveValidatedNotNull { get; init; } = false; public bool RemoveDoesNotReturn { get; init; } = false; public bool RemoveNotNullWhen { get; init; } = false; public bool IncludeCallerArgumentExpressionAttribute { get; init; } = true; public bool RemoveCallerArgumentExpressions { get; init; } = false; }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.SourceCodeTransformation/SourceFileMerger.cs000066400000000000000000000600021470750352700322460ustar00rootroot00000000000000using System; using System.Collections.Generic; using System.IO; using System.Linq; using System.Text; using Light.GuardClauses.FrameworkExtensions; using Microsoft.CodeAnalysis; using Microsoft.CodeAnalysis.CSharp; using Microsoft.CodeAnalysis.CSharp.Syntax; using static Microsoft.CodeAnalysis.CSharp.SyntaxFactory; namespace Light.GuardClauses.SourceCodeTransformation; public static class SourceFileMerger { public static void CreateSingleSourceFile(SourceFileMergeOptions options) { options.MustNotBeNull(nameof(options)); // Prepare the target syntax var stringBuilder = new StringBuilder(); if (options.IncludeVersionComment) { Console.WriteLine("Appending version header..."); stringBuilder.AppendLine("/* ------------------------------") .AppendLine($" Light.GuardClauses {typeof(SourceFileMerger).Assembly.GetName().Version!.ToString(3)}") .AppendLine(" ------------------------------") .AppendLine(); } Console.WriteLine("Creating default file layout..."); stringBuilder.AppendLineIf(!options.IncludeVersionComment, "/*") .AppendLine($@"License information for Light.GuardClauses The MIT License (MIT) Copyright (c) 2016, 2024 Kenny Pflug mailto:kenny.pflug@live.de Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the ""Software""), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and / or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED ""AS IS"", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ using System; using System.Collections; using System.Collections.Generic; using System.Collections.ObjectModel; using System.Diagnostics.CodeAnalysis; using System.Linq; using System.Linq.Expressions; using System.Reflection; using System.Runtime.CompilerServices; using System.Runtime.Serialization; using System.Text; using System.Text.RegularExpressions; {(options.IncludeJetBrainsAnnotationsUsing ? "using JetBrains.Annotations;" + Environment.NewLine : string.Empty)}using {options.BaseNamespace}.Exceptions; using {options.BaseNamespace}.FrameworkExtensions; {(options.IncludeJetBrainsAnnotationsUsing ? "using NotNullAttribute = System.Diagnostics.CodeAnalysis.NotNullAttribute;" : "")} #nullable enable annotations namespace {options.BaseNamespace} {{ }} namespace {options.BaseNamespace}.Exceptions {{ }} namespace {options.BaseNamespace}.FrameworkExtensions {{ }}"); if (options.IncludeJetBrainsAnnotations) { stringBuilder.AppendLine().AppendLine(@"/* License information for JetBrains.Annotations MIT License Copyright (c) 2016 JetBrains http://www.jetbrains.com Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the ""Software""), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and / or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED ""AS IS"", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ namespace JetBrains.Annotations { }"); } if (options.IncludeCodeAnalysisNullableAttributes) { stringBuilder.AppendLine().AppendLine(@" namespace System.Diagnostics.CodeAnalysis { /// /// Specifies that is allowed as an input even if the /// corresponding type disallows it. /// [AttributeUsage(AttributeTargets.Field | AttributeTargets.Parameter | AttributeTargets.Property, Inherited = false)] internal sealed class AllowNullAttribute : Attribute { /// /// Initializes a new instance of the class. /// public AllowNullAttribute() { } } /// /// Specifies that is disallowed as an input even if the /// corresponding type allows it. /// [AttributeUsage(AttributeTargets.Field | AttributeTargets.Parameter | AttributeTargets.Property, Inherited = false)] internal sealed class DisallowNullAttribute : Attribute { /// /// Initializes a new instance of the class. /// public DisallowNullAttribute() { } } /// /// Specifies that a method that will never return under any circumstance. /// [AttributeUsage(AttributeTargets.Method, Inherited = false)] internal sealed class DoesNotReturnAttribute : Attribute { /// /// Initializes a new instance of the class. /// public DoesNotReturnAttribute() { } } /// /// Specifies that the method will not return if the associated /// parameter is passed the specified value. /// [AttributeUsage(AttributeTargets.Parameter, Inherited = false)] internal sealed class DoesNotReturnIfAttribute : Attribute { /// /// Gets the condition parameter value. /// Code after the method is considered unreachable by diagnostics if the argument /// to the associated parameter matches this value. /// public bool ParameterValue { get; } /// /// Initializes a new instance of the /// class with the specified parameter value. /// /// /// The condition parameter value. /// Code after the method is considered unreachable by diagnostics if the argument /// to the associated parameter matches this value. /// public DoesNotReturnIfAttribute(bool parameterValue) { ParameterValue = parameterValue; } } /// /// Specifies that an output may be even if the /// corresponding type disallows it. /// [AttributeUsage(AttributeTargets.Field | AttributeTargets.Parameter | AttributeTargets.Property | AttributeTargets.ReturnValue, Inherited = false)] internal sealed class MaybeNullAttribute : Attribute { /// /// Initializes a new instance of the class. /// public MaybeNullAttribute() { } } /// /// Specifies that when a method returns , /// the parameter may be even if the corresponding type disallows it. /// [AttributeUsage(AttributeTargets.Parameter, Inherited = false)] internal sealed class MaybeNullWhenAttribute : Attribute { /// /// Gets the return value condition. /// If the method returns this value, the associated parameter may be . /// public bool ReturnValue { get; } /// /// Initializes the attribute with the specified return value condition. /// /// /// The return value condition. /// If the method returns this value, the associated parameter may be . /// public MaybeNullWhenAttribute(bool returnValue) { ReturnValue = returnValue; } } /// /// Specifies that an output is not even if the /// corresponding type allows it. /// [AttributeUsage(AttributeTargets.Field | AttributeTargets.Parameter | AttributeTargets.Property | AttributeTargets.ReturnValue, Inherited = false)] internal sealed class NotNullAttribute : Attribute { /// /// Initializes a new instance of the class. /// public NotNullAttribute() { } } /// /// Specifies that the output will be non- if the /// named parameter is non-. /// [AttributeUsage(AttributeTargets.Parameter | AttributeTargets.Property | AttributeTargets.ReturnValue, AllowMultiple = true, Inherited = false)] internal sealed class NotNullIfNotNullAttribute : Attribute { /// /// Gets the associated parameter name. /// The output will be non- if the argument to the /// parameter specified is non-. /// public string ParameterName { get; } /// /// Initializes the attribute with the associated parameter name. /// /// /// The associated parameter name. /// The output will be non- if the argument to the /// parameter specified is non-. /// public NotNullIfNotNullAttribute(string parameterName) { ParameterName = parameterName; } } /// /// Specifies that when a method returns , /// the parameter will not be even if the corresponding type allows it. /// [AttributeUsage(AttributeTargets.Parameter, Inherited = false)] internal sealed class NotNullWhenAttribute : Attribute { /// /// Gets the return value condition. /// If the method returns this value, the associated parameter will not be . /// public bool ReturnValue { get; } /// /// Initializes the attribute with the specified return value condition. /// /// /// The return value condition. /// If the method returns this value, the associated parameter will not be . /// public NotNullWhenAttribute(bool returnValue) { ReturnValue = returnValue; } } }"); } if (options.IncludeCallerArgumentExpressionAttribute) { stringBuilder.AppendLine().AppendLine(@" namespace System.Runtime.CompilerServices { [AttributeUsage(AttributeTargets.Parameter, AllowMultiple = false, Inherited = false)] internal sealed class CallerArgumentExpressionAttribute : Attribute { public CallerArgumentExpressionAttribute(string parameterName) { ParameterName = parameterName; } public string ParameterName { get; } } }"); } var csharpParseOptions = new CSharpParseOptions(LanguageVersion.CSharp10); var targetSyntaxTree = CSharpSyntaxTree.ParseText(stringBuilder.ToString(), csharpParseOptions); var targetRoot = (CompilationUnitSyntax) targetSyntaxTree.GetRoot(); var namespaces = targetRoot.Members .OfType() .ToList(); var defaultNamespace = namespaces.First(@namespace => @namespace.Name.ToString() == $"{options.BaseNamespace}"); var exceptionsNamespace = namespaces.First(@namespace => @namespace.Name.ToString() == $"{options.BaseNamespace}.Exceptions"); var extensionsNamespace = namespaces.First(@namespace => @namespace.Name.ToString() == $"{options.BaseNamespace}.FrameworkExtensions"); var jetBrainsNamespace = namespaces.FirstOrDefault(@namespace => @namespace.Name.ToString() == "JetBrains.Annotations"); var replacedNodes = new Dictionary { [defaultNamespace] = defaultNamespace, [exceptionsNamespace] = exceptionsNamespace, [extensionsNamespace] = extensionsNamespace }; if (options.IncludeJetBrainsAnnotations && jetBrainsNamespace != null) replacedNodes.Add(jetBrainsNamespace, jetBrainsNamespace); var allSourceFiles = new DirectoryInfo(options.SourceFolder).GetFiles("*.cs", SearchOption.AllDirectories) .Where(f => !f.FullName.Contains("obj") && !f.FullName.Contains("bin")) .ToDictionary(f => f.Name); // Start with Check.CommonAssertions before all other files to prepare the Check class Console.WriteLine("Merging CommonAssertions of the Check class..."); var currentFile = allSourceFiles["Check.CommonAssertions.cs"]; var sourceSyntaxTree = CSharpSyntaxTree.ParseText(currentFile.ReadContent(), csharpParseOptions); var checkClassDeclaration = (ClassDeclarationSyntax) sourceSyntaxTree.GetRoot() .DescendantNodes() .First(node => node.IsKind(SyntaxKind.ClassDeclaration)); checkClassDeclaration = checkClassDeclaration.WithModifiers(checkClassDeclaration.Modifiers.Remove(checkClassDeclaration.Modifiers.First(token => token.IsKind(SyntaxKind.PartialKeyword)))); // Process all other files Console.WriteLine("Merging remaining files..."); foreach (var fileName in allSourceFiles.Keys) { if (!CheckIfFileShouldBeProcessed(options, fileName)) continue; currentFile = allSourceFiles[fileName]; sourceSyntaxTree = CSharpSyntaxTree.ParseText(currentFile.ReadContent(), csharpParseOptions); var originalNamespace = DetermineOriginalNamespace(options, defaultNamespace, currentFile, extensionsNamespace, exceptionsNamespace, jetBrainsNamespace); // If the file contains assertions, add it to the existing Check class declaration if (originalNamespace == defaultNamespace && currentFile.Name.StartsWith("Check.")) { var classDeclaration = (ClassDeclarationSyntax) sourceSyntaxTree.GetRoot() .DescendantNodes() .First(node => node.IsKind(SyntaxKind.ClassDeclaration)); checkClassDeclaration = checkClassDeclaration.WithMembers(checkClassDeclaration.Members.AddRange(classDeclaration.Members)); continue; } // Else just get the members of the first namespace and add them to the corresponding one var sourceCompilationUnit = (CompilationUnitSyntax) sourceSyntaxTree.GetRoot(); if (sourceCompilationUnit.Members.IsNullOrEmpty()) continue; var membersToAdd = ((FileScopedNamespaceDeclarationSyntax) sourceCompilationUnit.Members[0]).Members; var currentlyEditedNamespace = replacedNodes[originalNamespace]; replacedNodes[originalNamespace] = currentlyEditedNamespace .WithMembers( currentlyEditedNamespace.Members.AddRange(membersToAdd)); } // After the Check class declaration is finished, insert it into the default namespace var currentDefaultNamespace = replacedNodes[defaultNamespace]; replacedNodes[defaultNamespace] = currentDefaultNamespace.WithMembers(currentDefaultNamespace.Members.Insert(0, checkClassDeclaration)); // Update the target compilation unit targetRoot = targetRoot.ReplaceNodes(replacedNodes.Keys, (originalNode, _) => replacedNodes[originalNode]).NormalizeWhitespace(); // Make types internal if necessary if (options.ChangePublicTypesToInternalTypes) { Console.WriteLine("Types are changed from public to internal..."); var changedTypeDeclarations = new Dictionary(); foreach (var typeDeclaration in targetRoot.DescendantNodes().Where(node => node.IsKind(SyntaxKind.ClassDeclaration) || node.IsKind(SyntaxKind.StructDeclaration) || node.IsKind(SyntaxKind.EnumDeclaration) || node.IsKind(SyntaxKind.DelegateDeclaration))) { if (typeDeclaration is BaseTypeDeclarationSyntax typeDeclarationSyntax) { var publicModifier = typeDeclarationSyntax.Modifiers[0]; var adjustedModifiers = typeDeclarationSyntax.Modifiers .RemoveAt(0) .Insert(0, Token(SyntaxKind.InternalKeyword).WithTriviaFrom(publicModifier)); if (typeDeclarationSyntax is ClassDeclarationSyntax classDeclaration) changedTypeDeclarations[classDeclaration] = classDeclaration.WithModifiers(adjustedModifiers); else if (typeDeclarationSyntax is StructDeclarationSyntax structDeclaration) changedTypeDeclarations[structDeclaration] = structDeclaration.WithModifiers(adjustedModifiers); else if (typeDeclarationSyntax is EnumDeclarationSyntax enumDeclaration) changedTypeDeclarations[enumDeclaration] = enumDeclaration.WithModifiers(adjustedModifiers); } else if (typeDeclaration is DelegateDeclarationSyntax delegateDeclaration) { var publicModifier = delegateDeclaration.Modifiers[0]; var adjustedModifiers = delegateDeclaration.Modifiers .RemoveAt(0) .Insert(0, Token(SyntaxKind.InternalKeyword).WithTriviaFrom(publicModifier)); changedTypeDeclarations[delegateDeclaration] = delegateDeclaration.WithModifiers(adjustedModifiers); } } targetRoot = targetRoot.ReplaceNodes(changedTypeDeclarations.Keys, (originalNode, _) => changedTypeDeclarations[originalNode]); } // Remove assertion overloads that incorporate an exception factory if necessary if (options.RemoveOverloadsWithExceptionFactory) { Console.WriteLine("Removing overloads with exception factory..."); var checkClass = (ClassDeclarationSyntax) targetRoot.DescendantNodes() .First(node => node.IsKind(SyntaxKind.ClassDeclaration) && node is ClassDeclarationSyntax { Identifier.Text: "Check" }); var membersWithoutExceptionFactory = checkClass.Members .Where(member => member is not MethodDeclarationSyntax method || method.ParameterList.Parameters.All(parameter => parameter.Identifier.Text != "exceptionFactory")); targetRoot = targetRoot.ReplaceNode(checkClass, checkClass.WithMembers(new SyntaxList(membersWithoutExceptionFactory))); // Remove members from Throw class that use exception factories var throwClass = (ClassDeclarationSyntax) targetRoot.DescendantNodes() .First(node => node.IsKind(SyntaxKind.ClassDeclaration) && node is ClassDeclarationSyntax { Identifier.Text: "Throw" }); membersWithoutExceptionFactory = throwClass.Members .Where(member => member is not MethodDeclarationSyntax method || method.ParameterList.Parameters.All(parameter => parameter.Identifier.Text != "exceptionFactory")); targetRoot = targetRoot.ReplaceNode(throwClass, throwClass.WithMembers(new SyntaxList(membersWithoutExceptionFactory))); } var targetFileContent = targetRoot.ToFullString(); Console.WriteLine("File is cleaned up..."); targetFileContent = CleanupStep.Cleanup(targetFileContent, options).ToString(); // Write the target file Console.WriteLine("File is written to disk..."); File.WriteAllText(options.TargetFile, targetFileContent); } private static bool CheckIfFileShouldBeProcessed(SourceFileMergeOptions options, string fileName) => fileName != "Check.CommonAssertions.cs" && fileName != "CallerArgumentExpressionAttribute.cs" && (fileName != "ReSharperAnnotations.cs" || options.IncludeJetBrainsAnnotations) && (fileName != "ValidatedNotNullAttribute.cs" || options.IncludeValidatedNotNullAttribute); private static NamespaceDeclarationSyntax DetermineOriginalNamespace(SourceFileMergeOptions options, NamespaceDeclarationSyntax defaultNamespace, FileInfo currentFile, NamespaceDeclarationSyntax extensionsNamespace, NamespaceDeclarationSyntax exceptionsNamespace, NamespaceDeclarationSyntax? jetBrainsNamespace) { var originalNamespace = defaultNamespace; switch (currentFile.Directory?.Name) { case "FrameworkExtensions": originalNamespace = extensionsNamespace; break; case "Exceptions": originalNamespace = exceptionsNamespace; break; default: { if (options.IncludeJetBrainsAnnotations && currentFile.Name == "ReSharperAnnotations.cs") originalNamespace = jetBrainsNamespace!; break; } } return originalNamespace; } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/000077500000000000000000000000001470750352700226375ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CollectionAssertions/000077500000000000000000000000001470750352700270055ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CollectionAssertions/IsNullOrEmptyTests.cs000066400000000000000000000016311470750352700331060ustar00rootroot00000000000000using System; using System.Collections.Generic; using FluentAssertions; using Xunit; namespace Light.GuardClauses.Tests.CollectionAssertions; public static class IsNullOrEmptyTests { [Fact] public static void CollectionNull() { var collection = (IEnumerable) null; // ReSharper disable once ConditionIsAlwaysTrueOrFalse var result = collection.IsNullOrEmpty(); // ReSharper disable once ConditionIsAlwaysTrueOrFalse result.Should().BeTrue(); } [Fact] public static void CollectionEmpty() { var emptyCollection = Array.Empty(); var result = emptyCollection.IsNullOrEmpty(); result.Should().BeTrue(); } [Fact] public static void CollectionNotEmpty() { var collection = new[] { "Foo", "Bar" }; var result = collection.IsNullOrEmpty(); result.Should().BeFalse(); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CollectionAssertions/MustBeOneOfTests.cs000066400000000000000000000051551470750352700325130ustar00rootroot00000000000000using System; using System.Linq; using System.Text; using FluentAssertions; using Light.GuardClauses.Exceptions; using Light.GuardClauses.FrameworkExtensions; using Xunit; namespace Light.GuardClauses.Tests.CollectionAssertions; public static class MustBeOneOfTests { [Theory] [InlineData(42, new[] { 1, 2, 3 })] [InlineData(-1523, new int[] { })] [InlineData(100153, new[] { 2 })] public static void NotOneOf(int item, int[] items) { Action act = () => item.MustBeOneOf(items, nameof(item)); var assertion = act.Should().Throw().Which; assertion.Message.Should().Contain(new StringBuilder().AppendLine($"{nameof(item)} must be one of the following items") .AppendItemsWithNewLine(items) .AppendLine($"but it actually is {item.ToStringOrNull()}.") .ToString()); assertion.ParamName.Should().BeSameAs(nameof(item)); } [Theory] [InlineData("Foo", new[] { "Foo", "Bar" })] [InlineData("Qux", new[] { "Baz", "Qux", "Quux" })] [InlineData(null, new[] { "Foo", "Bar", null })] public static void OneOf(string item, string[] items) => item.MustBeOneOf(items).Should().BeSameAs(item); [Fact] public static void ItemsNull() { Action act = () => "Foo".MustBeOneOf(null!); act.Should().Throw(); } [Theory] [InlineData(42, new[] { 1, 2, 3 })] [InlineData(87, null)] public static void CustomException(int item, int[] collection) => Test.CustomException(item, collection, (i, items, exceptionFactory) => i.MustBeOneOf(items, exceptionFactory)); [Fact] public static void NoCustomExceptionThrown() => 42.MustBeOneOf(new[] { 42, 43 }, (_, _) => new Exception()).Should().Be(42); [Fact] public static void CustomMessage() => Test.CustomMessage(message => 42.MustBeOneOf(new[] { 1, 2 }, message: message)); [Fact] public static void CustomMessageCollectionNull() => Test.CustomMessage(message => long.MaxValue.MustBeOneOf(null!, message: message)); [Fact] public static void CallerArgumentExpression() { const int myNumber = 50; Action act = () => myNumber.MustBeOneOf(Enumerable.Range(1, 10)); act.Should().Throw() .WithParameterName(nameof(myNumber)); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CollectionAssertions/MustContainTests.cs000066400000000000000000000046201470750352700326250ustar00rootroot00000000000000using System; using System.Collections.Generic; using System.Collections.ObjectModel; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.CollectionAssertions; public static class MustContainTests { [Theory] [InlineData(new[] { 1, 2, 3 }, 5)] [InlineData(new[] { -5491, 6199 }, 42)] public static void ItemNotPartOf(int[] collection, int item) { Action act = () => collection.MustContain(item, nameof(collection)); var assertion = act.Should().Throw().Which; assertion.Message.Should().Contain($"{nameof(collection)} must contain {item}, but it actually does not."); } [Theory] [InlineData(new[] { "Foo", "Bar" }, "Foo")] [InlineData(new[] { "Foo", "Bar", "Foo" }, "Foo")] [InlineData(new[] { "Qux" }, "Qux")] [InlineData(new[] { "Qux", null }, null)] public static void ItemPartOf(string[] collection, string item) => collection.MustContain(item).Should().BeSameAs(collection); [Fact] public static void CollectionNull() { Action act = () => ((string[]) null).MustContain("Foo"); act.Should().Throw(); } [Theory] [InlineData(new[] { long.MinValue, long.MaxValue }, 42L)] [InlineData(null, 42L)] public static void CustomException(long[] array, long item) => Test.CustomException(array, item, (collection, i, exceptionFactory) => collection.MustContain(i, exceptionFactory)); [Fact] public static void CustomExceptionNotThrown() { var collection = new List { 1, 2, 3 }; collection.MustContain(2, (_, _) => new Exception()).Should().BeSameAs(collection); } [Fact] public static void CustomMessage() => Test.CustomMessage(message => new List().MustContain("Foo", message: message)); [Fact] public static void CustomMessageCollectionNull() => Test.CustomMessage(message => ((ObservableCollection) null).MustContain("Foo", message: message)); [Fact] public static void CallerArgumentExpression() { var array = new [] { "Foo", "Bar" }; var act = () => array.MustContain("Baz"); act.Should().Throw() .WithParameterName(nameof(array)); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CollectionAssertions/MustHaveCountTests.cs000066400000000000000000000044131470750352700331260ustar00rootroot00000000000000using System; using System.Collections.Generic; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.CollectionAssertions; public static class MustHaveCountTests { [Fact] public static void CountDifferent() { var collection = new List { "Foo", "Bar", "Baz" }; Action act = () => collection.MustHaveCount(10, nameof(collection)); var assertion = act.Should().Throw().Which; assertion.Message.Should().Contain($"{nameof(collection)} must have count 10, but it actually has count {collection.Count}."); assertion.ParamName.Should().BeSameAs(nameof(collection)); } [Fact] public static void CountSame() { var collection = new[] { 1, 2, 3, 4 }; collection.MustHaveCount(4).Should().BeSameAs(collection); } [Fact] public static void CollectionNull() { Action act = () => ((int[]) null).MustHaveCount(1); act.Should().Throw(); } [Theory] [InlineData(new[] { true }, 42)] [InlineData(null, 3)] [InlineData(new[] { false }, -1)] public static void CustomException(bool[] collection, int count) => Test.CustomException(collection, count, (a, c, exceptionFactory) => a.MustHaveCount(c, exceptionFactory)); [Fact] public static void CustomExceptionNotThrown() { var collection = new List{1, -2, 3}; collection.MustHaveCount(3, (_, _) => new Exception()).Should().BeSameAs(collection); } [Fact] public static void CustomMessage() => Test.CustomMessage(message => new[] { 1 }.MustHaveCount(3, message: message)); [Fact] public static void CustomMessageCollectionNull() => Test.CustomMessage(message => ((List) null).MustHaveCount(42, message: message)); [Fact] public static void CallerArgumentExpression() { var collection = new List { 1, 2, 3 }; Action act = () => collection.MustHaveCount(5); act.Should().Throw() .WithParameterName(nameof(collection)); } }MustHaveMaximumCountTests.cs000066400000000000000000000051461470750352700344110ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CollectionAssertionsusing System; using System.Collections.Generic; using System.Collections.ObjectModel; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.CollectionAssertions; public static class MustHaveMaximumCountTests { [Theory] [InlineData(new[] { 1, 2, 3, 4 }, 3)] [InlineData(new[] { 1, 2 }, 1)] [InlineData(new[] { 500 }, 0)] public static void MoreItems(int[] items, int count) { Action act = () => items.MustHaveMaximumCount(count, nameof(items)); var assertion = act.Should().Throw().Which; assertion.Message.Should().Contain($"{nameof(items)} must have at most count {count}, but it actually has count {items.Length}."); assertion.ParamName.Should().BeSameAs(nameof(items)); } [Theory] [InlineData(new[] { "Foo" }, 1)] [InlineData(new[] { "Bar" }, 2)] [InlineData(new[] { "Baz", "Qux", "Quux" }, 5)] public static void LessOrEqualItems(string[] items, int count) => items.MustHaveMaximumCount(count).Should().BeSameAs(items); [Fact] public static void CollectionNull() { Action act = () => ((ObservableCollection) null).MustHaveMaximumCount(42); act.Should().Throw(); } [Theory] [InlineData(new[] { 87, 89, 99 }, 1)] [InlineData(null, 5)] [InlineData(new[] { 1, 2, 3 }, -30)] public static void CustomException(int[] collection, int maximumCount) => Test.CustomException(collection, maximumCount, (c, count, exceptionFactory) => c.MustHaveMaximumCount(count, exceptionFactory)); [Fact] public static void NoCustomExceptionThrown() { var collection = new HashSet { "Foo", "Bar" }; collection.MustHaveMaximumCount(2, (_, _) => new Exception()).Should().BeSameAs(collection); } [Fact] public static void CustomMessage() => Test.CustomMessage(message => new List { 1, 2, 3 }.MustHaveMaximumCount(2, message: message)); [Fact] public static void CustomMessageCollectionNull() => Test.CustomMessage(message => ((ObservableCollection) null).MustHaveMaximumCount(3, message: message)); [Fact] public static void CallerArgumentExpression() { var myCollection = new List { 1, 2, 3 }; var act = () => myCollection.MustHaveMaximumCount(2); act.Should().Throw() .WithParameterName(nameof(myCollection)); } }MustHaveMinimumCountTests.cs000066400000000000000000000053561470750352700344120ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CollectionAssertionsusing System; using System.Collections; using System.Collections.Generic; using System.Collections.ObjectModel; using FluentAssertions; using Light.GuardClauses.Exceptions; using Light.GuardClauses.FrameworkExtensions; using Xunit; namespace Light.GuardClauses.Tests.CollectionAssertions; public static class MustHaveMinimumCountTests { [Theory] [InlineData(new[] { "Foo", "Bar" }, 4)] [InlineData(new[] { 1, 2, 3, 4 }, 40)] [InlineData(new bool[] { }, 1)] public static void LessItems(IEnumerable collection, int minimumCount) { Action act = () => collection.MustHaveMinimumCount(minimumCount, nameof(collection)); var assertion = act.Should().Throw().Which; assertion.Message.Should().Contain($"{nameof(collection)} must have at least count {minimumCount}, but it actually has count {collection.Count()}."); assertion.ParamName.Should().BeSameAs(nameof(collection)); } [Theory] [InlineData(new[] { "Foo", "Bar", "Baz" }, 3)] [InlineData(new[] { "Qux", "Quux", "Corge" }, 2)] [InlineData(new string[] { }, 0)] public static void EqualOrMoreItems(string[] collection, int minimumCount) => collection.MustHaveMinimumCount(minimumCount).Should().BeSameAs(collection); [Fact] public static void CollectionNull() { Action act = () => ((ISet)null).MustHaveMinimumCount(42); act.Should().Throw(); } [Theory] [InlineData(new[] { 1, 2, 3 }, 4)] [InlineData(null, 3)] public static void CustomException(int[] collection, int minimumCount) => Test.CustomException(collection, minimumCount, (c, minCount, exceptionFactory) => c.MustHaveMinimumCount(minCount, exceptionFactory)); [Fact] public static void NoCustomExceptionThrown() { var set = new HashSet { "Foo", "Bar", "Baz" }; set.MustHaveMinimumCount(2, (_, _) => new Exception()).Should().BeSameAs(set); } [Fact] public static void CustomMessage() => Test.CustomMessage(message => new ObservableCollection { true }.MustHaveMinimumCount(2, message: message)); [Fact] public static void CustomMessageCollectionNull() => Test.CustomMessage(message => ((ObservableCollection)null).MustHaveMinimumCount(42, message: message)); [Fact] public static void CallerArgumentExpression() { var myCollection = new List { 1, 2, 3 }; Action act = () => myCollection.MustHaveMinimumCount(5); act.Should().Throw() .WithParameterName(nameof(myCollection)); } }MustNotBeNullOrEmptyTests.cs000066400000000000000000000051661470750352700343430ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CollectionAssertionsusing System; using System.Collections.Generic; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.CollectionAssertions; public static class MustNotBeNullOrEmptyTests { [Fact] public static void CollectionNull() { // ReSharper disable once ExplicitCallerInfoArgument Action act = () => ((object[]) null).MustNotBeNullOrEmpty("Foo"); act.Should().Throw() .WithParameterName("Foo"); } [Fact] public static void CollectionEmpty() { var empty = new List(); Action act = () => empty.MustNotBeNullOrEmpty(nameof(empty)); var assertion = act.Should().Throw().Which; assertion.Message.Should().Contain($"{nameof(empty)} must not be an empty collection, but it actually is."); assertion.ParamName.Should().BeSameAs(nameof(empty)); } [Fact] public static void CollectionNotEmpty() { var collection = new HashSet { "Baz", "Qux", "Corge" }; collection.MustNotBeNullOrEmpty().Should().BeSameAs(collection); } [Theory] [InlineData(new int[] {})] [InlineData(null)] public static void CustomException(int[] collection) => Test.CustomException(collection, (_, exceptionFactory) => collection.MustNotBeNullOrEmpty(exceptionFactory)); [Fact] public static void NoCustomExceptionThrown() { var collection = new List{42}; collection.MustNotBeNullOrEmpty(_ => new Exception()).Should().BeSameAs(collection); } [Fact] public static void CustomMessage() => Test.CustomMessage(message => new HashSet().MustNotBeNullOrEmpty(message: message)); [Fact] public static void CustomMessageCollectionNull() => Test.CustomMessage(message => ((List) null).MustNotBeNullOrEmpty(message: message)); [Fact] public static void CallerArgumentExpressionForEmptyCollection() { var emptyArray = Array.Empty(); Action act = () => emptyArray.MustNotBeNullOrEmpty(); act.Should().Throw() .WithParameterName(nameof(emptyArray)); } [Fact] public static void CallerArgumentExpressionForNull() { var nullArray = default(int[]); // ReSharper disable once ExpressionIsAlwaysNull Action act = () => nullArray.MustNotBeNullOrEmpty(); act.Should().Throw() .WithParameterName(nameof(nullArray)); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CollectionAssertions/MustNotBeOneOfTests.cs000066400000000000000000000051511470750352700331700ustar00rootroot00000000000000using System; using System.Collections.Generic; using System.Text; using FluentAssertions; using Light.GuardClauses.Exceptions; using Light.GuardClauses.FrameworkExtensions; using Xunit; namespace Light.GuardClauses.Tests.CollectionAssertions; public static class MustNotBeOneOfTests { [Theory] [InlineData("Foo", new[] { "Foo", "Bar" })] [InlineData(null, new[] { "Foo", "Bar", null, "Qux" })] public static void ValueExists(string value, string[] items) { Action act = () => value.MustNotBeOneOf(items, nameof(value)); var assertion = act.Should().Throw().Which; assertion.Message.Should().Contain(new StringBuilder().AppendLine($"{nameof(value)} must not be one of the following items") .AppendItemsWithNewLine(items) .AppendLine($"but it actually is {value.ToStringOrNull()}.") .ToString()); assertion.ParamName.Should().BeSameAs(nameof(value)); } [Theory] [InlineData(42, new[] { 1, 2, 3 })] [InlineData(89, new int[] { })] public static void ValueExistsNot(int value, int[] items) => value.MustNotBeOneOf(items).Should().Be(value); [Fact] public static void ItemsNull() { Action act = () => "Foo".MustNotBeOneOf(null!); act.Should().Throw(); } [Theory] [InlineData(42, new[] { 1, 42, 3 })] [InlineData(42, null)] public static void CustomException(int item, int[] collection) => Test.CustomException(item, collection == null ? null : new HashSet(collection), (value, set, exceptionFactory) => value.MustNotBeOneOf(set, exceptionFactory)); [Fact] public static void NoCustomExceptionThrown() => 42.MustNotBeOneOf(new[] { 1, 2, 3 }, (_, _) => new Exception()).Should().Be(42); [Fact] public static void CustomMessage() => Test.CustomMessage(message => false.MustNotBeOneOf(new[] { true, false }, message: message)); [Fact] public static void CustomMessageCollectionNull() => Test.CustomMessage(message => true.MustNotBeOneOf(null!, message: message)); [Fact] public static void CallerArgumentExpression() { var fortyTwo = 42; Action act = () => fortyTwo.MustNotBeOneOf(new[] { 42 }); act.Should().Throw() .WithParameterName(nameof(fortyTwo)); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CollectionAssertions/MustNotContainTests.cs000066400000000000000000000053521470750352700333110ustar00rootroot00000000000000using System; using System.Collections.Generic; using System.Collections.ObjectModel; using FluentAssertions; using Light.GuardClauses.Exceptions; using Light.GuardClauses.FrameworkExtensions; using Xunit; namespace Light.GuardClauses.Tests.CollectionAssertions; public static class MustNotContainTests { [Theory] [InlineData(new[] { "Foo", "Bar" }, "Foo")] [InlineData(new[] { "Baz", "Qux", "Quux" }, "Qux")] [InlineData(new[] { "Corge", "Grault", null }, null)] public static void ItemExists(string[] collection, string item) { Action act = () => collection.MustNotContain(item, nameof(collection)); var assertions = act.Should().Throw().Which; assertions.Message.Should().Contain($"{nameof(collection)} must not contain {item.ToStringOrNull()}, but it actually does."); assertions.ParamName.Should().BeSameAs(nameof(collection)); } [Theory] [InlineData(new[] { 100, 101, 102 }, 42)] [InlineData(new[] { 11 }, -5000)] [InlineData(new int[] { }, 13)] public static void ItemExistsNot(int[] collection, int item) => collection.MustNotContain(item).Should().BeSameAs(collection); [Fact] public static void CollectionNull() { Action act = () => ((ObservableCollection)null).MustNotContain(new object()); act.Should().Throw(); } [Fact] public static void CustomException() => Test.CustomException(new List { "Foo" }, "Foo", (collection, value, exceptionFactory) => collection.MustNotContain(value, exceptionFactory)); [Fact] public static void CustomExceptionCollectionNull() => Test.CustomException((Collection)null, 42, (collection, i, exceptionFactory) => collection.MustNotContain(i, exceptionFactory)); [Fact] public static void NoCustomExceptionThrown() { var collection = new[] { 1, 2 }; collection.MustNotContain(3, (_, _) => new Exception()).Should().BeSameAs(collection); } [Fact] public static void CustomMessage() => Test.CustomMessage(message => new HashSet { 42 }.MustNotContain(42, message: message)); [Fact] public static void CustomMessageCollectionNull() => Test.CustomMessage(message => ((List)null).MustNotContain(false, message: message)); [Fact] public static void CallerArgumentExpression() { var array = new[] { 1, 2, 3 }; Action act = () => array.MustNotContain(3); act.Should().Throw() .WithParameterName(nameof(array)); } }ReadOnlySpanMustBeLongerThanTests.cs000066400000000000000000000050421470750352700357420ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CollectionAssertionsusing System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.CollectionAssertions; public static class ReadOnlySpanMustBeLongerThanTests { [Theory] [InlineData(5, 3)] [InlineData(9, 7)] [InlineData(1, 0)] public static void SpanLonger(int spanLength, int expectedLength) { var array = new[] { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 }; var span = new ReadOnlySpan(array, 0, spanLength); var returnValue = span.MustBeLongerThan(expectedLength); (returnValue == span).Should().BeTrue("the assertion returns a copy of the original span."); } [Theory] [InlineData(3, 4)] [InlineData(0, 1)] [InlineData(6, 6)] public static void SpanShorterOrEqual(int spanLength, int expectedLength) { var act = () => { var array = new[] { 'a', 'b', 'c', 'd', 'e', 'f', 'g' }; var span = new ReadOnlySpan(array, 0, spanLength); span.MustBeLongerThan(expectedLength, nameof(span)); }; act.Should().Throw() .And.Message.Should().Contain($"span must be longer than {expectedLength}, but it actually has length {spanLength}."); } [Fact] public static void CustomException() { var exception = new Exception(); var act = () => { var span = new ReadOnlySpan(); span.MustBeLongerThan(2, (_, _) => exception); }; act.Should().Throw().Which.Should().BeSameAs(exception); } [Fact] public static void NoCustomException() { var array = new int[4]; var span = new ReadOnlySpan(array); var returnValue = span.MustBeLongerThan(3, null!); (returnValue == span).Should().BeTrue("the assertion returns a copy of the original span."); } [Fact] public static void CustomMessage() { var act = () => { var span = new ReadOnlySpan(); span.MustBeLongerThan(5, null, "Custom exception message"); }; act.Should().Throw() .And.Message.Should().Be("Custom exception message"); } [Fact] public static void CallerArgumentExpression() { var act = () => { var mySpan = new ReadOnlySpan(); mySpan.MustBeLongerThan(2); }; act.Should().Throw() .WithParameterName("mySpan"); } }ReadOnlySpanMustBeShorterThanOrEqualToTests.cs000066400000000000000000000051351470750352700377410ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CollectionAssertionsusing System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.CollectionAssertions; public static class ReadOnlySpanMustBeShorterThanOrEqualToTests { [Theory] [InlineData(45, 68)] [InlineData(0, 1)] [InlineData(0, 0)] [InlineData(87, 87)] public static void ShorterThanOrEqualTo(int spanLength, int expectedLength) { var array = new byte[128]; var span = new ReadOnlySpan(array, 0, spanLength); var returnValue = span.MustBeShorterThanOrEqualTo(expectedLength); (returnValue == span).Should().BeTrue("the assertion returns a copy of the passed-in span"); } [Theory] [InlineData(7, 5)] [InlineData(10, 9)] [InlineData(1, 0)] public static void LongerThan(int spanLength, int expectedLength) { var act = () => { var array = new int[10]; var span = new ReadOnlySpan(array, 0, spanLength); span.MustBeShorterThanOrEqualTo(expectedLength, nameof(span)); }; act.Should().Throw() .And.Message.Should().Contain($"span must be shorter than or equal to {expectedLength}, but it actually has length {spanLength}."); } [Fact] public static void CustomException() { var exception = new Exception(); var act = () => { var span = new ReadOnlySpan(new byte[10]); span.MustBeShorterThanOrEqualTo(5, (_, _) => exception); }; act.Should().Throw().Which.Should().BeSameAs(exception); } [Fact] public static void NoCustomException() { var span = new ReadOnlySpan(new char[4]); var returnValue = span.MustBeShorterThanOrEqualTo(5, null!); (returnValue == span).Should().BeTrue("the assertion returns a copy of the passed-in span"); } [Fact] public static void CustomMessage() { var act = () => { var span = new ReadOnlySpan(new int[10]); span.MustBeShorterThanOrEqualTo(5, null, "Custom exception message"); }; act.Should().Throw() .And.Message.Should().Be("Custom exception message"); } [Fact] public static void CallerArgumentExpression() { var act = () => { var span = new ReadOnlySpan(new char[2]); span.MustBeShorterThanOrEqualTo(1); }; act.Should().Throw() .WithParameterName("span"); } }ReadOnlySpanMustBeShorterThanTests.cs000066400000000000000000000047251470750352700361510ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CollectionAssertionsusing System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.CollectionAssertions; public static class ReadOnlySpanMustBeShorterThanTests { [Theory] [InlineData(1, 4)] [InlineData(0, 1)] [InlineData(9, 14)] public static void SpanShorter(int spanLength, int expectedLength) { var array = new int[10]; var span = new ReadOnlySpan(array, 0, spanLength); var returnValue = span.MustBeShorterThan(expectedLength); (returnValue == span).Should().BeTrue("the assertion returns a copy of the passed-in span"); } [Theory] [InlineData(11, 6)] [InlineData(1, 0)] [InlineData(7, 7)] public static void SpanLongerOrEqual(int spanLength, int expectedLength) { var act = () => { var array = new char[15]; var span = new ReadOnlySpan(array, 0, spanLength); span.MustBeShorterThan(expectedLength, nameof(span)); }; act.Should().Throw() .And.Message.Should().Contain($"span must be shorter than {expectedLength}, but it actually has length {spanLength}."); } [Fact] public static void CustomException() { var exception = new Exception(); var act = () => { var span = new ReadOnlySpan(); span.MustBeShorterThan(0, (_, _) => exception); }; act.Should().Throw().Which.Should().BeSameAs(exception); } [Fact] public static void NoCustomException() { var span = new ReadOnlySpan(); var returnValue = span.MustBeShorterThan(5, null!); (returnValue == span).Should().BeTrue("the assertion returns a copy of the passed-in span"); } [Fact] public static void CustomMessage() { var act = () => { var span = new ReadOnlySpan(); span.MustBeShorterThan(0, null, "Custom exception message"); }; act.Should().Throw().And.Message.Should().Be("Custom exception message"); } [Fact] public static void CallerArgumentExpression() { var act = () => { ReadOnlySpan ultraSpan = stackalloc byte[5]; ultraSpan.MustBeShorterThan(5); }; act.Should().Throw() .WithParameterName("ultraSpan"); } }ReadOnlySpanMustHaveLengthTests.cs000066400000000000000000000050241470750352700354570ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CollectionAssertionsusing System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.CollectionAssertions; public static class ReadOnlySpanMustHaveLengthTests { [Theory] [InlineData(3, 2)] [InlineData(7, 9)] [InlineData(0, 1)] [InlineData(10, 17)] public static void InvalidLength(int spanLength, int expectedLength) { var act = () => { var array = new int[10]; var span = new ReadOnlySpan(array, 0, spanLength); span.MustHaveLength(expectedLength, nameof(span)); }; act.Should().Throw() .And.Message.Should().Contain($"span must have length {expectedLength}, but it actually has length {spanLength}."); } [Theory] [InlineData(1)] [InlineData(6)] [InlineData(4)] [InlineData(0)] public static void ValidLength(int spanLength) { var array = new[] { "a", "b", "c", "d", "e", "f", "g", "h", "i" }; var span = new ReadOnlySpan(array, 0, spanLength); var result = span.MustHaveLength(spanLength); (result == span).Should().BeTrue("The returned span must be a copy of the passed-in instance."); } [Fact] public static void CustomException() { var exception = new Exception(); var act = () => { var array = new char[5]; var span = new ReadOnlySpan(array, 0, 3); span.MustHaveLength(4, (_, _) => exception); }; act.Should().Throw().Which.Should().BeSameAs(exception); } [Fact] public static void NoCustomException() { var array = new int[5]; var span = new ReadOnlySpan(array); var result = span.MustHaveLength(5, null!); (result == span).Should().BeTrue("The returned span must be a copy of the passed-in instance."); } [Fact] public static void CustomMessage() { var act = () => { var span = new ReadOnlySpan(); span.MustHaveLength(42, null, "Foo"); }; act.Should().Throw() .And.Message.Should().Contain("Foo"); } [Fact] public static void CallerArgumentExpression() { var act = () => { var mySpan = new ReadOnlySpan(); mySpan.MustHaveLength(15); }; act.Should().Throw() .WithParameterName("mySpan"); } }ReadOnlySpanMustNotBeLongerThanOrEqualToTests.cs000066400000000000000000000051471470750352700402250ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CollectionAssertionsusing FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; using System; namespace Light.GuardClauses.Tests.CollectionAssertions; public static class ReadOnlySpanMustNotBeLongerThanOrEqualToTests { [Theory] [InlineData(76, 29)] [InlineData(10, 10)] [InlineData(0, 0)] [InlineData(128, 127)] public static void LongerThanOrEqualTo(int spanLength, int expectedLength) { var array = new byte[128]; var span = new ReadOnlySpan(array, 0, spanLength); var returnValue = span.MustBeLongerThanOrEqualTo(expectedLength); (returnValue == span).Should().BeTrue("the assertion returns a copy of the passed-in span"); } [Theory] [InlineData(6, 9)] [InlineData(1, 3)] [InlineData(0, 4)] public static void ShorterThan(int spanLength, int expectedLength) { var act = () => { var array = new int[10]; var span = new ReadOnlySpan(array, 0, spanLength); span.MustBeLongerThanOrEqualTo(expectedLength, nameof(span)); }; act.Should().Throw() .And.Message.Should().Contain($"span must be longer than or equal to {expectedLength}, but it actually has length {spanLength}."); } [Fact] public static void CustomException() { var exception = new Exception(); var act = () => { var array = new char[5]; var span = new ReadOnlySpan(array, 1, 3); span.MustBeLongerThanOrEqualTo(10, (_, _) => exception); }; act.Should().Throw().Which.Should().BeSameAs(exception); } [Fact] public static void NoCustomException() { var span = new ReadOnlySpan(); var returnValue = span.MustBeLongerThanOrEqualTo(0, null!); (returnValue == span).Should().BeTrue("the assertion returns a copy of the passed-in span"); } [Fact] public static void CustomMessage() { var act = () => { var span = new ReadOnlySpan(); span.MustBeLongerThanOrEqualTo(15, null, "Custom exception message"); }; act.Should().Throw() .And.Message.Should().Be("Custom exception message"); } [Fact] public static void CallerArgumentExpression() { var act = () => { var mySpan = new ReadOnlySpan(); mySpan.MustBeLongerThanOrEqualTo(2); }; act.Should().Throw() .WithParameterName("mySpan"); } }SpanMustBeLongerThanOrEqualToTests.cs000066400000000000000000000050541470750352700361030ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CollectionAssertionsusing System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.CollectionAssertions; public static class SpanMustBeLongerThanOrEqualToTests { [Theory] [InlineData(30, 20)] [InlineData(5, 5)] [InlineData(0, 0)] [InlineData(128, 127)] public static void LongerThanOrEqualTo(int spanLength, int expectedLength) { var array = new byte[128]; var span = new Span(array, 0, spanLength); var returnValue = span.MustBeLongerThanOrEqualTo(expectedLength); (returnValue == span).Should().BeTrue("the assertion returns a copy of the passed-in span"); } [Theory] [InlineData(8, 9)] [InlineData(2, 3)] [InlineData(0, 6)] public static void ShorterThan(int spanLength, int expectedLength) { var act = () => { var array = new int[10]; var span = new Span(array, 0, spanLength); span.MustBeLongerThanOrEqualTo(expectedLength, nameof(span)); }; act.Should().Throw() .And.Message.Should().Contain($"span must be longer than or equal to {expectedLength}, but it actually has length {spanLength}."); } [Fact] public static void CustomException() { var exception = new Exception(); var act = () => { var array = new char[5]; var span = new Span(array, 1, 3); span.MustBeLongerThanOrEqualTo(10, (_, _) => exception); }; act.Should().Throw().Which.Should().BeSameAs(exception); } [Fact] public static void NoCustomException() { var span = new Span(); var returnValue = span.MustBeLongerThanOrEqualTo(0, null!); (returnValue == span).Should().BeTrue("the assertion returns a copy of the passed-in span"); } [Fact] public static void CustomMessage() { var act = () => { var span = new Span(); span.MustBeLongerThanOrEqualTo(15, null, "Custom exception message"); }; act.Should().Throw() .And.Message.Should().Be("Custom exception message"); } [Fact] public static void CallerArgumentExpression() { var act = () => { var mySpan = new Span(); mySpan.MustBeLongerThanOrEqualTo(15); }; act.Should().Throw() .WithParameterName("mySpan"); } }SpanMustBeLongerThanTests.cs000066400000000000000000000047531470750352700343140ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CollectionAssertionsusing System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.CollectionAssertions; public static class SpanMustBeLongerThanTests { [Theory] [InlineData(4, 3)] [InlineData(8, 4)] [InlineData(1, 0)] public static void SpanLonger(int spanLength, int expectedLength) { var array = new[] { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 }; var span = new Span(array, 0, spanLength); var returnValue = span.MustBeLongerThan(expectedLength); (returnValue == span).Should().BeTrue("the assertion returns a copy of the original span."); } [Theory] [InlineData(3, 4)] [InlineData(0, 1)] [InlineData(7, 12)] public static void SpanShorterOrEqual(int spanLength, int expectedLength) { var act = () => { var array = new[] { 'a', 'b', 'c', 'd', 'e', 'f', 'g' }; var span = new Span(array, 0, spanLength); span.MustBeLongerThan(expectedLength, nameof(span)); }; act.Should().Throw() .And.Message.Should().Contain($"span must be longer than {expectedLength}, but it actually has length {spanLength}."); } [Fact] public static void CustomException() { var exception = new Exception(); var act = () => { var span = new Span(); span.MustBeLongerThan(2, (_, _) => exception); }; act.Should().Throw().Which.Should().BeSameAs(exception); } [Fact] public static void NoCustomException() { var array = new int[4]; var span = new Span(array); var returnValue = span.MustBeLongerThan(3, null!); (returnValue == span).Should().BeTrue("the assertion returns a copy of the original span."); } [Fact] public static void CustomMessage() { var act = () => { var span = new Span(); span.MustBeLongerThan(5, null, "Custom exception message"); }; act.Should().Throw() .And.Message.Should().Be("Custom exception message"); } [Fact] public static void CallerArgumentExpression() { var act = () => { var mySpan = new Span(); mySpan.MustBeLongerThan(3); }; act.Should().Throw() .WithParameterName("mySpan"); } }SpanMustBeShorterThanOrEqualToTests.cs000066400000000000000000000050431470750352700363010ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CollectionAssertionsusing System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.CollectionAssertions; public static class SpanMustBeShorterThanOrEqualToTests { [Theory] [InlineData(50, 75)] [InlineData(0, 1)] [InlineData(0, 0)] [InlineData(90, 90)] public static void ShorterThanOrEqualTo(int spanLength, int expectedLength) { var array = new byte[128]; var span = new Span(array, 0, spanLength); var returnValue = span.MustBeShorterThanOrEqualTo(expectedLength); (returnValue == span).Should().BeTrue("the assertion returns a copy of the passed-in span"); } [Theory] [InlineData(7, 5)] [InlineData(10, 9)] [InlineData(1, 0)] public static void LongerThan(int spanLength, int expectedLength) { var act = () => { var array = new int[10]; var span = new Span(array, 0, spanLength); span.MustBeShorterThanOrEqualTo(expectedLength, nameof(span)); }; act.Should().Throw() .And.Message.Should().Contain($"span must be shorter than or equal to {expectedLength}, but it actually has length {spanLength}."); } [Fact] public static void CustomException() { var exception = new Exception(); var act = () => { var span = new Span(new byte[10]); span.MustBeShorterThanOrEqualTo(5, (_, _) => exception); }; act.Should().Throw().Which.Should().BeSameAs(exception); } [Fact] public static void NoCustomException() { var span = new Span(new char[4]); var returnValue = span.MustBeShorterThanOrEqualTo(5, null!); (returnValue == span).Should().BeTrue("the assertion returns a copy of the passed-in span"); } [Fact] public static void CustomMessage() { var act = () => { var span = new Span(new int[10]); span.MustBeShorterThanOrEqualTo(5, null, "Custom exception message"); }; act.Should().Throw() .And.Message.Should().Be("Custom exception message"); } [Fact] public static void CallerArgumentExpression() { var act = () => { var span = new Span(new int[5]); span.MustBeShorterThanOrEqualTo(3); }; act.Should().Throw() .WithParameterName("span"); } }SpanMustBeShorterThanTests.cs000066400000000000000000000046211470750352700345060ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CollectionAssertionsusing System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.CollectionAssertions; public static class SpanMustBeShorterThanTests { [Theory] [InlineData(2, 4)] [InlineData(0, 1)] [InlineData(10, 18)] public static void SpanShorter(int spanLength, int expectedLength) { var array = new int[10]; var span = new Span(array, 0, spanLength); var returnValue = span.MustBeShorterThan(expectedLength); (returnValue == span).Should().BeTrue("the assertion returns a copy of the passed-in span"); } [Theory] [InlineData(10, 7)] [InlineData(1, 0)] [InlineData(5, 5)] public static void SpanLongerOrEqual(int spanLength, int expectedLength) { var act = () => { var array = new char[15]; var span = new Span(array, 0, spanLength); span.MustBeShorterThan(expectedLength, nameof(span)); }; act.Should().Throw() .And.Message.Should().Contain($"span must be shorter than {expectedLength}, but it actually has length {spanLength}."); } [Fact] public static void CustomException() { var exception = new Exception(); var act = () => { var span = new Span(); span.MustBeShorterThan(0, (_, _) => exception); }; act.Should().Throw().Which.Should().BeSameAs(exception); } [Fact] public static void NoCustomException() { var span = new Span(); var returnValue = span.MustBeShorterThan(5, null!); (returnValue == span).Should().BeTrue("the assertion returns a copy of the passed-in span"); } [Fact] public static void CustomMessage() { var act = () => { var span = new Span(); span.MustBeShorterThan(0, null, "Custom exception message"); }; act.Should().Throw().And.Message.Should().Be("Custom exception message"); } [Fact] public static void CallerArgumentExpression() { var act = () => { var span = new Span(new byte[3]); span.MustBeShorterThan(2); }; act.Should().Throw() .WithParameterName("span"); } }SpanMustHaveLengthTests.cs000066400000000000000000000047511470750352700340270ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CollectionAssertionsusing System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.CollectionAssertions; public static class SpanMustHaveLengthTests { [Theory] [InlineData(3, 2)] [InlineData(5, 6)] [InlineData(0, 1)] [InlineData(10, 11)] public static void InvalidLength(int spanLength, int expectedLength) { var act = () => { var array = new int[10]; var span = new Span(array, 0, spanLength); span.MustHaveLength(expectedLength, nameof(span)); }; act.Should().Throw() .And.Message.Should().Contain($"span must have length {expectedLength}, but it actually has length {spanLength}."); } [Theory] [InlineData(1)] [InlineData(3)] [InlineData(6)] [InlineData(0)] public static void ValidLength(int spanLength) { var array = new[] { "a", "b", "c", "d", "e", "f", "g", "h", "i" }; var span = new Span(array, 0, spanLength); var result = span.MustHaveLength(spanLength); (result == span).Should().BeTrue("The returned span must be a copy of the passed-in instance."); } [Fact] public static void CustomException() { var exception = new Exception(); var act = () => { var array = new char[5]; var span = new Span(array, 0, 3); span.MustHaveLength(4, (_, _) => exception); }; act.Should().Throw().Which.Should().BeSameAs(exception); } [Fact] public static void NoCustomException() { var array = new int[4]; var span = new Span(array); var result = span.MustHaveLength(4, (_, _) => null); (result == span).Should().BeTrue("The returned span must be a copy of the passed-in instance."); } [Fact] public static void CustomMessage() { var act = () => { var span = new Span(); span.MustHaveLength(1, message: "Foo"); }; act.Should().Throw() .And.Message.Should().Contain("Foo"); } [Fact] public static void CallerArgumentExpression() { var act = () => { var mySpan = new Span(); mySpan.MustHaveLength(10); }; act.Should().Throw() .WithParameterName("mySpan"); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CommonAssertions/000077500000000000000000000000001470750352700261425ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CommonAssertions/InvalidArgumentTests.cs000066400000000000000000000034161470750352700326110ustar00rootroot00000000000000using System; using FluentAssertions; using Xunit; namespace Light.GuardClauses.Tests.CommonAssertions; public static class InvalidArgumentTests { [Theory] [DefaultVariablesData] public static void ConditionTrue(string parameterName) { var act = () => Check.InvalidArgument(true, parameterName); var exceptionAssertion = act.Should().Throw().And; exceptionAssertion.ParamName.Should().BeSameAs(parameterName); exceptionAssertion.Message.Should().Contain($"{parameterName} is invalid."); } [Fact] public static void ConditionFalse() { Check.InvalidArgument(false); } [Fact] public static void ConditionFalseCustomException() { Check.InvalidArgument(false, () => new Exception()); } [Fact] public static void ConditionFalseCustomExceptionWithParameter() { Check.InvalidArgument(false, new object(), _ => new Exception()); } [Fact] public static void CustomException() => Test.CustomException(exceptionFactory => Check.InvalidArgument(true, exceptionFactory)); [Fact] public static void CustomExceptionWithParameter() => Test.CustomException(new object(), (parameter, exceptionFactory) => Check.InvalidArgument(true, parameter, exceptionFactory)); [Fact] public static void CustomMessage() => Test.CustomMessage(message => Check.InvalidArgument(true, message: message)); [Fact] public static void DefaultMessage() { var act = () => Check.InvalidArgument(true); act.Should().Throw() .And.Message.Should().Be("The value is invalid."); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CommonAssertions/InvalidOperationTests.cs000066400000000000000000000010201470750352700327540ustar00rootroot00000000000000using System; using FluentAssertions; using Xunit; namespace Light.GuardClauses.Tests.CommonAssertions; public static class InvalidOperationTests { [Theory] [DefaultVariablesData] public static void ConditionTrue(string message) { var act = () => Check.InvalidOperation(true, message); act.Should().Throw() .And.Message.Should().Be(message); } [Fact] public static void ConditionFalse() { Check.InvalidOperation(false); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CommonAssertions/InvalidStateTests.cs000066400000000000000000000010061470750352700321000ustar00rootroot00000000000000using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.CommonAssertions; public static class InvalidStateTests { [Theory] [DefaultVariablesData] public static void ConditionTrue(string message) { var act = () => Check.InvalidState(true, message); act.Should().Throw() .And.Message.Should().Be(message); } [Fact] public static void ConditionFalse() => Check.InvalidState(false); }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CommonAssertions/IsApproximatelyTests.cs000066400000000000000000000031261470750352700326500ustar00rootroot00000000000000using FluentAssertions; using Xunit; namespace Light.GuardClauses.Tests.CommonAssertions; public static class IsApproximatelyTests { [Theory] [InlineData(3.5, 3.6, false)] [InlineData(5.1, 5.1, true)] [InlineData(-5.0, 5.0, false)] [InlineData(1.1, 1.099999, true)] public static void DoubleWithDefaultTolerance(double first, double second, bool expected) => first.IsApproximately(second).Should().Be(expected); [Theory] [InlineData(1.1, 1.3, 0.5, true)] [InlineData(100.55, 100.555, 0.00001, false)] [InlineData(5.0, 14.999999, 10.0, true)] [InlineData(5.0, 15.0, 10.0, false)] [InlineData(5.0, 15.0001, 10.0, false)] public static void DoubleWithCustomTolerance(double first, double second, double tolerance, bool expected) => first.IsApproximately(second, tolerance).Should().Be(expected); [Theory] [InlineData(17.5f, 17.4f, false)] [InlineData(-3.75f, -3.75f, true)] [InlineData(-10.0f, 10.0f, false)] [InlineData(1.1f, 1.099999f, true)] public static void FloatWithDefaultTolerance(float first, float second, bool expected) => first.IsApproximately(second).Should().Be(expected); [Theory] [InlineData(1.1f, 1.3f, 0.5f, true)] [InlineData(100.55f, 100.555f, 0.00001f, false)] [InlineData(5.0f, 14.999999f, 10.0f, true)] [InlineData(5.0f, 15.0f, 10.0f, false)] [InlineData(5.0f, 15.0001f, 10.0f, false)] public static void FloatWithCustomTolerance(float first, float second, float tolerance, bool expected) => first.IsApproximately(second, tolerance).Should().Be(expected); }IsGreaterThanOrApproximatelyTests.cs000066400000000000000000000030671470750352700352230ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CommonAssertionsusing FluentAssertions; using Xunit; namespace Light.GuardClauses.Tests.CommonAssertions; public static class IsGreaterThanOrApproximatelyTests { [Theory] [InlineData(17.4, 17.3, true)] [InlineData(19.9999999, 20.0, true)] [InlineData(-5.49998, -5.5, true)] [InlineData(-5.4998, -5.4996, false)] public static void DoubleWithDefaultTolerance(double first, double second, bool expected) => first.IsGreaterThanOrApproximately(second).Should().Be(expected); [Theory] [InlineData(15.91, 15.9, 0.1, true)] [InlineData(24.449, 24.45, 0.0001, false)] [InlineData(-3.12, -3.2, 0.001, true)] [InlineData(2.369, 2.37, 0.0005, false)] public static void DoubleWithCustomTolerance(double first, double second, double tolerance, bool expected) => first.IsGreaterThanOrApproximately(second, tolerance).Should().Be(expected); [Theory] [InlineData(100.225f, 100.2f, true)] [InlineData(-5.9f, -5.5f, false)] [InlineData(0f, -0.02f, true)] [InlineData(-0.001f, 0f, false)] public static void FloatWithDefaultTolerance(float first, float second, bool expected) => first.IsGreaterThanOrApproximately(second).Should().Be(expected); [Theory] [InlineData(2.0f, 1.0f, 0.1f, true)] [InlineData(1.0f, 1.0f, 0.1f, true)] [InlineData(1.0f, 1.1f, 0.01f, false)] [InlineData(1.0f, 2.0f, 0.1f, false)] public static void FloatWIthCustomTolerance(float first, float second, float tolerance, bool expected) => first.IsGreaterThanOrApproximately(second, tolerance).Should().Be(expected); }IsLessThanOrApproximatelyTests.cs000066400000000000000000000030611470750352700345320ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CommonAssertionsusing FluentAssertions; using Xunit; namespace Light.GuardClauses.Tests.CommonAssertions; public static class IsLessThanOrApproximatelyTests { [Theory] [InlineData(13.25, 13.5, true)] [InlineData(48.99, 48.98999, true)] [InlineData(19.775, 19.7, false)] [InlineData(-14.32, -14.33, false)] public static void DoubleWithDefaultTolerance(double first, double second, bool expected) => first.IsLessThanOrApproximately(second).Should().Be(expected); [Theory] [InlineData(50.3, 50.5, 0.5, true)] [InlineData(2015.5, 2015.3, 0.3, true)] [InlineData(-519, -519.5, 0.25, false)] [InlineData(0, -1, 0.9, false)] public static void DoubleWithCustomTolerance(double first, double second, double tolerance, bool expected) => first.IsLessThanOrApproximately(second, tolerance).Should().Be(expected); [Theory] [InlineData(13.25f, 13.5f, true)] [InlineData(48.99f, 48.98999f, true)] [InlineData(19.775f, 19.7f, false)] [InlineData(-14.32f, -14.33f, false)] public static void FloatWithDefaultTolerance(float first, float second, bool expected) => first.IsLessThanOrApproximately(second).Should().Be(expected); [Theory] [InlineData(50.3f, 50.5f, 0.5f, true)] [InlineData(2015.5f, 2015.3f, 0.3f, true)] [InlineData(-519f, -519.5f, 0.25f, false)] [InlineData(0f, -1f, 0.9f, false)] public static void FloatWithCustomTolerance(float first, float second, float tolerance, bool expected) => first.IsLessThanOrApproximately(second, tolerance).Should().Be(expected); }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CommonAssertions/IsSameAsTests.cs000066400000000000000000000006201470750352700311570ustar00rootroot00000000000000using FluentAssertions; using Xunit; namespace Light.GuardClauses.Tests.CommonAssertions; public static class IsSameAsTests { [Fact] public static void SameReference() { var @object = new object(); @object.IsSameAs(@object).Should().BeTrue(); } [Fact] public static void DifferentReferences() => new object().IsSameAs(new object()).Should().BeFalse(); }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CommonAssertions/IsValidEnumValueTests.cs000066400000000000000000000042571470750352700327010ustar00rootroot00000000000000using System; using System.Globalization; using System.Reflection; using FluentAssertions; using Xunit; namespace Light.GuardClauses.Tests.CommonAssertions; public static class IsValidEnumValueTests { [Theory] [InlineData(ConsoleColor.Black)] [InlineData(UriKind.Absolute)] [InlineData(DateTimeKind.Utc)] [InlineData(BindingFlags.Static | BindingFlags.Public)] [InlineData(BindingFlags.SetProperty | BindingFlags.SetField)] [InlineData(NumberStyles.Number | NumberStyles.AllowExponent)] [InlineData(UInt64Enum.Low1 | UInt64Enum.Low3)] [InlineData(UInt64Enum.High2 | UInt64Enum.High4)] [InlineData(UInt64Enum.AllLow | UInt64Enum.High1)] [InlineData(UInt64Enum.AllHigh)] [InlineData(UInt64Enum.MaxValue)] public static void EnumValueValid(T enumValue) where T : struct, Enum, IComparable { if (enumValue is BindingFlags) { } enumValue.IsValidEnumValue().Should().BeTrue(); } [Theory] [InlineData(2000)] [InlineData(-5)] public static void EnumValueInvalid(int invalidDateTimeKindValue) => ((DateTimeKind) invalidDateTimeKindValue).IsValidEnumValue().Should().BeFalse(); [Theory] [InlineData(-1)] [InlineData(-2)] [InlineData(-512)] [InlineData(int.MinValue)] [InlineData(2048)] [InlineData(2055)] [InlineData(4096)] [InlineData(int.MaxValue)] public static void InvalidNumberStyles(int invalidValue) => ((NumberStyles) invalidValue).IsValidEnumValue().Should().BeFalse(); [Flags] public enum UInt64Enum : ulong { Low1 = 1 << 0, Low2 = 1 << 1, Low3 = 1 << 2, Low4 = 1 << 3, AllLow = Low1 | Low2 | Low3 | Low4, High1 = 1 << 59, High2 = 1 << 60, High3 = 1 << 61, High4 = 1 << 62, AllHigh = High1 | High2 | High3 | High4, MaxValue = ulong.MaxValue } [Fact] public static void EmptyEnumValue() => ((EmptyEnum) 42).IsValidEnumValue().Should().BeFalse(); public enum EmptyEnum { } [Fact] public static void EmptyFlagsEnumValue() => ((EmptyFlagsEnum) 186).IsValidEnumValue().Should().BeFalse(); [Flags] public enum EmptyFlagsEnum { } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CommonAssertions/MustBeOfTypeTests.cs000066400000000000000000000053561470750352700320530ustar00rootroot00000000000000using System; using System.IO; using System.Text; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.CommonAssertions; public static class MustBeOfTypeTests { [Fact] public static void CastNotPossible() { object reference = "Foo"; Action act = () => reference.MustBeOfType(nameof(reference)); var exceptionAssertions = act.Should().Throw().Which; exceptionAssertions.Message.Should().Contain($"{nameof(reference)} \"{reference}\" cannot be cast to \"{typeof(Array)}\"."); exceptionAssertions.ParamName.Should().BeSameAs(nameof(reference)); } [Fact] public static void Downcast() => "Bar".MustBeOfType().Should().BeSameAs("Bar"); [Fact] public static void Cast() => "Baz".MustBeOfType().Should().BeSameAs("Baz"); [Fact] public static void ReferenceIsNull() { Action act = () => ((object) null).MustBeOfType("Foo"); act.Should().Throw() .WithParameterName("Foo"); } [Fact] public static void CustomException() => Test.CustomException("Foo", (value, exceptionFactory) => value.MustBeOfType(exceptionFactory)); [Fact] public static void CustomExceptionArgumentNull() => Test.CustomException(null, (nullReference, exceptionFactory) => nullReference.MustBeOfType(exceptionFactory)); [Fact] public static void CustomExceptionDowncastValid() { var encoding = Encoding.UTF8; encoding.MustBeOfType(_ => null).Should().BeSameAs(encoding); } [Fact] public static void CustomMessage() => Test.CustomMessage(message => "Foo".MustBeOfType(message: message)); [Fact] public static void CustomMessageArgumentNull() => Test.CustomMessage(message => ((string) null).MustBeOfType(message: message)); [Fact] public static void CallerArgumentExpressionForTypeCastException() { var someValue = (object) "Foo"; Action act = () => someValue.MustBeOfType(); act.Should().Throw() .WithParameterName(nameof(someValue)); } [Fact] public static void CallerArgumentExpressionForArgumentNullException() { var myValue = (object) null; // ReSharper disable once ExpressionIsAlwaysNull Action act = () => myValue.MustBeOfType(); act.Should().Throw() .WithParameterName(nameof(myValue)); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CommonAssertions/MustBeTests.cs000066400000000000000000000067751470750352700307320ustar00rootroot00000000000000using System; using System.Collections.Generic; using FluentAssertions; using Light.GuardClauses.Exceptions; using Light.GuardClauses.FrameworkExtensions; using Xunit; namespace Light.GuardClauses.Tests.CommonAssertions; public static class MustBeTests { [Theory] [InlineData("Foo", "Bar")] [InlineData("Baz", "Qux")] public static void ValuesNotEqual(string x, string y) { Action act = () => x.MustBe(y, nameof(x)); act.Should().Throw() .And.Message.Should().Contain($"{nameof(x)} must be equal to {y.ToStringOrNull()}, but it actually is {x.ToStringOrNull()}."); } [Theory] [InlineData(42L)] [InlineData(long.MaxValue)] [InlineData(long.MinValue)] public static void ValuesEqual(long value) => value.MustBe(value).Should().Be(value); [Fact] public static void CustomException() => Test.CustomException("Foo", "Bar", (x, y, exceptionFactory) => x.MustBe(y, exceptionFactory)); [Fact] public static void CustomExceptionValuesEqual() => 87.MustBe(87, (_, _) => new Exception()).MustBe(87); [Fact] public static void CustomMessage() => Test.CustomMessage(message => false.MustBe(true, message: message)); [Fact] public static void ValuesNotEqualCustomEqualityComparer() { var myString = "Foo"; Action act = () => myString.MustBe("Bar", new EqualityComparerStub(false)); act.Should().Throw() .And.Message.Should().Contain($"myString must be equal to {"Bar".ToStringOrNull()}, but it actually is {"Foo".ToStringOrNull()}."); } [Fact] public static void ValuesEqualCustomEqualityComparer() => 42.MustBe(42, new EqualityComparerStub(true)).Should().Be(42); [Fact] public static void CustomExceptionEqualityComparer() => Test.CustomException("Foo", "Bar", (IEqualityComparer) new EqualityComparerStub(false), (x, y, comparer, exceptionFactory) => x.MustBe(y, comparer, exceptionFactory)); [Fact] public static void CustomExceptionEqualityComparerNull() => Test.CustomException(35L, 22L, (IEqualityComparer) null, (x, y, comparer, exceptionFactory) => x.MustBe(y, comparer, exceptionFactory)); [Fact] public static void CustomMessageEqualityComparer() => Test.CustomMessage(message => 99m.MustBe(100m, new EqualityComparerStub(false), message: message)); [Fact] public static void CustomMessageEqualityComparerNull() => // ReSharper disable once AssignNullToNotNullAttribute Test.CustomMessage(message => 42.MustBe(42, (IEqualityComparer) null, message: message)); [Fact] public static void CallerArgumentExpression() { var five = 5; Action act = () => five.MustBe(4); act.Should().Throw() .WithParameterName(nameof(five)); } [Fact] public static void CallerArgumentExpressionForEqualityComparerOverload() { var seven = 7; Action act = () => seven.MustBe(1, new EqualityComparerStub(false)); act.Should().Throw() .WithParameterName(nameof(seven)); } }MustBeValidEnumValueTests.cs000066400000000000000000000044041470750352700334400ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CommonAssertionsusing System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.CommonAssertions; public static class MustBeValidEnumValueTests { [Fact] public static void InvalidEnumValue() { const ConsoleSpecialKey invalidValue = (ConsoleSpecialKey) 15; Action act = () => invalidValue.MustBeValidEnumValue(nameof(invalidValue)); var exceptionAssertion = act.Should().Throw().Which; exceptionAssertion.Message.Should().Contain($"{nameof(invalidValue)} \"{invalidValue}\" must be one of the defined constants of enum \"{invalidValue.GetType()}\", but it actually is not."); exceptionAssertion.ParamName.Should().Be(nameof(invalidValue)); } [Fact] public static void ValidEnumValue() => ConsoleColor.DarkRed.MustBeValidEnumValue().Should().Be(ConsoleColor.DarkRed); [Fact] public static void CustomException() => Test.CustomException((ConsoleSpecialKey) 42, (invalidValue, exceptionFactory) => invalidValue.MustBeValidEnumValue(exceptionFactory)); [Fact] public static void CustomExceptionValidEnumValue() => SampleEnum.Second.MustBeValidEnumValue(_ => null).Should().Be(SampleEnum.Second); [Fact] public static void CustomMessage() => Test.CustomMessage( message => ((DateTimeKind) 7).MustBeValidEnumValue(message: message)); [Fact] public static void GetAllEnumValues() { var enumFields = typeof(SampleEnum).GetFields(); var actualValues = new SampleEnum[enumFields.Length - 1]; for (var i = 1; i < enumFields.Length; ++i) { actualValues[i - 1] = (SampleEnum) enumFields[i].GetValue(null)!; } var expectedValues = (SampleEnum[]) Enum.GetValues(typeof(SampleEnum)); actualValues.Should().Equal(expectedValues); } [Fact] public static void CallerArgumentExpression() { var someValue = (SampleEnum) 3; Action act = () => someValue.MustBeValidEnumValue(); act.Should().Throw() .WithParameterName(nameof(someValue)); } } public enum SampleEnum { First, Second, }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CommonAssertions/MustHaveValueTests.cs000066400000000000000000000026021470750352700322450ustar00rootroot00000000000000using System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.CommonAssertions; public static class MustHaveValueTests { [Fact] public static void HasNoValue() { DateTime? nullable = null; // ReSharper disable once ExpressionIsAlwaysNull Action act = () => nullable.MustHaveValue(nameof(nullable)); act.Should().Throw() .And.Message.Should().Contain($"{nameof(nullable)} must have a value, but it actually is null."); } [Theory] [InlineData(42)] [InlineData(20)] [InlineData(-187)] public static void HasValue(int? value) => value.MustHaveValue(nameof(value)).Should().Be(value); [Fact] public static void CustomException() => Test.CustomException(exceptionFactory => new double?().MustHaveValue(exceptionFactory)); [Fact] public static void CustomMessage() => Test.CustomMessage(message => new short?().MustHaveValue(message: message)); [Fact] public static void CallerArgumentExpression() { var nullable = default(int?); // ReSharper disable once ExpressionIsAlwaysNull Action act = () => nullable.MustHaveValue(); act.Should().Throw() .WithParameterName(nameof(nullable)); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CommonAssertions/MustNotBeDefaultTests.cs000066400000000000000000000063641470750352700327120ustar00rootroot00000000000000using System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.CommonAssertions; public static class MustNotBeDefaultTests { [Fact] public static void ReferenceIsNull() { const string paramterName = "Foo"; Action act = () => ((string) null).MustNotBeDefault(paramterName); var exceptionAssertion = act.Should().Throw().Which; exceptionAssertion.Message.Should().Contain($"{paramterName} must not be null."); exceptionAssertion.ParamName.Should().BeSameAs(paramterName); } [Theory] [InlineData(default(int))] [InlineData(default(double))] [InlineData(default(short))] [InlineData(default(long))] [InlineData(default(char))] [InlineData(default(bool))] [InlineData(default(ConsoleColor))] public static void ValueIsDefault(T defaultValue) where T : struct { Action act = () => defaultValue.MustNotBeDefault(nameof(defaultValue)); var exceptionAssertion = act.Should().Throw().Which; exceptionAssertion.Message.Should().Contain($"{nameof(defaultValue)} must not be the default value."); exceptionAssertion.ParamName.Should().BeSameAs(nameof(defaultValue)); } [Fact] public static void NullableIsNull() { Action act = () => ((int?) null).MustNotBeDefault(); act.Should().Throw(); } [Theory] [InlineData("Foo")] [InlineData("Bar")] public static void ReferenceIsNotNull(string reference) => reference.MustNotBeDefault().Should().BeSameAs(reference); [Theory] [InlineData(42)] [InlineData(true)] [InlineData('a')] [InlineData(8256L)] public static void ValueIsNotDefault(T value) where T : struct => value.MustNotBeDefault().Should().Be(value); [Fact] public static void NullableIsNotNull() { var nullable = new decimal?(42m); nullable.MustNotBeDefault().Should().Be(nullable); } [Fact] public static void CustomExceptionForReferenceType() => Test.CustomException(exceptionFactory => ((object)null).MustNotBeDefault(exceptionFactory)); [Fact] public static void CustomExceptionForValueType() => Test.CustomException(exceptionFactory => default(int).MustNotBeDefault(exceptionFactory)); [Fact] public static void CustomExceptionNotNull() => "Foo".MustNotBeDefault(() => null).Should().BeSameAs("Foo"); [Fact] public static void CustomExceptionNotDefault() => true.MustNotBeDefault(() => null).Should().BeTrue(); [Fact] public static void CustomMessageForReferenceType() => Test.CustomMessage(message => ((string) null).MustNotBeDefault(message: message)); [Fact] public static void CustomMessageForValueType() => Test.CustomMessage(message => default(TypeCode).MustNotBeDefault(message: message)); [Fact] public static void CallerArgumentExpression() { var someParameter = 0; Action act = () => someParameter.MustNotBeDefault(); act.Should().Throw() .WithParameterName(nameof(someParameter)); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CommonAssertions/MustNotBeEmptyGuidTests.cs000066400000000000000000000034251470750352700332300ustar00rootroot00000000000000using System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.CommonAssertions; public static class MustNotBeEmptyGuidTests { [Fact] public static void GuidEmpty() { var emptyGuid = Guid.Empty; Action act = () => emptyGuid.MustNotBeEmpty(nameof(emptyGuid)); act.Should().Throw() .WithParameterName(nameof(emptyGuid)); } [Fact] public static void GuidNotEmpty() { var validGuid = Guid.NewGuid(); var result = validGuid.MustNotBeEmpty(); result.Should().Be(validGuid); } [Fact] public static void CustomException() => Test.CustomException(exceptionFactory => Guid.Empty.MustNotBeEmpty(exceptionFactory)); [Fact] public static void CustomMessage() => Test.CustomMessage(message => Guid.Empty.MustNotBeEmpty(message: message)); [Fact] public static void CallerArgumentExpression() { var emptyGuid = Guid.Empty; Action act = () => emptyGuid.MustNotBeEmpty(); act.Should().Throw() .WithParameterName(nameof(emptyGuid)); } public class Entity(Guid id) { public Guid Id { get; } = id.MustNotBeEmpty(); } [Fact] public static void PrimaryConstructorValidArgument() { var guid = Guid.NewGuid(); var entity = new Entity(guid); entity.Id.Should().Be(guid); } [Fact] public static void PrimaryConstructorInvalidArgument() { var act = () => new Entity(Guid.Empty); act.Should().Throw() .And.Message.Should().StartWith("id must be a valid GUID, but it actually is an empty one."); } } MustNotBeNullReferenceTests.cs000066400000000000000000000044641470750352700337770ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CommonAssertionsusing System; using System.Collections; using FluentAssertions; using Xunit; namespace Light.GuardClauses.Tests.CommonAssertions; public static class MustNotBeNullReferenceTests { [Fact] public static void StringIsNull() => CheckArgumentNullExceptionIsThrown(default(string)); [Fact] public static void DelegateIsNull() => CheckArgumentNullExceptionIsThrown(default(Action)); [Fact] public static void PolymorphicReferenceIsNull() => CheckArgumentNullExceptionIsThrown(default(IEnumerable)); private static void CheckArgumentNullExceptionIsThrown(T nullReference) where T : class { Action act = () => nullReference.MustNotBeNullReference(nameof(nullReference)); act.Should().Throw() .And.Message.Should().Contain($"{nameof(nullReference)} must not be null."); } [Theory] [InlineData(42)] [InlineData(true)] [InlineData(false)] [InlineData(ConsoleColor.Cyan)] public static void ValueType(T value) where T : struct => value.MustNotBeNullReference().Should().Be(value); [Theory] [InlineData("Foo")] [InlineData("Bar")] public static void ReferenceNotNull(string reference) => reference.MustNotBeNullReference().Should().BeSameAs(reference); [Fact] public static void CustomException() => Test.CustomException(exceptionFactory => ((object) null).MustNotBeNullReference(exceptionFactory)); [Fact] public static void CustomExceptionNotNull() => "Foo".MustNotBeNullReference(() => null).Should().BeSameAs("Foo"); [Fact] public static void CustomExceptionValueType() => ConsoleColor.DarkGreen.MustNotBeNullReference(() => null).Should().Be(ConsoleColor.DarkGreen); [Fact] public static void CustomMessage() => Test.CustomMessage(message => ((object) null).MustNotBeNullReference(message: message)); [Fact] public static void CallerArgumentExpression() { var someParameter = (object) null; // ReSharper disable once ExpressionIsAlwaysNull -- I want to check the CallerArgumentExpressionAttribute here Action act = () => someParameter.MustNotBeNullReference(); act.Should().Throw() .WithParameterName(nameof(someParameter)); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CommonAssertions/MustNotBeNullTests.cs000066400000000000000000000030221470750352700322240ustar00rootroot00000000000000using System; using FluentAssertions; using Xunit; namespace Light.GuardClauses.Tests.CommonAssertions; public static class MustNotBeNullTests { [Fact] public static void ReferenceIsNull() { const string parameterName = "Foo"; Action act = () => ((object) null).MustNotBeNull(parameterName); var exceptionAssertion = act.Should().Throw().And; exceptionAssertion.Message.Should().Contain($"{parameterName} must not be null."); exceptionAssertion.ParamName.Should().BeSameAs(parameterName); } [Fact] public static void ReferenceIsNotNull() => string.Empty.MustNotBeNull().Should().BeSameAs(string.Empty); [Fact] public static void CustomException() => Test.CustomException(exceptionFactory => ((string) null).MustNotBeNull(exceptionFactory)); [Fact] public static void CustomExceptionParameterNotNull() => "Foo".MustNotBeNull(() => null).Should().BeSameAs("Foo"); [Fact] public static void CustomMessage() => Test.CustomMessage(message => ((object) null).MustNotBeNull(message: message)); [Fact] public static void CallerArgumentExpression() { var someParameter = (string) null; // ReSharper disable once ExpressionIsAlwaysNull -- I want someParameter to be the implicit parameterName Action act = () => someParameter.MustNotBeNull(); act.Should().Throw() .WithParameterName(nameof(someParameter)); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CommonAssertions/MustNotBeSameAsTests.cs000066400000000000000000000027411470750352700324720ustar00rootroot00000000000000using System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.CommonAssertions; public static class MustNotBeSameAsTests { [Theory] [InlineData("Foo")] [InlineData("Bar")] public static void ReferencesEqual(string reference) { Action act = () => reference.MustNotBeSameAs(reference, nameof(reference)); act.Should().Throw() .And.Message.Should().Contain($"{nameof(reference)} must not point to object \"{reference}\", but it actually does."); } [Theory] [InlineData("Hello", "World")] [InlineData("1", "2")] public static void ReferencesDifferent(string first, string second) { var result = first.MustNotBeSameAs(second); result.Should().Be(first); } [Fact] public static void CustomException() => Test.CustomException("Baz", (reference, exceptionFactory) => reference.MustNotBeSameAs(reference, exceptionFactory)); [Fact] public static void CustomMessage() => Test.CustomMessage(message => "Qux".MustNotBeSameAs("Qux", message: message)); [Fact] public static void CallerArgumentExpression() { var object1 = new object(); Action act = () => object1.MustNotBeSameAs(object1); act.Should().Throw() .WithParameterName(nameof(object1)); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/CommonAssertions/MustNotBeTests.cs000066400000000000000000000065701470750352700314040ustar00rootroot00000000000000using System; using System.Collections.Generic; using FluentAssertions; using Light.GuardClauses.Exceptions; using Light.GuardClauses.FrameworkExtensions; using Xunit; namespace Light.GuardClauses.Tests.CommonAssertions; public static class MustNotBeTests { [Theory] [InlineData("Qux")] [InlineData("Foo")] public static void ValuesEqual(string value) { Action act = () => value.MustNotBe(value, nameof(value)); act.Should().Throw() .And.Message.Should().Contain($"{nameof(value)} must not be equal to {value.ToStringOrNull()}, but it actually is {value.ToStringOrNull()}."); } [Theory] [InlineData(42, 43)] [InlineData(34, -153)] public static void ValuesNotEqual(int x, int y) => x.MustNotBe(y).Should().Be(x); [Fact] public static void CustomException() => Test.CustomException("Foo", "Foo", (x, y, exceptionFactory) => x.MustNotBe(y, exceptionFactory)); [Fact] public static void CustomExceptionNotEqual() => 42.MustNotBe(43, (_, _) => null).Should().Be(42); [Fact] public static void CustomMessage() => Test.CustomMessage(message => false.MustNotBe(false, message: message)); [Fact] public static void ValuesNotEqualCustomEqualityComparer() { var myString = "Foo"; Action act = () => myString.MustNotBe("Foo", new EqualityComparerStub(true)); act.Should().Throw() .And.Message.Should().Contain($"myString must not be equal to {"Foo".ToStringOrNull()}, but it actually is {"Foo".ToStringOrNull()}."); } [Fact] public static void ValuesEqualCustomEqualityComparer() => 42.MustNotBe(47, new EqualityComparerStub(false)).Should().Be(42); [Fact] public static void CustomExceptionEqualityComparer() => Test.CustomException("Foo", "Bar", (IEqualityComparer) new EqualityComparerStub(true), (x, y, comparer, exceptionFactory) => x.MustNotBe(y, comparer, exceptionFactory)); [Fact] public static void CustomExceptionCustomComparerNotEqual() => "Foo".MustNotBe("Bar", new EqualityComparerStub(false), (_, _, _) => null).Should().BeSameAs("Foo"); [Fact] public static void CustomMessageEqualityComparer() => Test.CustomMessage(message => 50m.MustNotBe(50m, new EqualityComparerStub(true), message: message)); [Fact] public static void CustomMessageComparerNull() => // ReSharper disable once AssignNullToNotNullAttribute Test.CustomMessage(message => 42.MustNotBe(89, (IEqualityComparer) null, message: message)); [Fact] public static void CallerArgumentExpression() { var eight = 8; Action act = () => eight.MustNotBe(8); act.Should().Throw() .WithParameterName(nameof(eight)); } [Fact] public static void CallerArgumentExpressionForEqualityComparerOverload() { var foo = "Foo"; Action act = () => foo.MustNotBe("Foo", new EqualityComparerStub(true)); act.Should().Throw() .WithParameterName(nameof(foo)); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/ComparableAssertions/000077500000000000000000000000001470750352700267575ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/ComparableAssertions/IsInTests.cs000066400000000000000000000012411470750352700311710ustar00rootroot00000000000000using FluentAssertions; using Xunit; namespace Light.GuardClauses.Tests.ComparableAssertions; public static class IsInTests { [Fact] public static void IsInRange() => 42.IsIn(Range.FromInclusive(42).ToExclusive(50)).Should().BeTrue(); [Fact] public static void NotInRange() => 50.775.IsIn(Range.FromExclusive(25.0).ToExclusive(50.00)).Should().BeFalse(); [Fact] public static void NonGenericIsInRange() => 187.5f.IsIn(Range.FromInclusive(20f).ToExclusive(250f)).Should().BeTrue(); [Fact] public static void NonGenericNotInRange() => 75.IsIn(Range.FromInclusive(10).ToExclusive(30)).Should().BeFalse(); }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/ComparableAssertions/IsNotInTests.cs000066400000000000000000000012371470750352700316570ustar00rootroot00000000000000using FluentAssertions; using Xunit; namespace Light.GuardClauses.Tests.ComparableAssertions; public static class IsNotInTests { [Fact] public static void NotInRange() => 'A'.IsNotIn(Range.FromInclusive('a').ToInclusive('z')).Should().BeTrue(); [Fact] public static void InRange() => 42.IsNotIn(Range.FromInclusive(30).ToExclusive(43)).Should().BeFalse(); [Fact] public static void NonGenericNotInRange() => 55.IsNotIn(Range.FromInclusive(50).ToInclusive(54)).Should().BeTrue(); [Fact] public static void NonGenericInRange() => 97.IsNotIn(Range.FromInclusive(97).ToExclusive(100)).Should().BeFalse(); }MustBeGreaterThanOrEqualToTests.cs000066400000000000000000000042241470750352700353740ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/ComparableAssertionsusing System; using FluentAssertions; using Xunit; namespace Light.GuardClauses.Tests.ComparableAssertions; public static class MustBeGreaterThanOrEqualToTests { [Theory] [InlineData(2, 1)] [InlineData(1, 1)] [InlineData(-87, -88)] public static void ParameterAtOrAboveBoundary(int value, int boundary) { Action act = () => value.MustNotBeGreaterThanOrEqualTo(boundary, nameof(value)); var exceptionAssertion = act.Should().Throw().Which; exceptionAssertion.Message.Should().Contain($"{nameof(value)} must not be greater than or equal to {boundary}, but it actually is {value}."); exceptionAssertion.ParamName.Should().BeSameAs(nameof(value)); } [Theory] [InlineData(0L, 1L)] [InlineData(-80L, -70L)] public static void ParameterBelowBoundary(long value, long boundary) => value.MustNotBeGreaterThanOrEqualTo(boundary).Should().Be(value); [Fact] public static void CustomException() => Test.CustomException('A', 'G', (a, g, exceptionFactory) => a.MustBeGreaterThanOrEqualTo(g, exceptionFactory)); [Fact] public static void CustomExceptionParameterNull() => Test.CustomException((string) null, "Foo", (x, y, exceptionFactory) => x.MustBeGreaterThanOrEqualTo(y, exceptionFactory)); [Fact] public static void NoCustomExceptionThrown() => 5m.MustNotBeGreaterThanOrEqualTo(5.1m, (_, _) => null).Should().Be(5m); [Fact] public static void CustomMessage() => Test.CustomMessage(message => 99.MustBeGreaterThanOrEqualTo(100, message: message)); [Fact] public static void CustomMessageParameterNull() => Test.CustomMessage(message => ((string) null).MustBeGreaterThanOrEqualTo("Bar", message: message)); [Fact] public static void CallerArgumentExpression() { var threePointThree = 3.3; Action act = () => threePointThree.MustBeGreaterThanOrEqualTo(5.0); act.Should().Throw() .WithParameterName(nameof(threePointThree)); } }MustBeGreaterThanTests.cs000066400000000000000000000041241470750352700335770ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/ComparableAssertionsusing System; using FluentAssertions; using Xunit; namespace Light.GuardClauses.Tests.ComparableAssertions; public static class MustBeGreaterThanTests { [Theory] [InlineData(1, 1)] [InlineData(1, 2)] [InlineData(-1, -1)] [InlineData(0, 0)] public static void ParameterEqualOrLess(int first, int second) { Action act = () => first.MustBeGreaterThan(second, nameof(first)); var exceptionAssertion = act.Should().Throw().Which; exceptionAssertion.Message.Should().Contain($"{nameof(first)} must be greater than {second}, but it actually is {first}."); exceptionAssertion.ParamName.Should().BeSameAs(nameof(first)); } [Theory] [InlineData(133, 99)] [InlineData(int.MaxValue, int.MaxValue - 1)] [InlineData(byte.MaxValue, byte.MinValue)] public static void ParameterGreater(int first, int second) => first.MustBeGreaterThan(second).Should().Be(first); [Fact] public static void CustomException() => Test.CustomException(40, 50, (x, y, exceptionFactory) => x.MustBeGreaterThan(y, exceptionFactory)); [Fact] public static void CustomExceptionParameterNull() => Test.CustomException((string) null, "Foo", (x, y, exceptionFactory) => x.MustBeGreaterThan(y, exceptionFactory)); [Fact] public static void NoCustomExceptionThrown() => 5.6m.MustBeGreaterThan(5.1m, (_, _) => null).Should().Be(5.6m); [Fact] public static void CustomMessage() => Test.CustomMessage(message => 100.MustBeGreaterThan(100, message: message)); [Fact] public static void CustomMessageParameterNull() => Test.CustomMessage(message => ((string) null).MustBeGreaterThan("Bar", message: message)); [Fact] public static void CallerArgumentExpression() { var fifteen = 15; Action act = () => fifteen.MustBeGreaterThan(20); act.Should().Throw() .WithParameterName(nameof(fifteen)); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/ComparableAssertions/MustBeInTests.cs000066400000000000000000000067041470750352700320260ustar00rootroot00000000000000using System; using FluentAssertions; using Xunit; namespace Light.GuardClauses.Tests.ComparableAssertions; public static class MustBeInTests { [Theory] [InlineData(-1, 1, 5)] [InlineData(5, 1, 5)] [InlineData(6, 1, 5)] public static void ParameterOutOfInclusiveLowerAndExclusiveUpperBoundary(int value, int lowerBoundary, int upperBoundary) { Action act = () => value.MustBeIn(Range.FromInclusive(lowerBoundary).ToExclusive(upperBoundary), nameof(value)); var assertion = act.Should().Throw().Which; assertion.Message.Should().Contain($"{nameof(value)} must be between {lowerBoundary} (inclusive) and {upperBoundary} (exclusive), but it actually is {value}."); assertion.ParamName.Should().Be(nameof(value)); } [Theory] [InlineData(0, 1, 5)] [InlineData(1, 1, 5)] [InlineData(6, 1, 5)] [InlineData('a', 'b', 'f')] [InlineData('b', 'b', 'f')] [InlineData('g', 'b', 'f')] public static void ParameterOutOfExclusiveLowerAndInclusiveUpperBoundary(char value, char lowerBoundary, char upperBoundary) { Action act = () => value.MustBeIn(Range.FromExclusive(lowerBoundary).ToInclusive(upperBoundary), nameof(value)); var assertion = act.Should().Throw().Which; assertion.Message.Should().Contain($"{nameof(value)} must be between {lowerBoundary} (exclusive) and {upperBoundary} (inclusive), but it actually is {value}."); assertion.ParamName.Should().Be(nameof(value)); } [Theory] [InlineData(10, 10, 20, true, true)] [InlineData(20, 10, 20, true, true)] [InlineData(11, 10, 20, true, false)] [InlineData(11, 10, 20, false, false)] [InlineData(19, 10, 20, false, false)] public static void ParameterWithinRange(int value, int lowerBoundary, int upperBoundary, bool isLowerBoundaryInclusive, bool isUpperBoundaryInclusive) { var range = new Range(lowerBoundary, upperBoundary, isLowerBoundaryInclusive, isUpperBoundaryInclusive); var result = value.MustBeIn(range, nameof(value)); result.Should().Be(value); } [Fact] public static void CustomException() => Test.CustomException(50, new Range(15, 25), (x, range, exceptionFactory) => x.MustBeIn(range, exceptionFactory)); [Fact] public static void CustomExceptionParameterNull() => Test.CustomException((string) null, new Range("a", "f"), (s, range, exceptionFactory) => s.MustBeIn(range, exceptionFactory)); [Fact] public static void NoCustomExceptionThrown() => 5.6m.MustBeIn(Range.FromInclusive(0m).ToExclusive(100m), (_, _) => null).Should().Be(5.6m); [Fact] public static void CustomMessage() => Test.CustomMessage(message => 'A'.MustBeIn(Range.FromInclusive('a').ToInclusive('z'), message: message)); [Fact] public static void CustomMessageParameterNull() => Test.CustomMessage(message => ((string) null).MustBeIn(Range.FromInclusive("A").ToExclusive("Z"), message: message)); [Fact] public static void CallerArgumentExpression() { var twenty = 20; Action act = () => twenty.MustBeIn(Range.FromInclusive(10).ToInclusive(15)); act.Should().Throw() .WithParameterName(nameof(twenty)); } }MustBeLessThanOrEqualToTests.cs000066400000000000000000000040201470750352700347030ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/ComparableAssertionsusing System; using FluentAssertions; using Xunit; namespace Light.GuardClauses.Tests.ComparableAssertions; public static class MustBeLessThanOrEqualToTests { [Theory] [InlineData(10, 9)] [InlineData(-42, -1888)] public static void ParameterGreater(int first, int second) { Action act = () => first.MustBeLessThanOrEqualTo(second, nameof(first)); var exceptionAssertion = act.Should().Throw().Which; exceptionAssertion.Message.Should().Contain($"{nameof(first)} must be less than or equal to {second}, but it actually is {first}."); exceptionAssertion.ParamName.Should().BeSameAs(nameof(first)); } [Theory] [InlineData(13, 13)] [InlineData(12, 13)] public static void ParameterLessOrEqual(int first, int second) => first.MustBeLessThanOrEqualTo(second).Should().Be(first); [Fact] public static void CustomException() => Test.CustomException(20, 19, (x, y, exceptionFactory) => x.MustBeLessThanOrEqualTo(y, exceptionFactory)); [Fact] public static void CustomExceptionParameterNull() => Test.CustomException((string) null, "Foo", (x, y, exceptionFactory) => x.MustBeLessThanOrEqualTo(y, exceptionFactory)); [Fact] public static void NoCustomExceptionThrown() => 5m.MustBeLessThanOrEqualTo(5.1m, (_, _) => null).Should().Be(5m); [Fact] public static void CustomMessage() => Test.CustomMessage(message => 'c'.MustBeLessThanOrEqualTo('a', message: message)); [Fact] public static void CustomMessageParameterNull() => Test.CustomMessage(message => ((string) null).MustBeLessThanOrEqualTo("Bar", message: message)); [Fact] public static void CallerArgumentExpression() { var six = 6; Action act = () => six.MustBeLessThanOrEqualTo(5); act.Should().Throw() .WithParameterName(nameof(six)); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/ComparableAssertions/MustBeLessThanTests.cs000066400000000000000000000041131470750352700331710ustar00rootroot00000000000000using System; using FluentAssertions; using Xunit; namespace Light.GuardClauses.Tests.ComparableAssertions; public static class MustBeLessThanTests { [Theory] [InlineData(2, 1)] [InlineData(2, 2)] [InlineData(short.MaxValue, short.MinValue)] [InlineData('Z', 'Z')] public static void ParameterNotLess(int first, int second) { Action act = () => first.MustBeLessThan(second, nameof(first)); var exceptionAssertion = act.Should().Throw().Which; exceptionAssertion.Message.Should().Contain($"{nameof(first)} must be less than {second}, but it actually is {first}."); exceptionAssertion.ParamName.Should().BeSameAs(nameof(first)); } [Theory] [InlineData(1L, 2L)] [InlineData(-444L, -410L)] [InlineData(long.MinValue, long.MinValue + 14)] [InlineData('A', 'a')] public static void ParameterLess(long first, long second) => first.MustBeLessThan(second).Should().Be(first); [Fact] public static void CustomException() => Test.CustomException("Z", "A", (z, a, exceptionFactory) => z.MustBeLessThan(a, exceptionFactory)); [Fact] public static void CustomExceptionParameterNull() => Test.CustomException((string) null, "Foo", (x, y, exceptionFactory) => x.MustBeLessThan(y, exceptionFactory)); [Fact] public static void NoCustomExceptionThrown() => 5m.MustBeLessThan(5.1m, (_, _) => null).Should().Be(5m); [Fact] public static void CustomMessage() => Test.CustomMessage(message => 40.MustBeLessThan(10, message: message)); [Fact] public static void CustomMessageParameterNull() => Test.CustomMessage(message => ((string) null).MustBeLessThan("Bar", message: message)); [Fact] public static void CallerArgumentExpression() { var ten = 10; Action act = () => ten.MustBeLessThan(7); act.Should().Throw() .WithParameterName(nameof(ten)); } }MustNotBeGreaterThanOrEqualToTests.cs000066400000000000000000000042021470750352700360510ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/ComparableAssertionsusing System; using FluentAssertions; using Xunit; namespace Light.GuardClauses.Tests.ComparableAssertions; public static class MustNotBeGreaterThanOrEqualToTests { [Theory] [InlineData(2, 1)] [InlineData(1, 1)] [InlineData(-87, -88)] public static void ParameterAtOrAboveBoundary(int value, int boundary) { Action act = () => value.MustNotBeGreaterThanOrEqualTo(boundary, nameof(value)); var exceptionAssertion = act.Should().Throw().Which; exceptionAssertion.Message.Should().Contain($"{nameof(value)} must not be greater than or equal to {boundary}, but it actually is {value}."); exceptionAssertion.ParamName.Should().BeSameAs(nameof(value)); } [Theory] [InlineData(0L, 1L)] [InlineData(-80L, -70L)] public static void ParameterBelowBoundary(long value, long boundary) => value.MustNotBeGreaterThanOrEqualTo(boundary).Should().Be(value); [Fact] public static void CustomException() => Test.CustomException(20, 10, (x, y, exceptionFactory) => x.MustNotBeGreaterThanOrEqualTo(y, exceptionFactory)); [Fact] public static void CustomExceptionParameterNull() => Test.CustomException((string) null, "Foo", (x, y, exceptionFactory) => x.MustNotBeGreaterThanOrEqualTo(y, exceptionFactory)); [Fact] public static void NoCustomExceptionThrown() => 5m.MustNotBeGreaterThanOrEqualTo(5.1m, (_, _) => null).Should().Be(5m); [Fact] public static void CustomMessage() => Test.CustomMessage(message => 300.MustNotBeGreaterThanOrEqualTo(300, message: message)); [Fact] public static void CustomMessageParameterNull() => Test.CustomMessage(message => ((string) null).MustNotBeGreaterThanOrEqualTo("Bar", message: message)); [Fact] public static void CallerArgumentExpression() { var four = 4; Action act = () => four.MustNotBeGreaterThanOrEqualTo(4); act.Should().Throw() .WithParameterName(nameof(four)); } }MustNotBeGreaterThanTests.cs000066400000000000000000000041061470750352700342600ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/ComparableAssertionsusing System; using FluentAssertions; using Xunit; namespace Light.GuardClauses.Tests.ComparableAssertions; public static class MustNotBeGreaterThanTests { [Theory] [InlineData(1, 0)] [InlineData(1, -1)] [InlineData(-88, -100)] public static void ParameterAboveBoundary(int value, int boundary) { Action act = () => value.MustNotBeGreaterThan(boundary, nameof(value)); var exceptionAssertion = act.Should().Throw().Which; exceptionAssertion.Message.Should().Contain($"{nameof(value)} must not be greater than {boundary}, but it actually is {value}."); exceptionAssertion.ParamName.Should().BeSameAs(nameof(value)); } [Theory] [InlineData(0, 0)] [InlineData(-1, 0)] [InlineData(-88, 0)] public static void ParameterAtOrBelowBoundary(short value, short boundary) => value.MustNotBeGreaterThan(boundary, nameof(value)).Should().Be(value); [Fact] public static void CustomException() => Test.CustomException(15, 10, (x, y, exceptionFactory) => x.MustNotBeGreaterThan(y, exceptionFactory)); [Fact] public static void CustomExceptionParameterNull() => Test.CustomException((string) null, "Foo", (x, y, exceptionFactory) => x.MustNotBeGreaterThan(y, exceptionFactory)); [Fact] public static void NoCustomExceptionThrown() => 5m.MustNotBeGreaterThan(5.1m, (_, _) => null).Should().Be(5m); [Fact] public static void CustomMessage() => Test.CustomMessage(message => 21.MustNotBeGreaterThan(20, message: message)); [Fact] public static void CustomMessageParameterNull() => Test.CustomMessage(message => ((string) null).MustNotBeGreaterThan("Bar", message: message)); [Fact] public static void CallerArgumentExpression() { var five = 5; Action act = () => five.MustNotBeGreaterThan(2); act.Should().Throw() .WithParameterName(nameof(five)); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/ComparableAssertions/MustNotBeInTests.cs000066400000000000000000000071001470750352700324760ustar00rootroot00000000000000using System; using FluentAssertions; using Xunit; namespace Light.GuardClauses.Tests.ComparableAssertions; public static class MustNotBeInTests { [Theory] [InlineData(1, 1, 5)] [InlineData(2, 1, 5)] [InlineData(4, 1, 5)] [InlineData('b', 'b', 'f')] [InlineData('c', 'b', 'f')] [InlineData('e', 'b', 'f')] public static void ParameterWithinInclusiveLowerAndExclusiveUpperBoundary(int value, int lowerBoundary, int upperBoundary) { Action act = () => value.MustNotBeIn(Range.FromInclusive(lowerBoundary).ToExclusive(upperBoundary), nameof(value)); var assertion = act.Should().Throw().Which; assertion.Message.Should().Contain($"{nameof(value)} must not be between {lowerBoundary} (inclusive) and {upperBoundary} (exclusive), but it actually is {value}."); assertion.ParamName.Should().BeSameAs(nameof(value)); } [Theory] [InlineData(2, 1, 5)] [InlineData(4, 1, 5)] [InlineData(5, 1, 5)] [InlineData('c', 'b', 'f')] [InlineData('d', 'b', 'f')] [InlineData('f', 'b', 'f')] public static void ParameterWithinExclusiveLowerAndInclusiveUpperBoundary(short value, short lowerBoundary, short upperBoundary) { Action act = () => value.MustNotBeIn(Range.FromExclusive(lowerBoundary).ToInclusive(upperBoundary), nameof(value)); var assertion = act.Should().Throw().Which; assertion.Message.Should().Contain($"{nameof(value)} must not be between {lowerBoundary} (exclusive) and {upperBoundary} (inclusive), but it actually is {value}."); assertion.ParamName.Should().BeSameAs(nameof(value)); } [Theory] [InlineData(9, 10, 20, true, true)] [InlineData(21, 10, 20, true, true)] [InlineData(20, 10, 20, true, false)] [InlineData(10, 10, 20, false, false)] [InlineData(181, 10, 20, false, false)] public static void ParameterOutOfRange(int value, int lowerBoundary, int upperBoundary, bool isLowerBoundaryInclusive, bool isUpperBoundaryInclusive) { var range = new Range(lowerBoundary, upperBoundary, isLowerBoundaryInclusive, isUpperBoundaryInclusive); var result = value.MustNotBeIn(range, nameof(value)); result.Should().Be(value); } [Fact] public static void CustomException() => Test.CustomException(12, new Range(10, 15), (x, range, exceptionFactory) => x.MustNotBeIn(range, exceptionFactory)); [Fact] public static void CustomExceptionParameterNull() => Test.CustomException((string) null, Range.FromInclusive("a").ToInclusive("m"), (s, range, exceptionFactory) => s.MustNotBeIn(range, exceptionFactory)); [Fact] public static void NoCustomExceptionThrown() => (-15400.8m).MustNotBeIn(Range.FromInclusive(0m).ToExclusive(100m), (_, _) => null).Should().Be(-15400.8m); [Fact] public static void CustomMessage() => Test.CustomMessage(message => 42.MustNotBeIn(new Range(20, 60), message: message)); [Fact] public static void CustomMessageParameterNull() => Test.CustomMessage(message => ((string) null).MustNotBeIn(new Range("a", "z"), message: message)); [Fact] public static void CallerArgumentExpression() { var two = 2; Action act = () => two.MustNotBeIn(Range.FromInclusive(1).ToInclusive(5)); act.Should().Throw() .WithParameterName(nameof(two)); } }MustNotBeLessThanOrEqualToTests.cs000066400000000000000000000042771470750352700354020ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/ComparableAssertionsusing System; using FluentAssertions; using Xunit; namespace Light.GuardClauses.Tests.ComparableAssertions; public static class MustNotBeLessThanOrEqualToTests { [Theory] [InlineData(-1, 0)] [InlineData(0, 0)] [InlineData(-80, -40)] public static void ParameterAtOrBelowBoundary(int value, int boundary) { Action act = () => value.MustNotBeLessThanOrEqualTo(boundary, nameof(value)); var exceptionAssertion = act.Should().Throw().Which; exceptionAssertion.Message.Should().Contain($"{nameof(value)} must not be less than or equal to {boundary}, but it actually is {value}."); exceptionAssertion.ParamName.Should().BeSameAs(nameof(value)); } [Theory] [InlineData(5L, 4L)] [InlineData(100L, 1L)] [InlineData(-87L, -90L)] public static void ParameterAboveBoundary(long value, long boundary) { var result = value.MustNotBeLessThanOrEqualTo(boundary, nameof(value)); result.Should().Be(value); } [Fact] public static void CustomException() => Test.CustomException(15, 16, (x, y, exceptionFactory) => x.MustNotBeLessThanOrEqualTo(y, exceptionFactory)); [Fact] public static void CustomExceptionParameterNull() => Test.CustomException((string) null, "Foo", (x, y, exceptionFactory) => x.MustNotBeLessThanOrEqualTo(y, exceptionFactory)); [Fact] public static void NoCustomExceptionThrown() => 5.6m.MustNotBeLessThanOrEqualTo(5.1m, (_, _) => null).Should().Be(5.6m); [Fact] public static void CustomMessage() => Test.CustomMessage(message => 15.MustNotBeLessThanOrEqualTo(15, message: message)); [Fact] public static void CustomMessageParameterNull() => Test.CustomMessage(message => ((string) null).MustNotBeLessThanOrEqualTo("Bar", message: message)); [Fact] public static void CallerArgumentExpression() { var nine = 9; Action act = () => nine.MustNotBeLessThanOrEqualTo(12); act.Should().Throw() .WithParameterName(nameof(nine)); } }MustNotBeLessThanTests.cs000066400000000000000000000046261470750352700336040ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/ComparableAssertionsusing System; using FluentAssertions; using Xunit; namespace Light.GuardClauses.Tests.ComparableAssertions; public static class MustNotBeLessThanTests { [Theory] [InlineData(1, 2)] [InlineData(-87, 2)] public static void ParameterBelowBoundary(int value, int boundary) { Action act = () => value.MustNotBeLessThan(boundary, nameof(value)); var exceptionAssertion = act.Should().Throw().Which; exceptionAssertion.Message.Should().Contain($"{nameof(value)} must not be less than {boundary}, but it actually is {value}."); exceptionAssertion.ParamName.Should().BeSameAs(nameof(value)); } [Theory] [InlineData(1, 0)] [InlineData(42, 42)] [InlineData(-87, -88)] public static void ParameterAtOrAboveBoundary(short value, short boundary) => value.MustNotBeLessThan(boundary, nameof(value)).Should().Be(value); [Fact] public static void ParameterNull() { // ReSharper disable once ExplicitCallerInfoArgument Action act = () => ((string) null).MustNotBeLessThan("Foo", "Bar"); act.Should().Throw() .And.ParamName.Should().BeSameAs("Bar"); } [Fact] public static void OtherStringNull() => "abc".MustNotBeLessThan(null).Should().Be("abc"); [Fact] public static void CustomException() => Test.CustomException(99, 100, (x, y, exceptionFactory) => x.MustNotBeLessThan(y, exceptionFactory)); [Fact] public static void CustomExceptionParameterNull() => Test.CustomException(null, "abc", (x, y, exceptionFactory) => x.MustNotBeLessThan(y, exceptionFactory)); [Fact] public static void CustomExceptionParameterValid() => 42.MustNotBeLessThan(40, (_, _) => null).Should().Be(42); [Fact] public static void CustomMessage() => Test.CustomMessage(message => 'a'.MustNotBeLessThan('b', message: message)); [Fact] public static void CustomMessageParameterNull() => Test.CustomMessage(message => ((string) null).MustNotBeLessThan("a", message: message)); [Fact] public static void CallerArgumentExpression() { var seventeen = 17; Action act = () => seventeen.MustNotBeLessThan(20); act.Should().Throw() .WithParameterName(nameof(seventeen)); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/ComparableAssertions/RangeTests.cs000066400000000000000000000170711470750352700313730ustar00rootroot00000000000000using System; using System.Collections; using System.Collections.Generic; using System.Collections.ObjectModel; using System.Linq; using FluentAssertions; using Light.GuardClauses.FrameworkExtensions; using Xunit; namespace Light.GuardClauses.Tests.ComparableAssertions; public static class RangeTests { [Theory] [InlineData(0, 5, 0, true, true)] [InlineData(0, 5, 5, false, true)] [InlineData(0, 5, 4, false, false)] [InlineData(0, 5, 1, false, false)] [InlineData(-4, 4, 0, false, false)] [InlineData(42, 80, 42, true, false)] public static void ValueInRange(long from, long to, long value, bool isFromInclusive, bool isToInclusive) { var testTarget = new Range(from, to, isFromInclusive, isToInclusive); var result = testTarget.IsValueWithinRange(value); result.Should().BeTrue(); } [Theory] [InlineData(0, 5, -1, true, true)] [InlineData(0, 5, 6, false, true)] [InlineData(0, 5, 5, false, false)] [InlineData(0, 5, 0, false, false)] [InlineData(-4, 4, -80, false, false)] [InlineData(42, 80, 42, false, false)] public static void ValueOutOfRange(int from, int to, int value, bool isFromInclusive, bool isToInclusive) { var testTarget = new Range(from, to, isFromInclusive, isToInclusive); var result = testTarget.IsValueWithinRange(value); result.Should().BeFalse(); } [Theory] [InlineData(1, 0)] [InlineData(42, -1)] [InlineData(-87, -88)] public static void ConstructorException(int from, int to) { Action act = () => Range.FromInclusive(from).ToExclusive(to); act.Should().Throw().And .Message.Should().Contain($"{nameof(to)} must not be less than {from}, but it actually is {to}."); } [Theory] [InlineData(0, 10, 0)] // Lower boundary [InlineData(0, 10, 5)] // Middle value [InlineData(0, 10, 10)] // Upper boundary public static void InclusiveBetween_ValuesInRange(int from, int to, int value) { var range = Range.InclusiveBetween(from, to); var result = range.IsValueWithinRange(value); result.Should().BeTrue(); } [Theory] [InlineData(0, 10, -1)] // Below range [InlineData(0, 10, 11)] // Above range public static void InclusiveBetween_ValuesOutOfRange(int from, int to, int value) { var range = Range.InclusiveBetween(from, to); var result = range.IsValueWithinRange(value); result.Should().BeFalse(); } [Theory] [InlineData(0, 10, 1)] // Just above lower boundary [InlineData(0, 10, 5)] // Middle value [InlineData(0, 10, 9)] // Just below upper boundary public static void ExclusiveBetween_ValuesInRange(int from, int to, int value) { var range = Range.ExclusiveBetween(from, to); var result = range.IsValueWithinRange(value); result.Should().BeTrue(); } [Theory] [InlineData(0, 10, 0)] // Lower boundary [InlineData(0, 10, 10)] // Upper boundary [InlineData(0, 10, -1)] // Below range [InlineData(0, 10, 11)] // Above range public static void ExclusiveBetween_ValuesOutOfRange(int from, int to, int value) { var range = Range.ExclusiveBetween(from, to); var result = range.IsValueWithinRange(value); result.Should().BeFalse(); } [Theory] [InlineData(10, 5)] // To less than From [InlineData(-5, -10)] // Negative To less than From public static void InclusiveBetween_InvalidRange_ThrowsException(int from, int to) { Action inclusiveAct = () => Range.InclusiveBetween(from, to); inclusiveAct.Should().Throw() .And.Message.Should().Contain($"{nameof(to)} must not be less than {from}"); } [Theory] [InlineData(10, 5)] // To less than From [InlineData(-5, -10)] // Negative To less than From public static void ExclusiveBetween_InvalidRange_ThrowsException(int from, int to) { Action exclusiveAct = () => Range.ExclusiveBetween(from, to); exclusiveAct.Should().Throw() .And.Message.Should().Contain($"{nameof(to)} must not be less than {from}"); } [Theory] [MemberData(nameof(Collections))] public static void RangeForCollections(IEnumerable enumerable) { // ReSharper disable PossibleMultipleEnumeration var range = Range.For(enumerable); var expectedRange = new Range(0, enumerable.Count(), true, false); range.Should().Be(expectedRange); // ReSharper restore PossibleMultipleEnumeration } public static readonly TheoryData Collections = new () { new List { 1, 2, 3, 4 }, "This is a long string", new[] { 'a', 'b', 'c', 'd' }, new ObservableCollection { 1, -1 }, new ArrayList() }; [Fact] public static void EnumerableNull() { // ReSharper disable once RedundantCast -- I want to specifically target the overload accepting IEnumerable var act = () => Range.For(((IEnumerable) null)!); act.Should().Throw().WithParameterName("enumerable"); } [Theory] [MemberData(nameof(GenericCollections))] public static void RangeForGenericCollections(IEnumerable enumerable) { // ReSharper disable PossibleMultipleEnumeration var range = Range.For(enumerable); var expectedRange = new Range(0, enumerable.Count(), true, false); range.Should().Be(expectedRange); // ReSharper restore PossibleMultipleEnumeration } public static readonly TheoryData> GenericCollections = new () { Array.Empty(), new List { 'a', 'b', 'c' }, "007", new ArraySegment(new[] { 'a' }) }; [Fact] public static void GenericEnumerableNull() { var act = () => Range.For(((IEnumerable) null)!); act.Should().Throw().WithParameterName("enumerable"); } [Theory] [MemberData(nameof(Memories))] public static void RangeForMemory(Memory memory) { var range = Range.For(memory); var expectedRange = new Range(0, memory.Length, true, false); range.Should().Be(expectedRange); } [Theory] [MemberData(nameof(Memories))] public static void RangeForReadOnlyMemory(Memory memory) { ReadOnlyMemory readOnlyMemory = memory; var range = Range.For(readOnlyMemory); var expectedRange = new Range(0, memory.Length, true, false); range.Should().Be(expectedRange); } [Theory] [MemberData(nameof(Memories))] public static void RangeForSpan(Memory memory) { var range = Range.For(memory.Span); var expectedRange = new Range(0, memory.Length, true, false); range.Should().Be(expectedRange); } [Theory] [MemberData(nameof(Memories))] public static void RangeForReadOnlySpan(Memory memory) { ReadOnlySpan readOnlySpan = memory.Span; var range = Range.For(readOnlySpan); var expectedRange = new Range(0, memory.Length, true, false); range.Should().Be(expectedRange); } public static readonly TheoryData> Memories = new () { new[] { 1, 2, 3, 4 }, Enumerable.Range(1, 500).ToArray(), Array.Empty() }; } Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/DateTimeAssertions/000077500000000000000000000000001470750352700264065ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/DateTimeAssertions/MustBeLocalTests.cs000066400000000000000000000032411470750352700321320ustar00rootroot00000000000000using System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.DateTimeAssertions; public static class MustBeLocalTests { [Fact] public static void NotLocal() { var invalidDateTime = DateTime.UtcNow; Action act = () => invalidDateTime.MustBeLocal(nameof(invalidDateTime)); act.Should().Throw() .And.Message.Should().Contain($"{nameof(invalidDateTime)} must use kind \"{DateTimeKind.Local}\", but it actually uses \"{invalidDateTime.Kind}\" and is \"{invalidDateTime:O}\"."); } [Fact] public static void Local() { var dateTime = DateTime.Now; dateTime.MustBeLocal().Should().Be(dateTime); } [Fact] public static void CustomException() => Test.CustomException(new DateTime(2018, 2, 18, 16, 57, 00, DateTimeKind.Utc), (value, exceptionFactory) => value.MustBeLocal(exceptionFactory)); [Fact] public static void NoCustomException() { var value = new DateTime(1989, 2, 5, 3, 32, 21, DateTimeKind.Local); var result = value.MustBeLocal(_ => null); result.Should().Be(value); } [Fact] public static void CustomMessage() => Test.CustomMessage(message => DateTime.UtcNow.MustBeLocal(message: message)); [Fact] public static void CallerArgumentExpression() { var invalidDateTime = DateTime.UtcNow; Action act = () => invalidDateTime.MustBeLocal(); act.Should().Throw() .WithParameterName(nameof(invalidDateTime)); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/DateTimeAssertions/MustBeUnspecifiedTests.cs000066400000000000000000000034621470750352700333430ustar00rootroot00000000000000using System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.DateTimeAssertions; public static class MustBeUnspecifiedTests { [Fact] public static void NotUnspecified() { var invalidDateTime = DateTime.UtcNow; Action act = () => invalidDateTime.MustBeUnspecified(nameof(invalidDateTime)); act.Should().Throw() .And.Message.Should().Contain($"{nameof(invalidDateTime)} must use kind \"{DateTimeKind.Unspecified}\", but it actually uses \"{invalidDateTime.Kind}\" and is \"{invalidDateTime:O}\"."); } [Fact] public static void Unspecified() { var dateTime = DateTime.MinValue; var result = dateTime.MustBeUnspecified(); result.Should().Be(dateTime); } [Fact] public static void CustomException() => Test.CustomException(new DateTime(2018, 2, 18, 16, 57, 00, DateTimeKind.Utc), (value, exceptionFactory) => value.MustBeUnspecified(exceptionFactory)); [Fact] public static void NoCustomException() { var value = new DateTime(2000, 9, 10, 15, 32, 47, DateTimeKind.Unspecified); var result = value.MustBeUnspecified(_ => null); result.Should().Be(value); } [Fact] public static void CustomMessage() => Test.CustomMessage(message => DateTime.UtcNow.MustBeUnspecified(message: message)); [Fact] public static void CallerArgumentExpression() { var invalidDateTime = new DateTime(2021, 11, 17, 20, 30, 0, DateTimeKind.Local); Action act = () => invalidDateTime.MustBeUnspecified(); act.Should().Throw() .WithParameterName(nameof(invalidDateTime)); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/DateTimeAssertions/MustBeUtcTests.cs000066400000000000000000000033321470750352700316340ustar00rootroot00000000000000using System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.DateTimeAssertions; public static class MustBeUtcTests { [Fact] public static void NotUtc() { var invalidDateTime = DateTime.Now; Action act = () => invalidDateTime.MustBeUtc(nameof(invalidDateTime)); act.Should().Throw() .And.Message.Should().Contain($"{nameof(invalidDateTime)} must use kind \"{DateTimeKind.Utc}\", but it actually uses \"{invalidDateTime.Kind}\" and is \"{invalidDateTime:O}\"."); } [Fact] public static void Utc() { var utcDateTime = DateTime.UtcNow; var result = utcDateTime.MustBeUtc(); result.Should().Be(utcDateTime); } [Fact] public static void CustomException() => Test.CustomException(new DateTime(2018, 2, 18, 16, 51, 00, DateTimeKind.Local), (value, exceptionFactory) => value.MustBeUtc(exceptionFactory)); [Fact] public static void NoCustomException() { var value = new DateTime(2016, 5, 31, 10, 0, 0, DateTimeKind.Utc); var result = value.MustBeUtc(_ => null); result.Should().Be(value); } [Fact] public static void CustomMessage() => Test.CustomMessage(message => DateTime.Now.MustBeUtc(message:message)); [Fact] public static void CallerArgumentExpression() { var invalidDateTime = new DateTime(2021, 11, 17, 18, 30, 0, DateTimeKind.Local); Action act = () => invalidDateTime.MustBeUtc(); act.Should().Throw() .WithParameterName(nameof(invalidDateTime)); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/DefaultVariablesData.cs000066400000000000000000000016751470750352700272060ustar00rootroot00000000000000using System.Collections.Generic; using System.Linq; using System.Reflection; using Xunit.Sdk; namespace Light.GuardClauses.Tests; public sealed class DefaultVariablesData : DataAttribute { public static readonly IReadOnlyList All = new[] { "Foo", "Bar", "Baz", "Qux", "Quux", "Corge", "Grault", "Garply", "Waldo", "Fred", "Plugh", "Xyzzy", "Thud" }; private static readonly List TransformedVariables = All.Select(variable => new object[] { variable }).ToList(); private readonly int _numberOfConstants; public DefaultVariablesData(int numberOfConstants = 3) => _numberOfConstants = numberOfConstants; public override IEnumerable GetData(MethodInfo testMethod) => TransformedVariables.Take(_numberOfConstants); }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/EqualityComparerStub.cs000066400000000000000000000006051470750352700273130ustar00rootroot00000000000000using System.Collections.Generic; namespace Light.GuardClauses.Tests; public sealed class EqualityComparerStub : IEqualityComparer { private readonly bool _equalsReturnValue; public EqualityComparerStub(bool equalsReturnValue) => _equalsReturnValue = equalsReturnValue; public bool Equals(T x, T y) => _equalsReturnValue; public int GetHashCode(T obj) => 0; }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/FrameworkExtensions/000077500000000000000000000000001470750352700266545ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/FrameworkExtensions/AsArrayTests.cs000066400000000000000000000031051470750352700315670ustar00rootroot00000000000000using System; using System.Collections.Generic; using System.Collections.ObjectModel; using FluentAssertions; using Light.GuardClauses.FrameworkExtensions; using Xunit; namespace Light.GuardClauses.Tests.FrameworkExtensions; public static class AsArrayTests { [Theory] [InlineData(new[] { 1, 2, 3 })] [InlineData(new[] { 89, 87 })] [InlineData(new int[] { })] public static void DowncastArray(int[] array) { var result = array.AsArray(); result.Should().BeSameAs(array); } [Theory] [MemberData(nameof(NotArrayData))] public static void CreateNewArray(IEnumerable enumerable) { // ReSharper disable PossibleMultipleEnumeration var result = enumerable.AsArray(); result.Should().NotBeSameAs(enumerable); result.Length.Should().Be(enumerable.Count()); result.Should().Equal(enumerable); // ReSharper restore PossibleMultipleEnumeration } [Fact] public static void EnumerableNull() { Action act = () => ((ObservableCollection) null)!.AsArray(); act.Should().Throw(); } public static readonly TheoryData> NotArrayData = new() { new List { "Foo", "Bar", "Baz" }, new ObservableCollection(), LazyStringCollection }; public static IEnumerable LazyStringCollection { get { yield return "Foo"; yield return "Baz"; yield return "Quux"; } } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/FrameworkExtensions/AsListTests.cs000066400000000000000000000045731470750352700314360ustar00rootroot00000000000000using System; using System.Collections.Generic; using System.Collections.ObjectModel; using FluentAssertions; using Light.GuardClauses.FrameworkExtensions; using Xunit; namespace Light.GuardClauses.Tests.FrameworkExtensions; public static class AsListTests { [Theory] [MemberData(nameof(ReturnsCastInstanceIfPossibleData))] public static void ReturnsCastInstanceIfPossible(IEnumerable enumerable) { // ReSharper disable PossibleMultipleEnumeration var list = enumerable.AsList(); list.Should().BeSameAs(enumerable); // ReSharper restore PossibleMultipleEnumeration } [Theory] [MemberData(nameof(ReturnsCastInstanceIfPossibleData))] public static void ReturnsCastInstanceIfPossibleWithCustomFactory(IEnumerable enumerable) { // ReSharper disable PossibleMultipleEnumeration var list = enumerable.AsList(items => new ObservableCollection(items)); list.Should().BeSameAs(enumerable); // ReSharper restore PossibleMultipleEnumeration } public static readonly TheoryData> ReturnsCastInstanceIfPossibleData = new() { new List { "Foo", "Bar" }, new[] { "Foo", "Bar", "Baz" }, new ObservableCollection() }; [Fact] public static void ReturnsNewListIfCastNotPossible() { // ReSharper disable PossibleMultipleEnumeration var enumerable = LazyEnumerable(); var list = enumerable.AsList(); list.Should().NotBeSameAs(enumerable); list.Should().BeOfType>(); list.Should().Equal(enumerable); // ReSharper restore PossibleMultipleEnumeration } [Fact] public static void EnumerableNull() { Action act = () => ((IEnumerable) null)!.AsList(); act.Should().Throw() .WithParameterName("source"); } [Fact] public static void CreateCollection() { var collection = LazyEnumerable().AsList(items => new ObservableCollection(items)); collection.Should().BeAssignableTo>(); collection.Should().Equal(LazyEnumerable()); } private static IEnumerable LazyEnumerable() { yield return "Foo"; yield return "Bar"; yield return "Baz"; } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/FrameworkExtensions/AsReadOnlyListTests.cs000066400000000000000000000047131470750352700330700ustar00rootroot00000000000000using System; using System.Collections.Generic; using System.Collections.ObjectModel; using FluentAssertions; using Light.GuardClauses.FrameworkExtensions; using Xunit; namespace Light.GuardClauses.Tests.FrameworkExtensions; public static class AsReadOnlyListTests { [Theory] [MemberData(nameof(ReturnsCastInstanceIfPossibleData))] public static void ReturnsCastInstanceIfPossible(IEnumerable enumerable) { // ReSharper disable PossibleMultipleEnumeration var readOnlyList = enumerable.AsReadOnlyList(); readOnlyList.Should().BeSameAs(enumerable); // ReSharper restore PossibleMultipleEnumeration } [Theory] [MemberData(nameof(ReturnsCastInstanceIfPossibleData))] public static void ReturnsCastInstanceIfPossibleWithCustomFactory(IEnumerable enumerable) { // ReSharper disable PossibleMultipleEnumeration var readOnlyList = enumerable.AsReadOnlyList(items => new ObservableCollection(items)); readOnlyList.Should().BeSameAs(enumerable); // ReSharper restore PossibleMultipleEnumeration } public static readonly TheoryData> ReturnsCastInstanceIfPossibleData = new() { new List { "Foo", "Bar" }, new[] { "Foo", "Bar", "Baz" }, new ObservableCollection() }; [Fact] public static void ReturnsNewListIfCastNotPossible() { // ReSharper disable PossibleMultipleEnumeration var enumerable = LazyEnumerable(); var list = enumerable.AsReadOnlyList(); list.Should().NotBeSameAs(enumerable); list.Should().BeOfType>(); list.Should().Equal(enumerable); // ReSharper restore PossibleMultipleEnumeration } [Fact] public static void EnumerableNull() { Action act = () => ((IEnumerable) null)!.AsReadOnlyList(); act.Should().Throw() .WithParameterName("source"); } [Fact] public static void CreateCollection() { var collection = LazyEnumerable().AsReadOnlyList(items => new ObservableCollection(items)); collection.Should().BeAssignableTo>(); collection.Should().Equal(LazyEnumerable()); } private static IEnumerable LazyEnumerable() { yield return "Foo"; yield return "Bar"; yield return "Baz"; } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/FrameworkExtensions/ExtractFieldTests.cs000066400000000000000000000022111470750352700326000ustar00rootroot00000000000000using System; using System.Linq.Expressions; using System.Reflection; using FluentAssertions; using Light.GuardClauses.FrameworkExtensions; using Xunit; namespace Light.GuardClauses.Tests.FrameworkExtensions; public static class ExtractFieldTests { [Fact] public static void ExtractPropertyInfo() { Expression> expression = foo => foo.Baz; var fieldInfo = expression.ExtractField(); fieldInfo.Should().BeSameAs(typeof(Foo).GetTypeInfo().GetField(nameof(Foo.Baz))); } [Fact] public static void InvalidExpression() { Expression> expression = foo => foo.Bar; Action act = () => expression.ExtractField(); act.Should().Throw() .And.Message.Should().Contain("The specified expression is not valid. Please use an expression like the following one: o => o.Field"); } [Fact] public static void ExpressionNull() { Action act = () => ((Expression>) null).ExtractField(); act.Should().Throw() .WithParameterName("expression"); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/FrameworkExtensions/ExtractPropertyTests.cs000066400000000000000000000023601470750352700334060ustar00rootroot00000000000000using System; using System.Linq.Expressions; using System.Reflection; using FluentAssertions; using Light.GuardClauses.FrameworkExtensions; using Xunit; namespace Light.GuardClauses.Tests.FrameworkExtensions; public static class ExtractPropertyTests { [Fact] public static void ExtractPropertyInfo() { Expression> expression = foo => foo.Bar; var propertyInfo = expression.ExtractProperty(); propertyInfo.Should().BeSameAs(typeof(Foo).GetTypeInfo().GetProperty(nameof(Foo.Bar))); } [Fact] public static void InvalidExpression() { Expression> expression = foo => foo.Baz; Action act = () => expression.ExtractProperty(); act.Should().Throw() .And.Message.Should().Contain("The specified expression is not valid. Please use an expression like the following one: o => o.Property"); } [Fact] public static void ExpressionNull() { Action act = () => ((Expression>) null).ExtractProperty(); act.Should().Throw() .WithParameterName("expression"); } } public class Foo { public int Baz; public string Bar { get; set; } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/FrameworkExtensions/ForEachTests.cs000066400000000000000000000052031470750352700315350ustar00rootroot00000000000000using System; using System.Collections.Generic; using System.Linq; using FluentAssertions; using Light.GuardClauses.Exceptions; using Light.GuardClauses.FrameworkExtensions; using Xunit; namespace Light.GuardClauses.Tests.FrameworkExtensions; public static class ForEachTests { [Theory] [MemberData(nameof(PerformOnEachElementData))] public static void PerformOnEachElement(IEnumerable collection) { // ReSharper disable PossibleMultipleEnumeration var clonedCollection = new List(collection); collection.ForEach(item => clonedCollection.Remove(item).Should().BeTrue()); clonedCollection.Should().BeEmpty(); // ReSharper restore PossibleMultipleEnumeration } public static readonly TheoryData> PerformOnEachElementData = new() { new[] { "Foo", "Bar", "Baz" }, new[] { "Foo" }, new string[] { }, LazyStringEnumerable() }; private static IEnumerable LazyStringEnumerable() { yield return "Foo"; yield return "Bar"; yield return "Baz"; } [Theory] [MemberData(nameof(ItemNullData))] public static void ItemNullException(IEnumerable collection) { Action act = () => collection.ForEach(_ => { }); act.Should().Throw(); } [Theory] [MemberData(nameof(ItemNullData))] public static void ItemNullOmit(IEnumerable collection) { // ReSharper disable PossibleMultipleEnumeration var callCount = 0; collection.ForEach(_ => callCount++, false); callCount.Should().Be(collection.Count(item => item != null)); // ReSharper restore PossibleMultipleEnumeration } public static readonly TheoryData> ItemNullData = new() { new[] { new object(), new object(), null }, LazyObjectEnumerableWithNull() }; private static IEnumerable LazyObjectEnumerableWithNull() { yield return new object(); yield return null; yield return new object(); yield return new object(); } [Theory] [MemberData(nameof(ArgumentNullData))] public static void ArgumentNull(IEnumerable collection, Action action) { Action act = () => collection.ForEach(action); act.Should().Throw(); } public static readonly TheoryData, Action> ArgumentNullData = new() { { null, _ => { } }, { new[] { 1, 2, 3 }, null } }; }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/FrameworkExtensions/MultiplyAddHashTests.cs000066400000000000000000000042171470750352700332660ustar00rootroot00000000000000using FluentAssertions; using Light.GuardClauses.FrameworkExtensions; using Xunit; namespace Light.GuardClauses.Tests.FrameworkExtensions; public static class MultiplyAddHashTests { [Theory] [InlineData("Foo", 42)] [InlineData("Bar", -177422)] [InlineData(null, 0)] public static void TwoParameters(string value1, int value2) { var hashCode1 = MultiplyAddHash.CreateHashCode(value1, value2); var hashCode2 = MultiplyAddHashBuilder.Create() .CombineIntoHash(value1) .CombineIntoHash(value2) .BuildHash(); hashCode1.Should().Be(hashCode2); } [Theory] [InlineData("Foo", 42, 'a')] [InlineData("Bar", -177422, 'Y')] [InlineData(null, 0, default(char))] public static void ThreeParameters(string value1, int value2, char value3) { var hashCode1 = MultiplyAddHash.CreateHashCode(value1, value2, value3); var hashCode2 = MultiplyAddHashBuilder.Create() .CombineIntoHash(value1) .CombineIntoHash(value2) .CombineIntoHash(value3) .BuildHash(); hashCode1.Should().Be(hashCode2); } [Theory] [InlineData("Foo", 42, 'a', 87.73665)] [InlineData("Bar", -177422, 'Y', -15.25)] [InlineData(null, 0, default(char), 0.0)] public static void FourParameters(string value1, int value2, char value3, double value4) { var hashCode1 = MultiplyAddHash.CreateHashCode(value1, value2, value3, value4); var hashCode2 = MultiplyAddHashBuilder.Create() .CombineIntoHash(value1) .CombineIntoHash(value2) .CombineIntoHash(value3) .CombineIntoHash(value4) .BuildHash(); hashCode1.Should().Be(hashCode2); } }ToStringRepresentationTests.cs000066400000000000000000000010351470750352700346420ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/FrameworkExtensionsusing FluentAssertions; using Light.GuardClauses.FrameworkExtensions; using Xunit; namespace Light.GuardClauses.Tests.FrameworkExtensions; public static class ToStringRepresentationTests { [Theory] [InlineData(42)] [InlineData(30)] [InlineData(-1502)] public static void UnquotedValue(int value) => value.ToStringRepresentation().Should().Be(value.ToString()); [Theory] [DefaultVariablesData] public static void QuotedValues(string value) => value.ToStringRepresentation().Should().Be($"\"{value}\""); }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/Issues/000077500000000000000000000000001470750352700241125ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/Issues/Issue66.cs000066400000000000000000000067051470750352700257150ustar00rootroot00000000000000using System; using System.Threading.Tasks; using FluentAssertions; using JetBrains.Annotations; using Xunit; namespace Light.GuardClauses.Tests.Issues { public static class Issue66 { [Fact] public static async Task ReSharperShowsSquigglyLinesAlthoughMustNotBeNullWasCalledBeforehand() { var repo = new SomeRepositoryMock(); repo.Entity = null; // If you comment out this line, the squiggly lines will not be shown var logic = new CoreLogic(() => repo); var entity = await logic.GetIt(); var savedEntity = repo.Entity; savedEntity.MustNotBeNull(); // This call should actually ensure that savedEntity is not null //savedEntity = savedEntity.MustNotBeNull(); // If you uncomment this line and comment the one above, then the squiggly lines also disappear entity.Id.Should().Be(savedEntity.Id); // These squiggly lines should not be there when dereferencing savedEntity } } public static class Assertions { [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static T MustNotBeNull(this T parameter) where T : class { if (parameter == null) throw new ArgumentNullException(); return parameter; } } public sealed class Entity { public string Id { get; set; } public static Entity CreateDefault() => new() { Id = "Foo" }; } public interface ISomeRepository : IDisposable { Task GetInstanceAsync(); Task SaveInstanceAsync(Entity dto); } public sealed class CoreLogic { private readonly Func _createRepo; public CoreLogic(Func createRepo) => _createRepo = createRepo; public async Task GetIt() { using var repo = _createRepo(); var instance = await repo.GetInstanceAsync(); if (instance == null) { instance = Entity.CreateDefault(); await repo.SaveInstanceAsync(instance); } return instance; } } public sealed class SomeRepositoryMock : ISomeRepository { public Entity Entity; public Task GetInstanceAsync() => Task.FromResult(Entity); public Task SaveInstanceAsync(Entity dto) { Entity = dto; return Task.CompletedTask; } public void Dispose() { } } } namespace JetBrains.Annotations { [AttributeUsage( AttributeTargets.Method | AttributeTargets.Parameter | AttributeTargets.Property | AttributeTargets.Delegate | AttributeTargets.Field | AttributeTargets.Event | AttributeTargets.Class | AttributeTargets.Interface | AttributeTargets.GenericParameter)] internal sealed class NotNullAttribute : Attribute { } [AttributeUsage(AttributeTargets.Method, AllowMultiple = true)] internal sealed class ContractAnnotationAttribute : Attribute { public ContractAnnotationAttribute([NotNull] string contract) : this(contract, false) { } public ContractAnnotationAttribute([NotNull] string contract, bool forceFullStates) { Contract = contract; ForceFullStates = forceFullStates; } [NotNull] public string Contract { get; } public bool ForceFullStates { get; } } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/Issues/Issue72NotNullAttributeTests.cs000066400000000000000000001352301470750352700321310ustar00rootroot00000000000000#nullable enable using System; using System.Collections; using System.Collections.Generic; using System.IO; using System.Linq.Expressions; using System.Runtime.Serialization; using System.Text; using System.Text.RegularExpressions; using FluentAssertions; using Light.GuardClauses.FrameworkExtensions; using Xunit; namespace Light.GuardClauses.Tests.Issues; // This occurs for delegates that create exceptions, and we just turn it off for these tests #pragma warning disable CS8622 // Nullability of reference types in type of parameter doesn't match the target delegate type. public static class Issue72NotNullAttributeTests { [Fact] public static void CheckMustNotBeNull() { TestMustNotBeNull("foo").Should().Be(3); _ = TestMustNotBeNullWithDelegate("foo").Should().Be(3); return; static int TestMustNotBeNull(string? input) { Check.MustNotBeNull(input); return input.Length; } static int TestMustNotBeNullWithDelegate(string? input) { input.MustNotBeNull(() => new Exception()); return input.Length; } } [Fact] public static void CheckMustNotBeDefault() { TestMustNotBeDefault("foo").Should().Be(3); TestMustNotBeDefaultWithDelegate("foo").Should().Be(3); return; static int TestMustNotBeDefault(string? input) { input.MustNotBeDefault(); return input.Length; } static int TestMustNotBeDefaultWithDelegate(string? input) { input.MustNotBeDefault(() => new Exception()); return input.Length; } } [Fact] public static void CheckMustNotBeNullReference() { TestMustNotBeNullReference("foo").Should().Be(3); TestMustNotBeNullReferenceWithDelegate("foo").Should().Be(3); return; static int TestMustNotBeNullReference(string? input) { input.MustNotBeNullReference(); return input.Length; } static int TestMustNotBeNullReferenceWithDelegate(string? input) { input.MustNotBeNullReference(() => new Exception()); return input.Length; } } [Fact] public static void CheckMustBeOfType() { TestMustBeOfType("foo").Should().Be(3); TestMustBeOfTypeWithDelegate("foo").Should().Be(3); return; static int TestMustBeOfType(object? input) { input.MustBeOfType(); return ((string) input).Length; } static int TestMustBeOfTypeWithDelegate(object? input) { input.MustBeOfType(_ => new Exception()); return ((string) input).Length; } } [Fact] public static void CheckMustHaveValue() { TestMustHaveValue(42).Should().Be(42); TestMustHaveValueWithDelegate(42).Should().Be(42); return; static int TestMustHaveValue(int? input) { input.MustHaveValue(); return input.Value; } static int TestMustHaveValueWithDelegate(int? input) { input.MustHaveValue(() => new Exception()); return input.Value; } } [Fact] public static void CheckMustNotBeLessThan() { TestMustNotBeLessThan("foo").Should().Be("foo"); TestMustNotBeLessThanWithDelegate("foo").Should().Be("foo"); return; // I need to provoke a compiler warning #pragma warning disable CS8631 // The type cannot be used as type parameter in the generic type or method. Nullability of type argument doesn't match constraint type. static string TestMustNotBeLessThan(string? input) { input.MustNotBeLessThan("bar"); return input; } static string TestMustNotBeLessThanWithDelegate(string? input) { input.MustNotBeLessThan("bar", (_, _) => new Exception()); return input; } #pragma warning restore CS8631 } [Fact] public static void CheckMustBeGreaterThanOrEqualTo() { TestMustBeGreaterThanOrEqualTo("foo").Should().Be("foo"); TestMustBeGreaterThanOrEqualToWithDelegate("foo").Should().Be("foo"); return; #pragma warning disable CS8631 // The type cannot be used as type parameter in the generic type or method. Nullability of type argument doesn't match constraint type. static string TestMustBeGreaterThanOrEqualTo(string? input) { input.MustBeGreaterThanOrEqualTo("bar"); return input; } static string TestMustBeGreaterThanOrEqualToWithDelegate(string? input) { input.MustBeGreaterThanOrEqualTo("bar", (_, _) => new Exception()); return input; } #pragma warning restore CS8631 } [Fact] public static void CheckMustBeLessThan() { TestMustBeLessThan("bar").Should().Be("bar"); TestMustBeLessThanWithDelegate("bar").Should().Be("bar"); return; #pragma warning disable CS8631 // The type cannot be used as type parameter in the generic type or method. Nullability of type argument doesn't match constraint type. static string TestMustBeLessThan(string? input) { input.MustBeLessThan("foo"); return input; } static string TestMustBeLessThanWithDelegate(string? input) { input.MustBeLessThan("foo", (_, _) => new Exception()); return input; } #pragma warning restore CS8631 } [Fact] public static void CheckMustNotBeGreaterThanOrEqualTo() { TestMustNotBeGreaterThanOrEqualTo("bar").Should().Be("bar"); TestMustNotBeGreaterThanOrEqualToWithDelegate("bar").Should().Be("bar"); return; #pragma warning disable CS8631 // The type cannot be used as type parameter in the generic type or method. Nullability of type argument doesn't match constraint type. static string TestMustNotBeGreaterThanOrEqualTo(string? input) { input.MustNotBeGreaterThanOrEqualTo("foo"); return input; } static string TestMustNotBeGreaterThanOrEqualToWithDelegate(string? input) { input.MustNotBeGreaterThanOrEqualTo("foo", (_, _) => new Exception()); return input; } #pragma warning restore CS8631 } [Fact] public static void CheckMustBeGreaterThan() { TestMustBeGreaterThan("foo").Should().Be("foo"); TestMustBeGreaterThanWithDelegate("foo").Should().Be("foo"); return; #pragma warning disable CS8631 // The type cannot be used as type parameter in the generic type or method. Nullability of type argument doesn't match constraint type. static string TestMustBeGreaterThan(string? input) { input.MustBeGreaterThan("bar"); return input; } static string TestMustBeGreaterThanWithDelegate(string? input) { input.MustBeGreaterThan("bar", (_, _) => new Exception()); return input; } #pragma warning restore CS8631 } [Fact] public static void CheckMustNotBeLessThanOrEqualTo() { TestMustNotBeLessThanOrEqualTo("foo").Should().Be("foo"); TestMustNotBeLessThanOrEqualToWithDelegate("foo").Should().Be("foo"); return; #pragma warning disable CS8631 // The type cannot be used as type parameter in the generic type or method. Nullability of type argument doesn't match constraint type. static string TestMustNotBeLessThanOrEqualTo(string? input) { input.MustNotBeLessThanOrEqualTo("bar"); return input; } static string TestMustNotBeLessThanOrEqualToWithDelegate(string? input) { input.MustNotBeLessThanOrEqualTo("bar", (_, _) => new Exception()); return input; } #pragma warning restore CS8631 } [Fact] public static void CheckMustNotBeGreaterThan() { TestMustNotBeGreaterThan("bar").Should().Be("bar"); TestMustNotBeGreaterThanWithDelegate("bar").Should().Be("bar"); return; #pragma warning disable CS8631 // The type cannot be used as type parameter in the generic type or method. Nullability of type argument doesn't match constraint type. static string TestMustNotBeGreaterThan(string? input) { input.MustNotBeGreaterThan("foo"); return input; } static string TestMustNotBeGreaterThanWithDelegate(string? input) { input.MustNotBeGreaterThan("foo", (_, _) => new Exception()); return input; } #pragma warning restore CS8631 } [Fact] public static void CheckMustBeLessThanOrEqualTo() { TestMustBeLessThanOrEqualTo("bar").Should().Be("bar"); TestMustBeLessThanOrEqualToWithDelegate("bar").Should().Be("bar"); return; #pragma warning disable CS8631 // The type cannot be used as type parameter in the generic type or method. Nullability of type argument doesn't match constraint type. static string TestMustBeLessThanOrEqualTo(string? input) { input.MustBeLessThanOrEqualTo("foo"); return input; } static string TestMustBeLessThanOrEqualToWithDelegate(string? input) { input.MustBeLessThanOrEqualTo("foo", (_, _) => new Exception()); return input; } #pragma warning restore CS8631 } [Fact] public static void CheckMustBeIn() { TestMustBeIn("b").Should().Be(1); TestMustBeInWithDelegate("b").Should().Be(1); #pragma warning disable CS8631 // The type cannot be used as type parameter in the generic type or method. Nullability of type argument doesn't match constraint type. static int TestMustBeIn(string? input) { input.MustBeIn(Range.FromInclusive("a").ToInclusive("c")!); return input.Length; } static int TestMustBeInWithDelegate(string? input) { input.MustBeIn(Range.FromInclusive("a").ToInclusive("c")!, (_, _) => new Exception()); return input.Length; } #pragma warning restore CS8631 } [Fact] public static void CheckMustNotBeIn() { TestMustNotBeIn("d").Should().Be(1); TestMustNotBeInWithDelegate("d").Should().Be(1); #pragma warning disable CS8631 // The type cannot be used as type parameter in the generic type or method. Nullability of type argument doesn't match constraint type. static int TestMustNotBeIn(string? input) { input.MustNotBeIn(Range.FromInclusive("a").ToInclusive("c")!); return input.Length; } static int TestMustNotBeInWithDelegate(string? input) { input.MustNotBeIn(Range.FromInclusive("a").ToInclusive("c")!, (_, _) => new Exception()); return input.Length; } #pragma warning restore CS8631 } [Fact] public static void CheckMustHaveCount() { TestMustHaveCount([]).Should().Be(0); TestMustHaveCountWithDelegate([]).Should().Be(0); return; static int TestMustHaveCount(string[]? input) { input.MustHaveCount(0); return input.Length; } static int TestMustHaveCountWithDelegate(string[]? input) { input.MustHaveCount(0, (_, _) => new Exception()); return input.Length; } } [Fact] public static void CheckMustNotBeNullOrEmpty() { TestMustNotBeNullOrEmpty([1, 2, 3]).Should().Be(3); TestMustNotBeNullOrEmptyWithDelegate([1, 2, 3]).Should().Be(3); return; static int TestMustNotBeNullOrEmpty(int[]? input) { input.MustNotBeNullOrEmpty(); return input.Length; } static int TestMustNotBeNullOrEmptyWithDelegate(int[]? input) { input.MustNotBeNullOrEmpty(_ => new Exception()); return input.Length; } } [Fact] public static void CheckMustContainForCollections() { TestMustContain([1, 2, 3]).Should().Be(3); TestMustContainWithDelegate([1, 2, 3]).Should().Be(3); return; static int TestMustContain(int[]? input) { input.MustContain(2); return input.Length; } static int TestMustContainWithDelegate(int[]? input) { input.MustContain(2, (_, _) => new Exception()); return input.Length; } } [Fact] public static void CheckMustNotContain() { TestMustNotContain([1, 2, 3]).Should().Be(3); TestMustNotContainWithDelegate([1, 2, 3]).Should().Be(3); return; static int TestMustNotContain(int[]? input) { input.MustNotContain(4); return input.Length; } static int TestMustNotContainWithDelegate(int[]? input) { input.MustNotContain(4, (_, _) => new Exception()); return input.Length; } } [Fact] public static void CheckIsOneOf() { TestIsOneOf("foo").Should().Be(3); return; static int TestIsOneOf(string? input) { 'o'.IsOneOf(input!); return input.Length; } } [Fact] public static void CheckMustBeOneOf() { TestMustBeOneOf("foo").Should().Be(3); TestMustBeOneOfWithDelegate("foo").Should().Be(3); return; static int TestMustBeOneOf(string? input) { 'o'.MustBeOneOf(input!); return input.Length; } static int TestMustBeOneOfWithDelegate(string? input) { 'o'.MustBeOneOf(input!, (_, _) => new Exception()); return input.Length; } } [Fact] public static void CheckMustNotBeOneOf() { TestMustNotBeOneOf("bar").Should().Be(3); TestMustNotBeOneOfWithDelegate("bar").Should().Be(3); return; static int TestMustNotBeOneOf(string? input) { 'o'.MustNotBeOneOf(input!); return input.Length; } static int TestMustNotBeOneOfWithDelegate(string? input) { 'o'.MustNotBeOneOf(input!, (_, _) => new Exception()); return input.Length; } } [Fact] public static void CheckMustHaveMinimumCount() { TestMustHaveMinimumCount([1, 2, 3]).Should().Be(3); TestMustHaveMinimumCountWithDelegate([1, 2, 3]).Should().Be(3); return; static int TestMustHaveMinimumCount(int[]? input) { input.MustHaveMinimumCount(2); return input.Length; } static int TestMustHaveMinimumCountWithDelegate(int[]? input) { input.MustHaveMinimumCount(2, (_, _) => new Exception()); return input.Length; } } [Fact] public static void CheckMustHaveMaximumCount() { TestMustHaveMaximumCount([1, 2, 3]).Should().Be(3); TestMustHaveMaximumCountWithDelegate([1, 2, 3]).Should().Be(3); return; static int TestMustHaveMaximumCount(int[]? input) { input.MustHaveMaximumCount(3); return input.Length; } static int TestMustHaveMaximumCountWithDelegate(int[]? input) { input.MustHaveMaximumCount(3, (_, _) => new Exception()); return input.Length; } } [Fact] public static void CheckMustNotBeNullOrEmptyString() { TestMustNotBeNullOrEmptyString("foo").Should().Be(3); TestMustNotBeNullOrEmptyStringWithDelegate("foo").Should().Be(3); return; static int TestMustNotBeNullOrEmptyString(string? input) { input.MustNotBeNullOrEmpty(); return input.Length; } static int TestMustNotBeNullOrEmptyStringWithDelegate(string? input) { input.MustNotBeNullOrEmpty(_ => new Exception()); return input.Length; } } [Fact] public static void CheckMustNotBeNullOrWhiteSpace() { TestMustNotBeNullOrWhiteSpace("foo").Should().Be(3); TestMustNotBeNullOrWhiteSpaceWithDelegate("foo").Should().Be(3); return; static int TestMustNotBeNullOrWhiteSpace(string? input) { input.MustNotBeNullOrWhiteSpace(); return input.Length; } static int TestMustNotBeNullOrWhiteSpaceWithDelegate(string? input) { input.MustNotBeNullOrWhiteSpace(_ => new Exception()); return input.Length; } } [Fact] public static void CheckMustMatch() { TestMustMatch("foo", "^f.*").Should().Be(3); TestMustMatchWithDelegate("foo", "^f.*").Should().Be(3); return; static int TestMustMatch(string? input, string pattern) { input.MustMatch(new Regex(pattern)); return input.Length; } static int TestMustMatchWithDelegate(string? input, string pattern) { input.MustMatch(new Regex(pattern), (_, _) => new Exception()); return input.Length; } } [Fact] public static void CheckMustContainForStrings() { TestMustContain("foo").Should().Be(3); TestMustContainWithDelegate("foo").Should().Be(3); TestMustContainWithStringComparison("foo").Should().Be(3); TestMustContainWithDelegateAndStringComparison("foo").Should().Be(3); return; static int TestMustContain(string? input) { input.MustContain("oo"); return input.Length; } static int TestMustContainWithDelegate(string? input) { input.MustContain("oo", (_, _) => new Exception()); return input.Length; } static int TestMustContainWithStringComparison(string? input) { input.MustContain("OO", StringComparison.OrdinalIgnoreCase); return input.Length; } static int TestMustContainWithDelegateAndStringComparison(string? input) { input.MustContain("OO", StringComparison.OrdinalIgnoreCase, (_, _, _) => new Exception()); return input.Length; } } [Fact] public static void CheckMustNotContainForStrings() { TestMustNotContain("foo").Should().Be(3); TestMustNotContainWithDelegate("foo").Should().Be(3); TestMustNotContainWithStringComparison("foo").Should().Be(3); TestMustNotContainWithDelegateAndStringComparison("foo").Should().Be(3); return; static int TestMustNotContain(string? input) { input.MustNotContain("bar"); return input.Length; } static int TestMustNotContainWithDelegate(string? input) { input.MustNotContain("bar", (_, _) => new Exception()); return input.Length; } static int TestMustNotContainWithStringComparison(string? input) { input.MustNotContain("BAR", StringComparison.OrdinalIgnoreCase); return input.Length; } static int TestMustNotContainWithDelegateAndStringComparison(string? input) { input.MustNotContain("BAR", StringComparison.OrdinalIgnoreCase, (_, _, _) => new Exception()); return input.Length; } } [Fact] public static void CheckMustBeSubstringOf() { TestMustBeSubstringOf("foo", "foobar").Should().Be(3); TestMustBeSubstringOfWithDelegate("foo", "foobar").Should().Be(3); TestMustBeSubstringOfWithStringComparison("OO").Should().Be(2); TestMustBeSubstringOfWithDelegateAndStringComparison("OO").Should().Be(2); return; static int TestMustBeSubstringOf(string? input, string target) { input.MustBeSubstringOf(target); return input.Length; } static int TestMustBeSubstringOfWithDelegate(string? input, string target) { input.MustBeSubstringOf(target, (_, _) => new Exception()); return input.Length; } static int TestMustBeSubstringOfWithStringComparison(string? input) { input.MustBeSubstringOf("foo", StringComparison.OrdinalIgnoreCase); return input.Length; } static int TestMustBeSubstringOfWithDelegateAndStringComparison(string? input) { input.MustBeSubstringOf("foo", StringComparison.OrdinalIgnoreCase, (_, _, _) => new Exception()); return input.Length; } } [Fact] public static void CheckMustNotBeSubstringOf() { TestMustNotBeSubstringOf("foo", "bar").Should().Be(3); TestMustNotBeSubstringOfWithDelegate("foo", "bar").Should().Be(3); TestMustNotBeSubstringOfWithStringComparison("FOO").Should().Be(3); TestMustNotBeSubstringOfWithDelegateAndStringComparison("FOO").Should().Be(3); return; static int TestMustNotBeSubstringOf(string? input, string target) { input.MustNotBeSubstringOf(target); return input.Length; } static int TestMustNotBeSubstringOfWithDelegate(string? input, string target) { input.MustNotBeSubstringOf(target, (_, _) => new Exception()); return input.Length; } static int TestMustNotBeSubstringOfWithStringComparison(string? input) { input.MustNotBeSubstringOf("bar", StringComparison.OrdinalIgnoreCase); return input.Length; } static int TestMustNotBeSubstringOfWithDelegateAndStringComparison(string? input) { input.MustNotBeSubstringOf("bar", StringComparison.OrdinalIgnoreCase, (_, _, _) => new Exception()); return input.Length; } } [Fact] public static void CheckMustBeEmailAddress() { TestMustBeEmailAddress("test@example.com").Should().Be("test@example.com"); TestMustBeEmailAddressWithDelegate("test@example.com").Should().Be("test@example.com"); TestMustBeEmailAddressWithRegex("test@example.com").Should().Be("test@example.com"); TestMustBeEmailAddressWithRegexAndDelegate("test@example.com").Should().Be("test@example.com"); return; static string TestMustBeEmailAddress(string? input) { input.MustBeEmailAddress(); return input; } static string TestMustBeEmailAddressWithDelegate(string? input) { input.MustBeEmailAddress(_ => new Exception()); return input; } static string TestMustBeEmailAddressWithRegex(string? input) { input.MustBeEmailAddress(new Regex(@"^[^@\s]+@[^@\s]+\.[^@\s]+$")); return input; } static string TestMustBeEmailAddressWithRegexAndDelegate(string? input) { input.MustBeEmailAddress(new Regex(@"^[^@\s]+@[^@\s]+\.[^@\s]+$"), (_, _) => new Exception()); return input; } } [Fact] public static void CheckMustBeShorterThan() { TestMustBeShorterThan("foo").Should().Be("foo"); TestMustBeShorterThanWithDelegate("foo").Should().Be("foo"); return; static string TestMustBeShorterThan(string? input) { input.MustBeShorterThan(5); return input; } static string TestMustBeShorterThanWithDelegate(string? input) { input.MustBeShorterThan(5, (_, _) => new Exception()); return input; } } [Fact] public static void CheckMustBeShorterThanOrEqualTo() { TestMustBeShorterThanOrEqualTo("foo").Should().Be("foo"); TestMustBeShorterThanOrEqualToWithDelegate("foo").Should().Be("foo"); return; static string TestMustBeShorterThanOrEqualTo(string? input) { input.MustBeShorterThanOrEqualTo(3); return input; } static string TestMustBeShorterThanOrEqualToWithDelegate(string? input) { input.MustBeShorterThanOrEqualTo(3, (_, _) => new Exception()); return input; } } [Fact] public static void CheckMustHaveLength() { TestMustHaveLength("foo").Should().Be("foo"); TestMustHaveLengthWithDelegate("foo").Should().Be("foo"); return; static string TestMustHaveLength(string? input) { input.MustHaveLength(3); return input; } static string TestMustHaveLengthWithDelegate(string? input) { input.MustHaveLength(3, (_, _) => new Exception()); return input; } } [Fact] public static void CheckMustBeLongerThan() { TestMustBeLongerThan("foobar").Should().Be("foobar"); TestMustBeLongerThanWithDelegate("foobar").Should().Be("foobar"); return; static string TestMustBeLongerThan(string? input) { input.MustBeLongerThan(3); return input; } static string TestMustBeLongerThanWithDelegate(string? input) { input.MustBeLongerThan(3, (_, _) => new Exception()); return input; } } [Fact] public static void CheckMustBeLongerThanOrEqualTo() { TestMustBeLongerThanOrEqualTo("foobar").Should().Be("foobar"); TestMustBeLongerThanOrEqualToWithDelegate("foobar").Should().Be("foobar"); return; static string TestMustBeLongerThanOrEqualTo(string? input) { input.MustBeLongerThanOrEqualTo(6); return input; } static string TestMustBeLongerThanOrEqualToWithDelegate(string? input) { input.MustBeLongerThanOrEqualTo(6, (_, _) => new Exception()); return input; } } [Fact] public static void CheckMustHaveLengthIn() { TestMustHaveLengthIn("foo").Should().Be("foo"); TestMustHaveLengthInWithDelegate("foo").Should().Be("foo"); return; static string TestMustHaveLengthIn(string? input) { input.MustHaveLengthIn(Range.FromInclusive(2).ToInclusive(4)); return input; } static string TestMustHaveLengthInWithDelegate(string? input) { input.MustHaveLengthIn(Range.FromInclusive(2).ToInclusive(4), (_, _) => new Exception()); return input; } } [Fact] public static void CheckMustBeNewLine() { TestMustBeNewLine("\n").Should().Be("\n"); TestMustBeNewLineWithDelegate("\n").Should().Be("\n"); return; static string TestMustBeNewLine(string? input) { input.MustBeNewLine(); return input; } static string TestMustBeNewLineWithDelegate(string? input) { input.MustBeNewLine(_ => new Exception()); return input; } } [Fact] public static void CheckMustBeTrimmed() { TestMustBeTrimmed("foo").Should().Be("foo"); TestMustBeTrimmedWithDelegate("foo").Should().Be("foo"); return; static string TestMustBeTrimmed(string? input) { input.MustBeTrimmed(); return input; } static string TestMustBeTrimmedWithDelegate(string? input) { input.MustBeTrimmed(_ => new Exception()); return input; } } [Fact] public static void CheckMustBeTrimmedAtStart() { TestMustBeTrimmedAtStart("foo").Should().Be("foo"); TestMustBeTrimmedAtStartWithDelegate("foo").Should().Be("foo"); return; static string TestMustBeTrimmedAtStart(string? input) { input.MustBeTrimmedAtStart(); return input; } static string TestMustBeTrimmedAtStartWithDelegate(string? input) { input.MustBeTrimmedAtStart(_ => new Exception()); return input; } } [Fact] public static void CheckMustBeTrimmedAtEnd() { TestMustBeTrimmedAtEnd("foo").Should().Be("foo"); TestMustBeTrimmedAtEndWithDelegate("foo").Should().Be("foo"); return; static string TestMustBeTrimmedAtEnd(string? input) { input.MustBeTrimmedAtEnd(); return input; } static string TestMustBeTrimmedAtEndWithDelegate(string? input) { input.MustBeTrimmedAtEnd(_ => new Exception()); return input; } } [Fact] public static void CheckImplements() { TestImplements(typeof(FileInfo), typeof(ISerializable)).Should().Be((typeof(FileInfo), typeof(ISerializable))); TestImplementsWithComparer(typeof(FileInfo), typeof(ISerializable)).Should().Be((typeof(FileInfo), typeof(ISerializable), EqualityComparer.Default)); return; static (Type Type, Type InterfaceType) TestImplements(Type? type, Type? interfaceType) { type!.Implements(interfaceType!); return (type, interfaceType); } static (Type Type, Type InterfaceType, IEqualityComparer Comparer) TestImplementsWithComparer(Type? type, Type? interfaceType) { type!.Implements(interfaceType!, EqualityComparer.Default); return (type, interfaceType, EqualityComparer.Default); } } [Fact] public static void CheckIsOrImplements() { TestIsOrImplements(typeof(FileInfo), typeof(ISerializable)).Should().Be((typeof(FileInfo), typeof(ISerializable))); TestIsOrImplementsWithComparer(typeof(FileInfo), typeof(ISerializable)).Should().Be((typeof(FileInfo), typeof(ISerializable), EqualityComparer.Default)); return; static (Type Type, Type InterfaceType) TestIsOrImplements(Type? type, Type? interfaceType) { type!.IsOrImplements(interfaceType!); return (type, interfaceType); } static (Type Type, Type InterfaceType, IEqualityComparer Comparer) TestIsOrImplementsWithComparer(Type? type, Type? interfaceType) { type!.IsOrImplements(interfaceType!, EqualityComparer.Default); return (type, interfaceType, EqualityComparer.Default); } } [Fact] public static void CheckDerivesFrom() { TestDerivesFrom(typeof(FileStream), typeof(Stream)).Should().Be((typeof(FileStream), typeof(Stream))); TestDerivesFromWithTypeComparer(typeof(FileStream), typeof(Stream)).Should().Be((typeof(FileStream), typeof(Stream))); return; static (Type Type, Type BaseType) TestDerivesFrom(Type? type, Type? baseType) { type!.DerivesFrom(baseType!); return (type, baseType); } static (Type Type, Type BaseType) TestDerivesFromWithTypeComparer(Type? type, Type? baseType) { type!.DerivesFrom(baseType!, EqualityComparer.Default); return (type, baseType); } } [Fact] public static void CheckIsOrDerivesFrom() { TestIsOrDerivesFrom(typeof(FileStream), typeof(Stream)).Should().Be((typeof(FileStream), typeof(Stream))); TestIsOrDerivesFromWithComparer(typeof(FileStream), typeof(Stream)).Should().Be((typeof(FileStream), typeof(Stream), EqualityComparer.Default)); return; static (Type Type, Type BaseType) TestIsOrDerivesFrom(Type? type, Type? baseType) { type!.IsOrDerivesFrom(baseType!); return (type, baseType); } static (Type Type, Type BaseType, IEqualityComparer Comparer) TestIsOrDerivesFromWithComparer(Type? type, Type? baseType) { type!.IsOrDerivesFrom(baseType!, EqualityComparer.Default); return (type, baseType, EqualityComparer.Default); } } [Fact] public static void CheckInheritsFrom() { TestInheritsFrom(typeof(FileStream), typeof(Stream)).Should().Be((typeof(FileStream), typeof(Stream))); TestInheritsFromWithTypeComparer(typeof(FileStream), typeof(Stream)).Should().Be((typeof(FileStream), typeof(Stream), EqualityComparer.Default)); return; static (Type Type, Type BaseType) TestInheritsFrom(Type? type, Type? baseType) { type!.InheritsFrom(baseType!); return (type, baseType); } static (Type Type, Type BaseType, IEqualityComparer Comparer) TestInheritsFromWithTypeComparer(Type? type, Type? baseType) { type!.InheritsFrom(baseType!, EqualityComparer.Default); return (type, baseType, EqualityComparer.Default); } } [Fact] public static void CheckIsOrInheritsFrom() { TestIsOrInheritsFrom(typeof(FileStream), typeof(Stream)).Should().Be((typeof(FileStream), typeof(Stream))); TestIsOrInheritsFromWithComparer(typeof(FileStream), typeof(Stream)).Should().Be((typeof(FileStream), typeof(Stream), EqualityComparer.Default)); return; static (Type Type, Type BaseType) TestIsOrInheritsFrom(Type? type, Type? baseType) { type!.IsOrInheritsFrom(baseType!); return (type, baseType); } static (Type Type, Type BaseType, IEqualityComparer Comparer) TestIsOrInheritsFromWithComparer(Type? type, Type? baseType) { type!.IsOrInheritsFrom(baseType!, EqualityComparer.Default); return (type, baseType, EqualityComparer.Default); } } [Fact] public static void CheckMustBeAbsoluteUri() { TestMustBeAbsoluteUri(new Uri("https://example.com")).Should().Be(new Uri("https://example.com")); TestMustBeAbsoluteUriWithDelegate(new Uri("https://example.com")).Should().Be(new Uri("https://example.com")); return; static Uri TestMustBeAbsoluteUri(Uri? input) { input.MustBeAbsoluteUri(); return input; } static Uri TestMustBeAbsoluteUriWithDelegate(Uri? input) { input.MustBeAbsoluteUri(_ => new Exception()); return input; } } [Fact] public static void CheckMustBeRelativeUri() { TestMustBeRelativeUri(new Uri("/relative/path", UriKind.Relative)).Should().Be(new Uri("/relative/path", UriKind.Relative)); TestMustBeRelativeUriWithDelegate(new Uri("/relative/path", UriKind.Relative)).Should().Be(new Uri("/relative/path", UriKind.Relative)); return; static Uri TestMustBeRelativeUri(Uri? input) { input.MustBeRelativeUri(); return input; } static Uri TestMustBeRelativeUriWithDelegate(Uri? input) { input.MustBeRelativeUri(_ => new Exception()); return input; } } [Fact] public static void CheckMustHaveScheme() { TestMustHaveScheme(new Uri("https://example.com"), "https").Should().Be(new Uri("https://example.com")); TestMustHaveSchemeWithDelegate(new Uri("https://example.com"), "https").Should().Be(new Uri("https://example.com")); TestMustHaveSchemeWithSecondDelegate(new Uri("https://example.com"), "https").Should().Be(new Uri("https://example.com")); return; static Uri TestMustHaveScheme(Uri? input, string scheme) { input.MustHaveScheme(scheme); return input; } static Uri TestMustHaveSchemeWithDelegate(Uri? input, string scheme) { input.MustHaveScheme(scheme, _ => new Exception()); return input; } static Uri TestMustHaveSchemeWithSecondDelegate(Uri? input, string scheme) { input.MustHaveScheme(scheme, (_, _) => new Exception()); return input; } } [Fact] public static void CheckMustBeHttpsUrl() { TestMustBeHttpsUrl(new Uri("https://example.com")).Should().Be(new Uri("https://example.com")); TestMustBeHttpsUrlWithDelegate(new Uri("https://example.com")).Should().Be(new Uri("https://example.com")); return; static Uri TestMustBeHttpsUrl(Uri? input) { input.MustBeHttpsUrl(); return input; } static Uri TestMustBeHttpsUrlWithDelegate(Uri? input) { input.MustBeHttpsUrl(_ => new Exception()); return input; } } [Fact] public static void CheckMustBeHttpUrl() { TestMustBeHttpUrl(new Uri("http://example.com")).Should().Be(new Uri("http://example.com")); TestMustBeHttpUrlWithDelegate(new Uri("http://example.com")).Should().Be(new Uri("http://example.com")); return; static Uri TestMustBeHttpUrl(Uri? input) { input.MustBeHttpUrl(); return input; } static Uri TestMustBeHttpUrlWithDelegate(Uri? input) { input.MustBeHttpUrl(_ => new Exception()); return input; } } [Fact] public static void CheckMustBeHttpOrHttpsUrl() { TestMustBeHttpOrHttpsUrl(new Uri("https://example.com")).Should().Be(new Uri("https://example.com")); TestMustBeHttpOrHttpsUrlWithDelegate(new Uri("https://example.com")).Should().Be(new Uri("https://example.com")); return; static Uri TestMustBeHttpOrHttpsUrl(Uri? input) { input.MustBeHttpOrHttpsUrl(); return input; } static Uri TestMustBeHttpOrHttpsUrlWithDelegate(Uri? input) { input.MustBeHttpOrHttpsUrl(_ => new Exception()); return input; } } [Fact] public static void CheckMustHaveOneSchemeOf() { TestMustHaveOneSchemeOf(new Uri("https://example.com")).Should().Be(new Uri("https://example.com")); TestMustHaveOneSchemeOfWithDelegate(new Uri("https://example.com")).Should().Be(new Uri("https://example.com")); return; static Uri TestMustHaveOneSchemeOf(Uri? input) { input.MustHaveOneSchemeOf(["http", "https"]); return input; } static Uri TestMustHaveOneSchemeOfWithDelegate(Uri? input) { input.MustHaveOneSchemeOf(new[] { "http", "https" }, (_, _) => new Exception()); return input; } } [Fact] public static void CheckIsIn() { TestIsIn("k").Should().Be("k"); return; static string TestIsIn(string? input) { input!.IsIn(Range.FromInclusive("a").ToInclusive("z")); return input; } } [Fact] public static void CheckIsNotIn() { TestIsNotIn("k").Should().Be("k"); return; static string TestIsNotIn(string? input) { input!.IsNotIn(Range.FromInclusive("a").ToInclusive("h")); return input; } } [Fact] public static void CheckIsSubstringOf() { TestIsSubstringOf("foo", "oo").Should().Be("foo"); TestIsSubstringOfWithComparison("foo", "oo").Should().Be("foo"); return; static string TestIsSubstringOf(string? input, string? comparison) { comparison!.IsSubstringOf(input!); return input; } static string TestIsSubstringOfWithComparison(string? input, string? comparison) { comparison!.IsSubstringOf(input!, StringComparison.OrdinalIgnoreCase); return input; } } [Fact] public static void CheckIsOpenConstructedGenericType() { TestIsOpenConstructedGenericType(typeof(List<>)).Should().Be(typeof(List<>)); return; static Type TestIsOpenConstructedGenericType(Type? type) { type!.IsOpenConstructedGenericType(); return type; } } [Fact] public static void CheckAsList() { TestAsList(new List()).Should().Be(0); TestAsListWithDelegate(new List()).Should().Be(0); return; static int TestAsList(IList? list) { list!.AsList(); return list.Count; } static int TestAsListWithDelegate(IList? list) { list!.AsList(collection => new List(collection)); return list.Count; } } [Fact] public static void CheckAsArray() { TestAsArray([1, 2, 3]).Should().Be(3); return; static int TestAsArray(int[]? array) { array!.AsArray(); return array.Length; } } [Fact] public static void CheckForEach() { TestForEach(["foo", "bar"]).Should().Be(2); return; static int TestForEach(string[]? array) { array!.ForEach(_ => { }); return array.Length; } } [Fact] public static void CheckAsReadOnlyList() { TestAsReadOnlyList([1, 2, 3]).Should().Be(3); TestAsReadOnlyListWithDelegate([1, 2, 3], collection => new List(collection)).Should().Be(3); return; static int TestAsReadOnlyList(int[]? array) { array!.AsReadOnlyList(); return array.Length; } static int TestAsReadOnlyListWithDelegate(int[]? array, Func, IReadOnlyList>? collectionFactory) { array!.AsReadOnlyList(collectionFactory!); return array.Length; } } [Fact] public static void CheckCount() { TestCount(new ArrayList(new[] { 1, 2, 3 })).Should().Be(3); TestCountWithParameterNameAndMessage(new ArrayList(new[] { 1, 2, 3 })).Should().Be(3); return; static int TestCount(ICollection? collection) { collection!.Count(); return collection.Count; } static int TestCountWithParameterNameAndMessage(ICollection? collection) { collection!.Count(nameof(collection), "The collection must not be null"); return collection.Count; } } [Fact] public static void CheckGetCount() { TestGetCount([1, 2, 3]).Should().Be(3); TestGetCountWithParameterNameAndMessage([1, 2, 3]).Should().Be(3); return; static int TestGetCount(ICollection? collection) { collection!.GetCount(); return collection.Count; } static int TestGetCountWithParameterNameAndMessage(ICollection? collection) { collection!.GetCount(nameof(collection), "The collection must not be null"); return collection.Count; } } [Fact] public static void CheckExtractProperty() { TestExtractProperty((string a) => a.Length).Should().NotBeNull(); return; static Type TestExtractProperty(Expression>? expression) { expression!.ExtractProperty(); return expression.Type; } } [Fact] public static void CheckExtractField() { TestExtractField((TestClassWithPublicField x) => x.PublicField).Should().NotBeNull(); return; static Type TestExtractField(Expression>? expression) { expression!.ExtractField(); return expression.Type; } } private sealed class TestClassWithPublicField { #pragma warning disable CS0414 // Field is assigned but its value is never used // ReSharper disable once ConvertToConstant.Local public readonly int PublicField = 42; #pragma warning restore CS0414 } [Fact] public static void CheckAppendCollectionContent() { var stringBuilder = new StringBuilder(); TestAppendCollectionContent(stringBuilder, [1, 2, 3]).Should().Be((stringBuilder, 3)); return; static (StringBuilder, int) TestAppendCollectionContent(StringBuilder? stringBuilder, ICollection? items) { stringBuilder!.AppendCollectionContent(items!); return (stringBuilder, items.Count); } } [Fact] public static void CheckToStringRepresentation() { TestToStringRepresentation("foo").Should().Be(3); return; static int TestToStringRepresentation(string? value) { value.ToStringRepresentation(); return value.Length; } } [Fact] public static void CheckAppendItemsWithNewLine() { var stringBuilder = new StringBuilder(); TestAppendItemsWithNewLine(stringBuilder, [1, 2, 3]).Should().Be((stringBuilder, 3)); return; static (StringBuilder, int) TestAppendItemsWithNewLine(StringBuilder? stringBuilder, ICollection? items) { stringBuilder!.AppendItemsWithNewLine(items!); return (stringBuilder, items.Count); } } [Fact] public static void CheckAppendIf() { var stringBuilder = new StringBuilder(); TestAppendIf(stringBuilder, true, "foo").Should().Be((stringBuilder, 3)); return; static (StringBuilder, int) TestAppendIf(StringBuilder? stringBuilder, bool condition, string value) { stringBuilder!.AppendIf(condition, value); return (stringBuilder, value.Length); } } [Fact] public static void CheckAppendLineIf() { var stringBuilder = new StringBuilder(); TestAppendLineIf(stringBuilder, true, "foo").Should().Be((stringBuilder, 3)); return; static (StringBuilder, int) TestAppendLineIf(StringBuilder? stringBuilder, bool condition, string value) { stringBuilder!.AppendLineIf(condition, value); return (stringBuilder, value.Length); } } [Fact] public static void CheckAppendItems() { var stringBuilder = new StringBuilder(); TestAppendItems(stringBuilder, [1, 2, 3]).Should().Be((stringBuilder, 3)); return; static (StringBuilder, int) TestAppendItems(StringBuilder? stringBuilder, ICollection? items) { stringBuilder!.AppendItems(items!); return (stringBuilder, items.Count); } } [Fact] public static void CheckAppendExceptionMessages() { var stringBuilder = new StringBuilder(); TestAppendExceptionMessages(stringBuilder, new Exception("foo")).Should().Be((stringBuilder, 3)); return; static (StringBuilder, int) TestAppendExceptionMessages(StringBuilder? stringBuilder, Exception exception) { stringBuilder!.AppendExceptionMessages(exception); return (stringBuilder, exception.Message.Length); } } [Fact] public static void CheckGetAllExceptionMessages() { TestGetAllExceptionMessages(new Exception("foo")).Should().Be(3); return; static int TestGetAllExceptionMessages(Exception? exception) { exception!.GetAllExceptionMessages(); return exception.Message.Length; } } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/Light.GuardClauses.Tests.csproj000066400000000000000000000020671470750352700306170ustar00rootroot00000000000000 net8.0 false 12 true all runtime; build; native; contentfiles; analyzers; buildtransitive Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/StringAssertions/000077500000000000000000000000001470750352700261605ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/StringAssertions/EqualsTests.cs000066400000000000000000000060131470750352700307640ustar00rootroot00000000000000using FluentAssertions; using Xunit; namespace Light.GuardClauses.Tests.StringAssertions; public static class EqualsTests { [Theory] [InlineData("Foo", " Foo", true)] [InlineData("Bar", "Bar ", true)] [InlineData("\t Baz\r\n", "Baz", true)] [InlineData("Qux", "Qux", true)] [InlineData("{\r\n \"foo\": 42\r\n}\r\n", "{\"foo\":42}", true)] [InlineData("Foo", "Bar", false)] [InlineData(" Baz", "Qux ", false)] [InlineData("Foo", "foo", false)] [InlineData("Bar\t", "bar ", false)] [InlineData(null, null, true)] [InlineData(null, "Foo ", false)] [InlineData("Foo", null, false)] [InlineData("", "", true)] public static void OrdinalIgnoreWhiteSpace(string x, string y, bool expected) => x.Equals(y, StringComparisonType.OrdinalIgnoreWhiteSpace).Should().Be(expected); [Theory] [InlineData("Foo", "FOO", true)] [InlineData(" Bar", "bar ", true)] [InlineData("B a z", "bAZ", true)] [InlineData("Qu\tx", " qux", true)] [InlineData("{\r\n \"foo\": \"Bar\"\r\n}", "{\"FOO\": \"BAR\"}", true)] [InlineData("Foo", "Bar", false)] [InlineData("", "some content", false)] [InlineData("", "", true)] [InlineData(null, null, true)] [InlineData(null, "Foo", false)] [InlineData("Bar", null, false)] public static void OrdinalIgnoreCaseIgnoreWhiteSpace(string x, string y, bool expected) => x.Equals(y, StringComparisonType.OrdinalIgnoreCaseIgnoreWhiteSpace).Should().Be(expected); [Theory] [InlineData("Foo", "Foo", true)] [InlineData("Bar", "bar", false)] public static void FallbackToOrdinal(string x, string y, bool expected) => x.Equals(y, StringComparisonType.Ordinal).Should().Be(expected); [Theory] [InlineData("Foo", "foo", true)] [InlineData("Foo", "Bar", false)] public static void FallbackToOrdinalIgnoreCase(string x, string y, bool expected) => x.Equals(y, StringComparisonType.OrdinalIgnoreCase).Should().Be(expected); [Theory] [InlineData("Foo", "Foo", true)] [InlineData("Foo", "foo", false)] public static void FallbackToCurrentCulture(string x, string y, bool expected) => x.Equals(y, StringComparisonType.CurrentCulture).Should().Be(expected); [Theory] [InlineData("Foo", "foo", true)] [InlineData("Foo", "Bar", false)] public static void FallbackToCurrentCultureIgnoreCase(string x, string y, bool expected) => x.Equals(y, StringComparisonType.CurrentCultureIgnoreCase).Should().Be(expected); [Theory] [InlineData("Foo", "Foo", true)] [InlineData("Foo", "foo", false)] public static void FallbackToInvariantCulture(string x, string y, bool expected) => x.Equals(y, StringComparisonType.InvariantCulture).Should().Be(expected); [Theory] [InlineData("Foo", "foo", true)] [InlineData("Foo", "Bar", false)] public static void FallbackToInvariantCultureIgnoreCase(string x, string y, bool expected) => x.Equals(y, StringComparisonType.InvariantCultureIgnoreCase).Should().Be(expected); }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/StringAssertions/IsEmailAddressTest.cs000066400000000000000000000030231470750352700321760ustar00rootroot00000000000000using FluentAssertions; using Xunit; namespace Light.GuardClauses.Tests.StringAssertions; public sealed class IsEmailAddressTest { [Theory] [InlineData(null)] [InlineData("plainaddress")] [InlineData("#@%^%#$@#$@#.com")] [InlineData("@domain.com")] [InlineData("Joe Smith ")] [InlineData("email.domain.com")] [InlineData("email@domain@domain.com")] [InlineData(".email@domain.com")] [InlineData("email.@domain.com")] [InlineData("email..email@domain.com")] [InlineData("あいうえお@domain.com")] [InlineData("email@domain.com (Joe Smith)")] [InlineData("email@domain")] [InlineData("email@-domain.com")] [InlineData("email@111.222.333.44444")] [InlineData("email@domain..com")] public void IsNotValidEmailAddress(string email) { var isValid = email.IsEmailAddress(); isValid.Should().BeFalse(); } [Theory] [InlineData("email@domain.com")] [InlineData("firstname.lastname@domain.com")] [InlineData("email@subdomain.domain.com")] [InlineData("firstname+lastname@domain.com")] [InlineData("email@123.123.123.123")] [InlineData("1234567890@domain.com")] [InlineData("email@domain-one.com")] [InlineData("_______@domain.com")] [InlineData("email@domain.name")] [InlineData("email@domain.co.jp")] [InlineData("firstname-lastname@domain.com")] public void IsValidEmailAddress(string email) { var isValid = email.IsEmailAddress(); isValid.Should().BeTrue(); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/StringAssertions/IsNewLineTests.cs000066400000000000000000000010771470750352700313740ustar00rootroot00000000000000using FluentAssertions; using Xunit; #nullable enable namespace Light.GuardClauses.Tests.StringAssertions; public static class IsNewLineTests { [Theory] [InlineData("\n")] [InlineData("\r\n")] public static void IsNewLine(string @string) => @string.IsNewLine().Should().BeTrue(); [Theory] [InlineData("")] [InlineData(null)] [InlineData("Some other string")] [InlineData("You can't play God without being acquainted with the devil.")] public static void IsNotNewLine(string? @string) => @string.IsNewLine().Should().BeFalse(); }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/StringAssertions/IsNullOrEmptyTests.cs000066400000000000000000000010511470750352700322550ustar00rootroot00000000000000using FluentAssertions; using Xunit; namespace Light.GuardClauses.Tests.StringAssertions; public static class IsNullOrEmptyTests { [Fact] public static void StringNull() => ((string) null).IsNullOrEmpty().Should().BeTrue(); [Fact] public static void StringEmpty() => string.Empty.IsNullOrEmpty().Should().BeTrue(); [Theory] [InlineData("abcdef")] [InlineData("\t")] [InlineData(" ")] [InlineData("\u2028")] public static void StringNotEmpty(string @string) => @string.IsNullOrEmpty().Should().BeFalse(); }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/StringAssertions/MustBeEmailAddressTests.cs000066400000000000000000000076411470750352700332170ustar00rootroot00000000000000using System; using System.Text.RegularExpressions; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.StringAssertions; public static class MustBeEmailAddressTests { [Theory] [InlineData("email@domain.com")] [InlineData("email@123.123.123.123")] public static void ValidEmailAddress(string emailAddress) => emailAddress.MustBeEmailAddress().Should().BeSameAs(emailAddress); [Theory] [InlineData("plainAddress")] [InlineData("Joe Smith ")] public static void InvalidEmailAddress(string emailAddress) { Action act = () => emailAddress.MustBeEmailAddress(); act.Should().Throw() .And.Message.Should().Contain($"emailAddress must be a valid email address, but it actually is \"{emailAddress}\"."); } [Theory] [InlineData(".email@domain.com")] [InlineData("email.@domain.com")] public static void InvalidEmailAddressArgumentName(string emailAddress) { Action act = () => emailAddress.MustBeEmailAddress(nameof(emailAddress)); act.Should().Throw() .And.Message.Should().Contain($"emailAddress must be a valid email address, but it actually is \"{emailAddress}\"."); } [Theory] [InlineData("email@domain")] [InlineData("email@-domain.com")] public static void InvalidEmailAddressCustomMessage(string emailAddress) { const string customMessage = "This email address is not valid"; Action act = () => emailAddress.MustBeEmailAddress(nameof(emailAddress), customMessage); act.Should().Throw() .And.Message.Should().Contain(customMessage); } private static readonly Regex CustomRegex = new (@"^[^@\s]+@[^@\s]+\.[^@\s]+$"); [Fact] public static void InvalidEmailCustomRegex() { const string email = "email@domain@domain.com"; Action act = () => email.MustBeEmailAddress(CustomRegex, "email"); act.Should().Throw() .And.Message.Should().Contain($"email must be a valid email address, but it actually is \"{email}\"."); } [Fact] public static void EmailNull() { Action act = () => default(string).MustBeEmailAddress(); act.Should().Throw(); } [Theory] [MemberData(nameof(NullData))] public static void NullCustomRegex(string email, Regex regex) { Action act = () => email.MustBeEmailAddress(regex); act.Should().Throw(); } public static readonly TheoryData NullData = new () { { null, CustomRegex }, { "invalidEmailAddress", null } }; [Fact] public static void CustomException() => Test.CustomException("email.domain.com", (input, exceptionFactory) => input.MustBeEmailAddress(exceptionFactory)); [Fact] public static void CustomMessage() => Test.CustomMessage(message => "#@%^%#$@#$@#.com".MustBeEmailAddress(message: message)); [Fact] public static void CustomExceptionCustomRegex() => Test.CustomException("invalidEmailAddress", CustomRegex, (i, r, exceptionFactory) => i.MustBeEmailAddress(r, exceptionFactory)); [Fact] public static void CustomMessageCustomRegex() => Test.CustomMessage(message => "invalidEmailAddress".MustBeEmailAddress(CustomRegex, message: message)); [Fact] public static void CallerArgumentExpression() { const string email = "This is not an email address"; var act = () => email.MustBeEmailAddress(); act.Should().Throw() .WithParameterName(nameof(email)); } }MustBeLongerThanOrEqualToTests.cs000066400000000000000000000035201470750352700344300ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/StringAssertionsusing System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.StringAssertions; public static class MustBeLongerThanOrEqualToTests { [Theory] [InlineData("Foo", 3)] [InlineData("Bar", 2)] [InlineData("", 0)] [InlineData("All rulers are either butchers or meat.", 10)] public static void LongerThanOrEqualTo(string @string, int length) => @string.MustBeLongerThanOrEqualTo(length).Should().BeSameAs(@string); [Theory] [InlineData("Baz", 4)] [InlineData("Gorge", 10)] [InlineData("", 1)] [InlineData("He was no dragon. Fire cannot kill a dragon.", 75)] public static void Shorter(string @string, int length) { var act = () => @string.MustBeLongerThanOrEqualTo(length, nameof(@string)); act.Should().Throw() .And.Message.Should().Contain($"string must be longer than or equal to {length}, but it actually has length {@string.Length}."); } [Fact] public static void StringNull() { var act = () => ((string) null).MustBeLongerThanOrEqualTo(42); act.Should().Throw(); } [Fact] public static void CustomException() => Test.CustomException("Foo", 10, (s, l, exceptionFactory) => s.MustBeLongerThanOrEqualTo(l, exceptionFactory)); [Fact] public static void CustomMessage() => Test.CustomMessage(message => "Bar".MustBeLongerThanOrEqualTo(10, message: message)); [Fact] public static void CallerArgumentExpression() { const string foo = "Foo"; var act = () => foo.MustBeLongerThanOrEqualTo(4); act.Should().Throw() .WithParameterName(nameof(foo)); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/StringAssertions/MustBeLongerThanTests.cs000066400000000000000000000035711470750352700327210ustar00rootroot00000000000000using System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.StringAssertions; public static class MustBeLongerThanTests { [Theory] [InlineData("Foo", 2)] [InlineData("Gorge", 3)] [InlineData("", -1)] [InlineData("If you think this has a happy ending, you haven’t been paying attention.", 69)] public static void LongerThan(string @string, int length) => @string.MustBeLongerThan(length).Should().BeSameAs(@string); [Theory] [InlineData("Bar", 3)] [InlineData("Baz", 4)] [InlineData("", 0)] // ReSharper disable StringLiteralTypo [InlineData("Hush, Hodor. No more Hodor-ing!", 100)] // ReSharper restore StringLiteralTypo public static void NotLongerThan(string @string, int length) { var act = () => @string.MustBeLongerThan(length, nameof(@string)); act.Should().Throw() .And.Message.Should().Contain($"string must be longer than {length}, but it actually has length {@string.Length}."); } [Fact] public static void StringNull() { var act = () => ((string) null).MustBeLongerThan(42); act.Should().Throw(); } [Fact] public static void CustomException() => Test.CustomException("Foo", 5, (s, l, exceptionFactory) => s.MustBeLongerThan(l, exceptionFactory)); [Fact] public static void CustomMessage() => Test.CustomMessage(message => "Foo".MustBeLongerThan(10, message: message)); [Fact] public static void CallerArgumentExpression() { const string @short = "It's short"; var act = () => @short.MustBeLongerThan(10); act.Should().Throw() .WithParameterName("@short"); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/StringAssertions/MustBeNewLineTests.cs000066400000000000000000000040311470750352700322110ustar00rootroot00000000000000using System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Light.GuardClauses.FrameworkExtensions; using Xunit; #nullable enable namespace Light.GuardClauses.Tests.StringAssertions; public static class MustBeNewLineTests { [Theory] [InlineData("\n")] [InlineData("\r\n")] public static void StringIsNewLine(string @string) => @string.MustBeNewLine().Should().BeSameAs(@string); [Fact] public static void StringIsNull() { var stringValue = default(string); var act = () => stringValue.MustBeNewLine(nameof(stringValue)); act.Should().Throw() .WithParameterName(nameof(stringValue)); } [Theory] [InlineData("Foo")] [InlineData("")] public static void StringIsNotNewLine(string invalidString) { var act = () => invalidString.MustBeNewLine(nameof(invalidString)); act.Should().Throw() .And.Message.Should().Contain($"{nameof(invalidString)} must be either \"\\n\" or \"\\r\\n\", but it actually is {invalidString.ToStringOrNull()}."); } [Fact] public static void CustomExceptionStringNull() { Test.CustomException( default(string), (@null, exceptionFactory) => @null.MustBeNewLine(exceptionFactory) ); } [Theory] [InlineData("What humans describe as sane is a narrow range of behaviors.")] [InlineData("Someday sounds a lot like the thing people say when they actually mean never.")] public static void CustomExceptionInvalidString(string invalidString) { Test.CustomException( invalidString, (@string, exceptionFactory) => @string.MustBeNewLine(exceptionFactory!) ); } [Fact] public static void CallerArgumentExpression() { const string expression = "This is not a new line"; var act = () => expression.MustBeNewLine(); act.Should().Throw() .WithParameterName(nameof(expression)); } }MustBeShorterThanOrEqualToTests.cs000066400000000000000000000035601470750352700346340ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/StringAssertionsusing System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.StringAssertions; public static class MustBeShorterThanOrEqualToTests { [Theory] [InlineData("Foo", 3)] [InlineData("Bar", 4)] [InlineData("We have 200,000 reasons to take the city.", 42)] public static void ShorterOrEqualTo(string @string, int length) => @string.MustBeShorterThanOrEqualTo(length).Should().BeSameAs(@string); [Theory] [InlineData("Baz", 2)] [InlineData("Gorge", 3)] [InlineData("You told me to do nothing before and I listened to you. I’m not doing nothing again", 2)] public static void LongerThan(string @string, int length) { var act = () => @string.MustBeShorterThanOrEqualTo(length, nameof(@string)); act.Should().Throw() .And.Message.Should().Contain($"string must be shorter or equal to {length}, but it actually has length {@string.Length}."); } [Fact] public static void StringNull() { var act = () => ((string) null).MustBeShorterThanOrEqualTo(42); act.Should().Throw(); } [Fact] public static void CustomException() => Test.CustomException("Meh", 2, (s, _, exceptionFactory) => s.MustBeShorterThanOrEqualTo(2, exceptionFactory)); [Fact] public static void CustomMessage() => Test.CustomMessage(message => "foo".MustBeShorterThanOrEqualTo(1, message: message)); [Fact] public static void CallerArgumentExpression() { const string message = "My God, this is already short"; var act = () => message.MustBeShorterThanOrEqualTo(5); act.Should().Throw() .WithParameterName(nameof(message)); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/StringAssertions/MustBeShorterThanTests.cs000066400000000000000000000036061470750352700331200ustar00rootroot00000000000000using System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.StringAssertions; public static class MustBeShorterThanTests { [Theory] [InlineData("Foo", 4)] [InlineData("Once you've accepted your flaws, no one can use them against you.", 70)] [InlineData("", 1)] public static void IsShorterThan(string @string, int length) => @string.MustBeShorterThan(length).Should().BeSameAs(@string); [Theory] [InlineData("Bar", 3)] [InlineData("Baz", 2)] [InlineData("The great thing about reading is that it broadens your life", 20)] public static void NotShorterThan(string @string, int length) { Action act = () => @string.MustBeShorterThan(length, nameof(@string)); act.Should().Throw() .And.Message.Should().Contain($"string must be shorter than {length}, but it actually has length {@string.Length}."); } [Fact] public static void StringNull() { Action act = () => ((string) null).MustBeShorterThan(42); act.Should().Throw(); } [Fact] public static void CustomException() => Test.CustomException("Foo", 2, (s, l, exceptionFactory) => s.MustBeShorterThan(l, exceptionFactory)); [Fact] public static void CustomMessage() => Test.CustomMessage(message => "Foo".MustBeShorterThan(1, message: message)); [Fact] public static void CallerArgumentExpression() { const string message = "The messenger will be hanged later when the message is really long. But why do you want to hang him in the first place?"; var act = () => message.MustBeShorterThan(10); act.Should().Throw() .WithParameterName(nameof(message)); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/StringAssertions/MustBeSubstringOfTests.cs000066400000000000000000000134351470750352700331250ustar00rootroot00000000000000using System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Light.GuardClauses.FrameworkExtensions; using Xunit; namespace Light.GuardClauses.Tests.StringAssertions; public static class MustBeSubstringOfTests { [Theory] [InlineData("Foo", "Bar")] [InlineData("FO", "Foo")] [InlineData("Hey, you over there!", "Where is the pigeon pie?")] public static void NotSubstring(string @string, string other) { Action act = () => @string.MustBeSubstringOf(other, nameof(@string)); var assertion = act.Should().Throw().Which; assertion.Message.Should().Contain($"{nameof(@string)} must be a substring of \"{other}\", but it actually is {@string.ToStringOrNull()}."); assertion.ParamName.Should().BeSameAs(nameof(@string)); } [Theory] [InlineData("Foo", "Food")] [InlineData("123", "123")] [InlineData("", "Any string can contain the empty string")] [InlineData("bar", "Let's go to the bar and have a drink.")] [InlineData("I'll have you", "If you ever call me sister again, I'll have you strangled in your sleep.")] public static void Substring(string substring, string other) => substring.MustBeSubstringOf(other).Should().BeSameAs(substring); [Theory] [InlineData("Foo", "Bar", StringComparison.OrdinalIgnoreCase)] [InlineData("Baz", "Qux", StringComparison.CurrentCulture)] public static void NotSubstringCustomComparisonType(string first, string second, StringComparison comparisonType) { Action act = () => first.MustBeSubstringOf(second, comparisonType, nameof(first)); var assertion = act.Should().Throw().Which; assertion.Message.Should().Contain($"{nameof(first)} must be a substring of \"{second}\" ({comparisonType}), but it actually is \"{first}\"."); assertion.ParamName.Should().BeSameAs(nameof(first)); } [Theory] [InlineData("foo", "Food", StringComparison.OrdinalIgnoreCase)] [InlineData("ab", "AB", StringComparison.CurrentCultureIgnoreCase)] [InlineData("be drunk", "Isn't it a man's duty to be drunk at his own wedding?", StringComparison.CurrentCulture)] public static void SubstringCustomComparisonType(string x, string y, StringComparison comparisonType) => x.MustBeSubstringOf(y, comparisonType).Should().BeSameAs(x); [Fact] public static void ParameterNull() { Action act = () => ((string) null).MustBeSubstringOf("Foo"); act.Should().Throw(); } [Fact] public static void OtherNull() { Action act = () => "Foo".MustBeSubstringOf(null!); act.Should().Throw(); } [Fact] public static void ParameterNullCustomComparisonType() { Action act = () => ((string) null).MustBeSubstringOf("Bar", StringComparison.Ordinal); act.Should().Throw(); } [Fact] public static void OtherNullCustomComparisonType() { Action act = () => "Baz".MustBeSubstringOf(null!, StringComparison.CurrentCultureIgnoreCase); act.Should().Throw(); } [Theory] [InlineData("Foo", "Bar")] [InlineData(null, "Baz")] [InlineData("Qux", null)] public static void CustomException(string first, string second) => Test.CustomException(first, second, (s1, s2, exceptionFactory) => s1.MustBeSubstringOf(s2, exceptionFactory)); [Theory] [InlineData("Foo", "FOO", StringComparison.Ordinal)] [InlineData("Bar", null, StringComparison.OrdinalIgnoreCase)] [InlineData(null, "Baz", StringComparison.CurrentCulture)] public static void CustomExceptionCustomComparisonType(string first, string second, StringComparison comparisonType) => Test.CustomException(first, second, comparisonType, (s1, s2, ct, exceptionFactory) => s1.MustBeSubstringOf(s2, ct, exceptionFactory)); [Fact] public static void NoCustomExceptionThrown() => "Foo".MustBeSubstringOf("Food", (_, _) => new Exception()).Should().BeSameAs("Foo"); [Fact] public static void NoCustomExceptionThrownWithCustomComparisonType() => "Bar".MustBeSubstringOf("Bar", (_, _) => new Exception()).Should().BeSameAs("Bar"); [Fact] public static void CustomMessage() => Test.CustomMessage(message => "Baz".MustBeSubstringOf("Qux", message: message)); [Fact] public static void CustomMessageParameterNull() => Test.CustomMessage(message => ((string) null).MustBeSubstringOf("Foo", message: message)); [Fact] public static void CustomMessageValueNull() => Test.CustomMessage(message => "Foo".MustBeSubstringOf(null!, message: message)); [Fact] public static void CustomMessageCustomComparisonType() => Test.CustomMessage(message => "1".MustBeSubstringOf("OMG", StringComparison.OrdinalIgnoreCase, message: message)); [Fact] public static void CustomMessageCustomComparisonTypeParameterNull() => Test.CustomMessage(message => ((string) null).MustBeSubstringOf("Foo", StringComparison.CurrentCulture, message: message)); [Fact] public static void CustomMessageCustomComparisonTypeValueNull() => Test.CustomMessage(message => "Foo".MustBeSubstringOf(null!, StringComparison.Ordinal, message: message)); [Fact] public static void CallerArgumentExpression() { const string foo = "Foo"; var act = () => foo.MustBeSubstringOf("Bar"); act.Should().Throw() .WithParameterName(nameof(foo)); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/StringAssertions/MustBeTests.cs000066400000000000000000000071511470750352700307350ustar00rootroot00000000000000using System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Light.GuardClauses.FrameworkExtensions; using Xunit; namespace Light.GuardClauses.Tests.StringAssertions; public static class MustBeTests { [Theory] [InlineData("Foo", "Bar", StringComparison.OrdinalIgnoreCase)] [InlineData("Foo", "foo", StringComparison.Ordinal)] [InlineData("Baz", null, StringComparison.CurrentCulture)] [InlineData(null, "Qux", StringComparison.OrdinalIgnoreCase)] public static void StringsNotEqual(string first, string second, StringComparison comparisonType) { Action act = () => first.MustBe(second, comparisonType, nameof(first)); act.Should().Throw() .And.Message.Should().Contain($"{nameof(first)} must be equal to {second.ToStringOrNull()}, but it actually is {first.ToStringOrNull()}."); } [Theory] [InlineData("Foo", "Foo", StringComparison.Ordinal)] [InlineData("Foo", "foo", StringComparison.OrdinalIgnoreCase)] [InlineData(null, null, StringComparison.CurrentCulture)] public static void StringsEqual(string first, string second, StringComparison comparisonType) => first.MustBe(second, comparisonType).Should().Be(first); [Theory] [InlineData("Foo", " foo ", StringComparisonType.OrdinalIgnoreWhiteSpace)] [InlineData("Bar", "Baz", StringComparisonType.OrdinalIgnoreCaseIgnoreWhiteSpace)] [InlineData("\tFoo", null, StringComparisonType.OrdinalIgnoreCaseIgnoreWhiteSpace)] [InlineData(null, "Qux\r\n", StringComparisonType.OrdinalIgnoreWhiteSpace)] public static void StringsNotEqualIgnoreWhiteSpace(string first, string second, StringComparisonType comparisonType) { Action act = () => first.MustBe(second, comparisonType, nameof(first)); act.Should().Throw() .And.Message.Should().Contain($"{nameof(first)} must be equal to {second.ToStringOrNull()}, but it actually is {first.ToStringOrNull()}."); } [Theory] [InlineData("Foo", "\tfoo", StringComparisonType.OrdinalIgnoreCaseIgnoreWhiteSpace)] [InlineData("Bar", " Bar", StringComparisonType.OrdinalIgnoreWhiteSpace)] [InlineData(null, null, StringComparisonType.OrdinalIgnoreWhiteSpace)] public static void StringsEqualIgnoreWhiteSpace(string x, string y, StringComparisonType comparisonType) => x.MustBe(y, comparisonType).Should().BeSameAs(x); [Fact] public static void CustomException() => Test.CustomException("Foo", "Bar", StringComparison.Ordinal, (x, y, ct, exceptionFactory) => x.MustBe(y, ct, exceptionFactory)); [Fact] public static void CustomMessage() => Test.CustomMessage(message => "Foo".MustBe("Bar", StringComparison.Ordinal, message: message)); [Fact] public static void CustomExceptionIgnoreWhiteSpace() => Test.CustomException("Foo", " foo", StringComparisonType.OrdinalIgnoreWhiteSpace, (x, y, ct, exceptionFactory) => x.MustBe(y, ct, exceptionFactory)); [Fact] public static void CustomMessageIgnoreWhiteSpace() => Test.CustomMessage(message => "foo".MustBe("bar", StringComparisonType.Ordinal, message: message)); [Fact] public static void CallerArgumentExpression() { const string myString = "Foo"; var act = () => myString.MustBe("Bar"); act.Should().Throw() .WithParameterName(nameof(myString)); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/StringAssertions/MustBeTrimmedAtEndTests.cs000066400000000000000000000040651470750352700331740ustar00rootroot00000000000000using System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Light.GuardClauses.FrameworkExtensions; using Xunit; namespace Light.GuardClauses.Tests.StringAssertions; public static class MustBeTrimmedAtEndTests { [Theory] [InlineData("")] [InlineData("foo")] [InlineData(" bar")] [InlineData("Sto p")] public static void StringIsTrimmedAtEnd(string input) => input.MustBeTrimmedAtEnd().Should().BeSameAs(input); [Fact] public static void StringIsNull() { var nullString = default(string); // ReSharper disable once ExpressionIsAlwaysNull var act = () => nullString.MustBeTrimmedAtEnd(nameof(nullString)); act.Should().Throw() .WithParameterName(nameof(nullString)); } [Theory] [InlineData("abc ")] [InlineData(" Let's go\n")] [InlineData("not trimmed at the end\t")] public static void StringIsNotTrimmedAtTheEnd(string invalidString) { var act = () => invalidString.MustBeTrimmedAtEnd(nameof(invalidString)); act.Should().Throw() .And.Message.Should().Contain($"invalidString must be trimmed at the end, but it actually is {invalidString.ToStringOrNull()}"); } [Fact] public static void CustomExceptionStringNull() => Test.CustomException( default(string), (@null, exceptionFactory) => @null.MustBeTrimmedAtEnd(exceptionFactory) ); [Theory] [InlineData("Not trimmed at end ")] [InlineData("Meh\t")] public static void CustomExceptionInvalidString(string invalidString) => Test.CustomException( invalidString, (@string, exceptionFactory) => @string.MustBeTrimmedAtEnd(exceptionFactory) ); [Fact] public static void CallerArgumentExpression() { const string invalidString = "not trimmed "; var act = () => invalidString.MustBeTrimmedAtEnd(); act.Should().Throw() .WithParameterName(nameof(invalidString)); } }MustBeTrimmedAtStartTests.cs000066400000000000000000000041401470750352700334760ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/StringAssertionsusing System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Light.GuardClauses.FrameworkExtensions; using Xunit; namespace Light.GuardClauses.Tests.StringAssertions; public static class MustBeTrimmedAtStartTests { [Theory] [InlineData("")] [InlineData("foo")] [InlineData("bar\n")] [InlineData("I have white space ")] public static void StringIsTrimmedAtStart(string input) => input.MustBeTrimmedAtStart().Should().BeSameAs(input); [Fact] public static void StringIsNulL() { var nullString = default(string); // ReSharper disable once ExpressionIsAlwaysNull var act = () => nullString.MustBeTrimmedAtStart(nameof(nullString)); act.Should().Throw() .WithParameterName(nameof(nullString)); } [Theory] [InlineData(" Hey")] [InlineData("\tTab")] [InlineData(" White space on both ends ")] public static void StringIsNotTrimmedAtStart(string invalidString) { var act = () => invalidString.MustBeTrimmedAtStart(nameof(invalidString)); act.Should().Throw() .And.Message.Should().Contain($"invalidString must be trimmed at the start, but it actually is {invalidString.ToStringOrNull()}"); } [Fact] public static void CustomExceptionStringNull() => Test.CustomException( default(string), (@null, exceptionFactory) => @null.MustBeTrimmedAtStart(exceptionFactory) ); [Theory] [InlineData(" Not trimmed at the start")] [InlineData("\nFoo")] public static void CustomExceptionInvalidString(string invalidString) => Test.CustomException( invalidString, (@string, exceptionFactory) => @string.MustBeTrimmedAtStart(exceptionFactory) ); [Fact] public static void CallerArgumentExpression() { const string invalidString = " Not trimmed at start"; var act = () => invalidString.MustBeTrimmedAtStart(); act.Should().Throw() .WithParameterName(nameof(invalidString)); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/StringAssertions/MustBeTrimmedTests.cs000066400000000000000000000040631470750352700322560ustar00rootroot00000000000000using System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Light.GuardClauses.FrameworkExtensions; using Xunit; namespace Light.GuardClauses.Tests.StringAssertions; public static class MustBeTrimmedTests { [Theory] [InlineData("")] [InlineData("foo")] [InlineData("bar")] [InlineData("Another string\twith whitespace")] public static void StringIsTrimmed(string input) => input.MustBeTrimmed().Should().BeSameAs(input); [Fact] public static void StringIsNull() { var nullString = default(string); // ReSharper disable once ExpressionIsAlwaysNull var act = () => nullString.MustBeTrimmed(nameof(nullString)); act.Should().Throw() .WithParameterName(nameof(nullString)); } [Theory] [InlineData("123 ")] [InlineData("\nFoo")] [InlineData(" not trimmed ")] public static void StringIsNotTrimmed(string invalidString) { var act = () => invalidString.MustBeTrimmed(nameof(invalidString)); act.Should().Throw() .And.Message.Should().Contain($"invalidString must be trimmed, but it actually is {invalidString.ToStringOrNull()}"); } [Fact] public static void CustomExceptionStringNull() { Test.CustomException( default(string), (@null, exceptionFactory) => @null.MustBeTrimmed(exceptionFactory) ); } [Theory] [InlineData(" This is not trimmed at the start")] [InlineData("And not at the end\t ")] public static void CustomExceptionInvalidString(string invalidString) { Test.CustomException( invalidString, (@string, exceptionFactory) => @string.MustBeTrimmed(exceptionFactory) ); } [Fact] public static void CallerArgumentExpression() { const string invalidString = " Not trimmed "; var act = () => invalidString.MustBeTrimmed(); act.Should().Throw() .WithParameterName(nameof(invalidString)); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/StringAssertions/MustContainTests.cs000066400000000000000000000116741470750352700320070ustar00rootroot00000000000000using System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Light.GuardClauses.FrameworkExtensions; using Xunit; namespace Light.GuardClauses.Tests.StringAssertions; public static class MustContainTests { [Theory] [InlineData("Foo", "Bar")] [InlineData("abc", "d")] [InlineData("Hello, World!", "You")] [InlineData("1, 2, 3", ". ")] public static void StringDoesNotContain(string @string, string other) { Action act = () => @string.MustContain(other, nameof(@string)); var assertion = act.Should().Throw().Which; assertion.Message.Should().Contain($"{nameof(@string)} must contain {other.ToStringOrNull()}, but it actually is {@string.ToStringOrNull()}."); assertion.ParamName.Should().BeSameAs(nameof(@string)); } [Theory] [InlineData("Foo", "oo")] [InlineData("Bar", "Bar")] [InlineData("Baz", "B")] [InlineData("abc", "a")] [InlineData("Hello, World!", "orl")] [InlineData("1, 2, 3", ", ")] public static void StringContains(string @string, string substring) => @string.MustContain(substring).Should().BeSameAs(@string); [Theory] [InlineData("Why are all the gods such vicious cunts ? Where is the god of tits and wine?", "beer", StringComparison.OrdinalIgnoreCase)] [InlineData("I'm the captain. If this ship goes down, I go down with it.", "SHIP", StringComparison.Ordinal)] public static void StringDoesNotContainCustomSearch(string @string, string other, StringComparison comparisonType) { Action act = () => @string.MustContain(other, comparisonType, nameof(@string)); var assertion = act.Should().Throw().Which; assertion.Message.Should().Contain($"{nameof(@string)} must contain {other.ToStringOrNull()} ({comparisonType}), but it actually is {@string.ToStringOrNull()}."); assertion.ParamName.Should().BeSameAs(nameof(@string)); } [Theory] [InlineData("Foo", "foo", StringComparison.OrdinalIgnoreCase)] [InlineData("I suppose I'll have to kill the Mountain myself. Won't that make for a great song.", "KILL", StringComparison.OrdinalIgnoreCase)] public static void StringContainsCustomSearch(string @string, string substring, StringComparison comparisonType) => @string.MustContain(substring, comparisonType).Should().BeSameAs(@string); [Fact] public static void StringNull() { Action act = () => ((string) null).MustContain("Foo"); act.Should().Throw(); } [Fact] public static void StringNullCustomSearch() { Action act = () => ((string) null).MustContain("Foo", StringComparison.Ordinal); act.Should().Throw(); } [Theory] [InlineData("Foo", "Bar")] [InlineData("Baz", null)] [InlineData(null, "Qux")] public static void CustomException(string first, string second) => Test.CustomException(first, second, (@string, other, exceptionFactory) => @string.MustContain(other, exceptionFactory)); [Theory] [InlineData("Foo", "foo", StringComparison.Ordinal)] [InlineData(null, "Bar", StringComparison.OrdinalIgnoreCase)] [InlineData("Baz", null, StringComparison.CurrentCulture)] public static void CustomExceptionCustomSearch(string x, string y, StringComparison comparison) => Test.CustomException(x, y, comparison, (@string, other, comparisonType, exceptionFactory) => @string.MustContain(other, comparisonType, exceptionFactory)); [Fact] public static void CustomMessage() => Test.CustomMessage(message => "Foo".MustContain("Bar", message: message)); [Fact] public static void CustomMessageParameterNull() => Test.CustomMessage(message => ((string) null).MustContain("Foo", message: message)); [Fact] public static void CustomMessageValueNull() => Test.CustomMessage(message => "Foo".MustContain(null, message: message)); [Fact] public static void CustomMessageCustomSearch() => Test.CustomMessage(message => "Baz".MustContain("Qux", StringComparison.OrdinalIgnoreCase, message: message)); [Fact] public static void CustomMessageCustomSearchParameterNull() => Test.CustomMessage(message => ((string) null).MustContain("Foo", message: message)); [Fact] public static void CustomMessageCustomSearchValueNull() => Test.CustomMessage(message => "Bar".MustContain(null, message: message)); [Fact] public static void CallerArgumentExpression() { const string foo = "Foo"; var act = () => foo.MustContain("Bar"); act.Should().Throw() .WithParameterName(nameof(foo)); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/StringAssertions/MustEndWithTests.cs000066400000000000000000000052541470750352700317530ustar00rootroot00000000000000using System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.StringAssertions; public static class MustEndWithTests { [Theory] [InlineData("Foo", "Bar")] [InlineData("When you play the game of thrones you win, or you die.", "you live")] public static void DoesNotEndWith(string x, string y) { var act = () => x.MustEndWith(y); var exception = act.Should().Throw().Which; exception.Message.Should().StartWith($"{nameof(x)} must end with \"{y}\" (CurrentCulture), but it actually is \"{x}\"."); exception.ParamName.Should().BeSameAs(nameof(x)); } [Theory] [InlineData("FooBar", "Bar", StringComparison.Ordinal)] [InlineData("12345678", "5678", StringComparison.InvariantCultureIgnoreCase)] public static void EndsWith(string x, string y, StringComparison comparisonType) => x.MustEndWith(y, comparisonType).Should().BeSameAs(x); [Fact] public static void ParameterNull() { var act = () => ((string) null).MustEndWith("Foo"); act.Should().Throw(); } [Fact] public static void ValueNull() { var act = () => "Foo".MustEndWith(null!); act.Should().Throw(); } [Fact] public static void CustomMessage() => Test.CustomMessage(message => "Foo".MustEndWith("Bar", message: message)); [Fact] public static void CustomMessageParameterNull() => Test.CustomMessage(message => ((string) null).MustEndWith("Bar", message: message)); [Fact] public static void EndsWithCustomException() => "Foo".MustEndWith("o", (_, _) => new Exception()).Should().Be("Foo"); [Fact] public static void EndsWithCustomExceptionAndComparisonType() => "Foo".MustEndWith("O", StringComparison.OrdinalIgnoreCase, (_, _, _) => new Exception()).Should().Be("Foo"); [Theory] [InlineData("Foo", "Bar")] [InlineData("Foo", null)] [InlineData(null, "Baz")] public static void CustomException(string first, string second) => Test.CustomException(first, second, (s1, s2, exceptionFactory) => s1.MustEndWith(s2, exceptionFactory)); [Theory] [InlineData("Foo", "Bar", StringComparison.Ordinal)] [InlineData(null, "Bar", StringComparison.Ordinal)] [InlineData("Baz", null, StringComparison.Ordinal)] public static void CustomExceptionWithComparisonType(string a, string b, StringComparison comparisonType) => Test.CustomException(a, b, comparisonType, (s1, s2, ct, exceptionFactory) => s1.MustEndWith(s2, ct, exceptionFactory)); } Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/StringAssertions/MustHaveLengthInTests.cs000066400000000000000000000051431470750352700327220ustar00rootroot00000000000000using System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.StringAssertions; public static class MustHaveLengthInTests { [Theory] [MemberData(nameof(LengthInRangeData))] public static void LengthInRange(string @string, Range range) => @string.MustHaveLengthIn(range).Should().BeSameAs(@string); public static readonly TheoryData> LengthInRangeData = new () { { "Foo", Range.FromInclusive(0).ToExclusive(10) }, { "Bar", Range.FromInclusive(3).ToInclusive(5) }, { "", Range.FromInclusive(0).ToExclusive(100) }, { "Nothing isn’t better or worse than anything. Nothing is just nothing.", Range.FromExclusive(20).ToInclusive(69) } }; [Theory] [MemberData(nameof(LengthNotInRangeData))] public static void LengthNotInRange(string @string, Range range) { var act = () => @string.MustHaveLengthIn(range, nameof(@string)); act.Should().Throw() .And.Message.Should().Contain($"string must have its length in between {range.CreateRangeDescriptionText("and")}, but it actually has length {@string.Length}."); } public static readonly TheoryData> LengthNotInRangeData = new () { { "Baz", Range.FromInclusive(10).ToInclusive(20) }, { "Qux", Range.FromExclusive(3).ToExclusive(10) }, { "", Range.FromInclusive(1).ToExclusive(50) }, { "There is only one god, and his name is Death.", Range.FromInclusive(100).ToExclusive(256) } }; [Fact] public static void StringNull() { var act = () => ((string) null).MustHaveLengthIn(new Range()); act.Should().Throw(); } [Fact] public static void CustomException() => Test.CustomException("Foo", Range.FromInclusive(5).ToInclusive(10), (s, r, exceptionFactory) => s.MustHaveLengthIn(r, exceptionFactory)); [Fact] public static void CustomMessage() => Test.CustomMessage(message => "Foo".MustHaveLengthIn(Range.FromInclusive(42).ToInclusive(50), message: message)); [Fact] public static void CallerArgumentExpression() { const string message = "God rest ye merry, gentlemen"; var act = () => message.MustHaveLengthIn(Range.FromInclusive(3).ToExclusive(10)); act.Should().Throw() .WithParameterName(nameof(message)); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/StringAssertions/MustHaveLengthTests.cs000066400000000000000000000033571470750352700324400ustar00rootroot00000000000000using System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.StringAssertions; public static class MustHaveLengthTests { [Theory] [InlineData("Foo", 3)] [InlineData("Gorge", 5)] [InlineData("", 0)] [InlineData("I will do what queens do. I will rule.", 38)] public static void LengthEqual(string @string, int length) => @string.MustHaveLength(length).Should().BeSameAs(@string); [Theory] [InlineData("Bar", 2)] [InlineData("Baz", 4)] [InlineData("", -1)] [InlineData("We have 200,000 reasons to take the city.", 931)] public static void LengthNotEqual(string @string, int length) { var act = () => @string.MustHaveLength(length, nameof(@string)); act.Should().Throw() .And.Message.Should().Contain($"string must have length {length}, but it actually has length {@string.Length}."); } [Fact] public static void StringNull() { var act = () => ((string) null).MustHaveLength(42); act.Should().Throw(); } [Fact] public static void CustomException() => Test.CustomException("Foo", 5, (s, l, exceptionFactory) => s.MustHaveLength(l, exceptionFactory)); [Fact] public static void CustomMessage() => Test.CustomMessage(message => "Foo".MustHaveLength(42, message: message)); [Fact] public static void CallerArgumentExpression() { const string foo = "Foo"; var act = () => foo.MustHaveLength(4); act.Should().Throw() .WithParameterName(nameof(foo)); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/StringAssertions/MustMatchTests.cs000066400000000000000000000054551470750352700314500ustar00rootroot00000000000000using System; using System.Text.RegularExpressions; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.StringAssertions; public static class MustMatchTests { [Fact] public static void StringDoesNotMatch() { var pattern = new Regex(@"\d{5}"); const string @string = "12c45"; Action act = () => @string.MustMatch(pattern, nameof(@string)); var assertion = act.Should().Throw().Which; assertion.Message.Should().Contain($"{nameof(@string)} must match the regular expression \"{pattern}\", but it actually is \"{@string}\"."); assertion.ParamName.Should().BeSameAs(nameof(@string)); } [Fact] public static void StringMatches() { var pattern = new Regex(@"\w{5}"); // ReSharper disable once StringLiteralTypo const string @string = "abcde"; var result = @string.MustMatch(pattern, nameof(@string)); result.Should().BeSameAs(@string); } [Fact] public static void StringNull() { Action act = () => ((string) null).MustMatch(new Regex("Foo")); act.Should().Throw(); } [Theory] [MemberData(nameof(CustomExceptionData))] public static void CustomException(string input, Regex regularExpression) => Test.CustomException(input, regularExpression, (@string, regex, exceptionFactory) => @string.MustMatch(regex, exceptionFactory)); public static readonly TheoryData CustomExceptionData = new() { { "ab", new Regex(@"\w{3}") }, { null, new Regex(@"\W{6}") }, { "Foo", null } }; [Fact] public static void NoCustomExceptionThrown() => "Foo".MustMatch(new Regex("\\w{3}"), (_, _) => new Exception()).Should().BeSameAs("Foo"); [Fact] public static void CustomMessage() => // ReSharper disable once StringLiteralTypo Test.CustomMessage(message => "abcde".MustMatch(new Regex("Foo"), message:message)); [Fact] public static void CustomMessageParameterNull() => Test.CustomMessage(message => ((string) null).MustMatch(new Regex("Foo"), message: message)); [Fact] public static void CustomMessageRegexNull() => Test.CustomMessage(message => "Foo".MustMatch(null!, message: message)); [Fact] public static void CallerArgumentExpression() { const string email = "This is not really an email"; var act = () => email.MustMatch(RegularExpressions.EmailRegex); act.Should().Throw() .WithParameterName(nameof(email)); } }MustNotBeNullOrEmptyTests.cs000066400000000000000000000040221470750352700335040ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/StringAssertionsusing System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.StringAssertions; public static class MustNotBeNullOrEmptyTests { [Fact] public static void StringNull() { Action act = () => ((string) null).MustNotBeNullOrEmpty("Foo"); act.Should().Throw() .WithParameterName("Foo"); } [Fact] public static void EmptyString() { var @string = string.Empty; Action act = () => @string.MustNotBeNullOrEmpty(nameof(@string)); act.Should().Throw() .And.Message.Should().Contain($"{nameof(@string)} must not be an empty string, but it actually is."); } [Theory] [DefaultVariablesData] public static void StringNotEmpty(string @string) => @string.MustNotBeNullOrEmpty(nameof(@string)).Should().BeSameAs(@string); [Fact] public static void CustomExceptionStringNull() => Test.CustomException((string) null, (@null, exceptionFactory) => @null.MustNotBeNullOrEmpty(exceptionFactory)); [Fact] public static void CustomExceptionStringEmpty() => Test.CustomException(string.Empty, (emptyString, exceptionFactory) => emptyString.MustNotBeNullOrEmpty(exceptionFactory)); [Fact] public static void CustomMessageStringNull() => Test.CustomMessage(message => ((string) null).MustNotBeNullOrEmpty(message: message)); [Fact] public static void CustomMessageStringEmpty() => Test.CustomMessage(message => string.Empty.MustNotBeNullOrEmpty(message: message)); [Fact] public static void CallerArgumentExpression() { var nullString = default(string); // ReSharper disable once ExpressionIsAlwaysNull var act = () => nullString.MustNotBeNullOrEmpty(); act.Should().Throw() .WithParameterName(nameof(nullString)); } }MustNotBeNullOrWhiteSpaceTests.cs000066400000000000000000000051761470750352700344550ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/StringAssertionsusing System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.StringAssertions; public static class MustNotBeNullOrWhiteSpaceTests { [Fact] public static void StringIsNull() { Action act = () => ((string) null).MustNotBeNullOrWhiteSpace("Foo"); act.Should().Throw() .WithParameterName("Foo"); } [Fact] public static void StringIsEmpty() { var value = string.Empty; Action act = () => value.MustNotBeNullOrWhiteSpace(nameof(value)); act.Should().Throw() .And.Message.Should().Contain($"{nameof(value)} must not be an empty string, but it actually is."); } [Theory] [MemberData(nameof(WhiteSpaceData))] public static void StringIsWhiteSpace(string value) { Action act = () => value.MustNotBeNullOrWhiteSpace(nameof(value)); act.Should().Throw() .And.Message.Should().Contain($"{nameof(value)} must not contain only white space, but it actually is \"{value}\"."); } public static readonly TheoryData WhiteSpaceData = new() { Environment.NewLine, " ", "\t", "\t\t ", "\r" }; [Theory] [InlineData("a")] [InlineData("a ")] [InlineData(" 1")] [InlineData(" \t{id:1}\t")] [InlineData("{\r\n\tid: 1\r\n}")] public static void NonWhiteSpace(string value) => value.MustNotBeNullOrWhiteSpace(nameof(value)).Should().BeSameAs(value); [Fact] public static void CustomExceptionStringNull() => Test.CustomException((string) null, (@null, exceptionFactory) => @null.MustNotBeNullOrWhiteSpace(exceptionFactory)); [Fact] public static void CustomExceptionEmptyString() => Test.CustomException(string.Empty, (emptyString, exceptionFactory) => emptyString.MustNotBeNullOrWhiteSpace(exceptionFactory)); [Theory] [MemberData(nameof(WhiteSpaceData))] public static void CustomExceptionWhiteSpace(string whiteSpaceString) => Test.CustomException(whiteSpaceString, (@string, exceptionFactory) => @string.MustNotBeNullOrWhiteSpace(exceptionFactory)); [Fact] public static void CallerArgumentExpression() { const string whiteSpaceString = "\t"; var act = () => whiteSpaceString.MustNotBeNullOrWhiteSpace(); act.Should().Throw() .WithParameterName(nameof(whiteSpaceString)); } }MustNotBeSubstringOfTests.cs000066400000000000000000000127261470750352700335310ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/StringAssertionsusing System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.StringAssertions; public static class MustNotBeSubstringOfTests { [Theory] [InlineData("123", " 12345 ")] // ReSharper disable StringLiteralTypo [InlineData("friend", "Say herro to my littre friend")] // ReSharper restore StringLiteralTypo public static void Substring(string x, string y) { Action act = () => x.MustNotBeSubstringOf(y, nameof(x)); var assertion = act.Should().Throw().Which; assertion.Message.Should().Contain($"{nameof(x)} must not be a substring of \"{y}\", but it actually is \"{x}\"."); assertion.ParamName.Should().BeSameAs(nameof(x)); } [Theory] [InlineData("Foo", "Bar")] [InlineData("Love and peace", "When you play the game of thrones you win, or you die.There is no middle ground.")] public static void NotSubstring(string first, string second) => first.MustNotBeSubstringOf(second).Should().BeSameAs(first); [Theory] [InlineData("Foo", "Foo", StringComparison.Ordinal)] [InlineData("bar", "Bar", StringComparison.OrdinalIgnoreCase)] [InlineData("I am", "I AM YOUR MASTER", StringComparison.CurrentCultureIgnoreCase)] public static void SubstringCustomComparison(string s1, string s2, StringComparison comparisonType) { Action act = () => s1.MustNotBeSubstringOf(s2, comparisonType, nameof(s1)); var assertion = act.Should().Throw().Which; assertion.Message.Should().Contain($"{nameof(s1)} must not be a substring of \"{s2}\" ({comparisonType}), but it actually is \"{s1}\"."); assertion.ParamName.Should().BeSameAs(nameof(s1)); } [Theory] [InlineData("light", "Where is the LIGHT?", StringComparison.Ordinal)] // ReSharper disable once StringLiteralTypo [InlineData("Pawned", "Pwnd", StringComparison.CurrentCulture)] [InlineData("drink", "Let's go to the mall", StringComparison.CurrentCultureIgnoreCase)] public static void NotSubstringCustomComparison(string a, string b, StringComparison comparisonType) => a.MustNotBeSubstringOf(b, comparisonType).Should().BeSameAs(a); [Fact] public static void ParameterNull() { Action act = () => ((string) null).MustNotBeSubstringOf("Foo"); act.Should().Throw(); } [Fact] public static void ValueNull() { Action act = () => "Bar".MustNotBeSubstringOf(null!); act.Should().Throw(); } [Fact] public static void ParameterNullCustomComparison() { Action act = () => ((string) null).MustNotBeSubstringOf("Foo", StringComparison.OrdinalIgnoreCase); act.Should().Throw(); } [Fact] public static void ValueNullCustomComparison() { Action act = () => "Baz".MustNotBeSubstringOf(null!, StringComparison.CurrentCulture); act.Should().Throw(); } [Theory] [InlineData("drink", "I'll have a drink right now")] [InlineData(null, "Foo")] [InlineData("Bar", null)] public static void CustomException(string first, string second) => Test.CustomException(first, second, (s1, s2, exceptionFactory) => s1.MustNotBeSubstringOf(s2, exceptionFactory)); [Theory] [InlineData("Full of Possibilities", "Death is so terribly final, while life is full of possibilities", StringComparison.OrdinalIgnoreCase)] [InlineData(null, "Foo", StringComparison.Ordinal)] [InlineData("Bar", null, StringComparison.CurrentCulture)] public static void CustomExceptionCustomComparison(string a, string b, StringComparison comparisonType) => Test.CustomException(a, b, comparisonType, (s1, s2, ct, exceptionFactory) => s1.MustNotBeSubstringOf(s2, ct, exceptionFactory)); [Fact] public static void CustomMessage() => Test.CustomMessage(message => "Foo".MustNotBeSubstringOf("Food", message: message)); [Fact] public static void CustomMessageParameterNull() => Test.CustomMessage(message => ((string) null).MustNotBeSubstringOf("Foo", message: message)); [Fact] public static void CustomMessageValueNull() => Test.CustomMessage(message => "Foo".MustNotBeSubstringOf(null!, message: message)); [Fact] public static void CustomMessageCustomComparison() => Test.CustomMessage(message => "Bar".MustNotBeSubstringOf("Walk into a bar", StringComparison.OrdinalIgnoreCase, message: message)); [Fact] public static void CustomMessageCustomComparisonParameterNull() => Test.CustomMessage(message => ((string)null).MustNotBeSubstringOf("Foo", StringComparison.Ordinal, message: message)); [Fact] public static void CustomMessageCustomComparisonValueNull() => Test.CustomMessage(message => "Foo".MustNotBeSubstringOf(null!, StringComparison.CurrentCulture, message: message)); [Fact] public static void CallerArgumentExpression() { const string message = "Foo"; var act = () => message.MustNotBeSubstringOf("Foobar"); act.Should().Throw() .WithParameterName(nameof(message)); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/StringAssertions/MustNotBeTests.cs000066400000000000000000000067531470750352700314250ustar00rootroot00000000000000using System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Light.GuardClauses.FrameworkExtensions; using Xunit; namespace Light.GuardClauses.Tests.StringAssertions; public static class MustNotBeTests { [Theory] [InlineData("Foo", "Foo", StringComparison.Ordinal)] [InlineData("Bar", "bar", StringComparison.OrdinalIgnoreCase)] [InlineData(null, null, StringComparison.CurrentCulture)] public static void ValuesEqual(string x, string y, StringComparison comparisonType) { Action act = () => x.MustNotBe(y, comparisonType, nameof(x)); act.Should().Throw() .And.Message.Should().Contain($"{nameof(x)} must not be equal to {y.ToStringOrNull()}, but it actually is {x.ToStringOrNull()}"); } [Theory] [InlineData("Foo", "Bar", StringComparison.CurrentCultureIgnoreCase)] [InlineData("Baz", "BAZ", StringComparison.CurrentCulture)] [InlineData(null, "Qux", StringComparison.Ordinal)] [InlineData("Quux", null, StringComparison.OrdinalIgnoreCase)] public static void ValuesNotEqual(string x, string y, StringComparison comparisonType) => x.MustNotBe(y, comparisonType).Should().Be(x); [Theory] [InlineData("Foo", " Foo ", StringComparisonType.OrdinalIgnoreWhiteSpace)] [InlineData("\tBar", "bar\r\n", StringComparisonType.OrdinalIgnoreCaseIgnoreWhiteSpace)] [InlineData(null, null, StringComparisonType.OrdinalIgnoreCaseIgnoreWhiteSpace)] public static void StringsEqualIgnoreWhiteSpace(string x, string y, StringComparisonType comparisonType) { Action act = () => x.MustNotBe(y, comparisonType, nameof(x)); act.Should().Throw() .And.Message.Should().Contain($"{nameof(x)} must not be equal to {y.ToStringOrNull()}, but it actually is {x.ToStringOrNull()}"); } [Theory] [InlineData("Foo", "Bar", StringComparisonType.OrdinalIgnoreWhiteSpace)] [InlineData("Baz", "", StringComparisonType.OrdinalIgnoreCaseIgnoreWhiteSpace)] [InlineData(null, "Qux", StringComparisonType.OrdinalIgnoreCaseIgnoreWhiteSpace)] public static void StringsNotEqualIgnoreWhiteSpace(string x, string y, StringComparisonType comparisonType) => x.MustNotBe(y, comparisonType).Should().BeSameAs(x); [Fact] public static void CustomException() => Test.CustomException("Foo", "Foo", (x, y, exceptionFactory) => x.MustNotBe(y, StringComparison.CurrentCulture, exceptionFactory)); [Fact] public static void CustomExceptionIgnoreWhiteSpace() => Test.CustomException("Foo", " Foo", StringComparisonType.OrdinalIgnoreWhiteSpace, (x, y, ct, exceptionFactory) => x.MustNotBe(y, ct, exceptionFactory)); [Fact] public static void CustomMessage() => Test.CustomMessage(message => "Foo".MustNotBe("Foo", StringComparison.CurrentCulture, message: message)); [Fact] public static void CustomMessageIgnoreWhiteSpace() => Test.CustomMessage(message => "Bar".MustNotBe("bar ", StringComparisonType.OrdinalIgnoreCaseIgnoreWhiteSpace, message: message)); [Fact] public static void CallerArgumentExpression() { const string message = "Foo"; var act = () => message.MustNotBe("Foo"); act.Should().Throw() .WithParameterName(nameof(message)); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/StringAssertions/MustNotContainTests.cs000066400000000000000000000113321470750352700324570ustar00rootroot00000000000000using System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Light.GuardClauses.FrameworkExtensions; using Xunit; namespace Light.GuardClauses.Tests.StringAssertions; public static class MustNotContainTests { [Theory] [InlineData("Foo", "o")] [InlineData("bar", "ba")] [InlineData("baz", "az")] [InlineData("qux", "qux")] [InlineData("quux", "")] public static void ContainsValue(string @string, string value) { Action act = () => @string.MustNotContain(value, nameof(@string)); var assertion = act.Should().Throw().Which; assertion.Message.Should().Contain($"{nameof(@string)} must not contain {value.ToStringOrNull()} as a substring, but it actually is {@string.ToStringOrNull()}."); assertion.ParamName.Should().BeSameAs(nameof(@string)); } [Theory] [InlineData("Foo", "O", StringComparison.OrdinalIgnoreCase)] [InlineData("Bar", "ar", StringComparison.Ordinal)] [InlineData("Baz", "Baz", StringComparison.CurrentCulture)] [InlineData("Qux", "", StringComparison.Ordinal)] public static void ContainsValueCustomSearch(string x, string y, StringComparison comparisonType) { Action act = () => x.MustNotContain(y, comparisonType, nameof(x)); var assertion = act.Should().Throw().Which; assertion.Message.Should().Contain($"{nameof(x)} must not contain {y.ToStringOrNull()} as a substring ({comparisonType}), but it actually is {x.ToStringOrNull()}."); assertion.ParamName.Should().BeSameAs(nameof(x)); } [Theory] [InlineData("Foo", "Bar")] [InlineData("Baz", "zab")] [InlineData("Qux", "Quux")] public static void NotContainsValue(string @string, string value) => @string.MustNotContain(value).Should().BeSameAs(@string); [Theory] [InlineData("Foo", "Bar", StringComparison.OrdinalIgnoreCase)] [InlineData("Baz", "BAZ", StringComparison.Ordinal)] public static void NotContainsValueCustomSearch(string x, string y, StringComparison comparisonType) => x.MustNotContain(y, comparisonType).Should().BeSameAs(x); [Theory] [InlineData("Foo", "o")] [InlineData(null, "Bar")] [InlineData("Baz", null)] public static void CustomException(string first, string second) => Test.CustomException(first, second, (x, y, exceptionFactory) => x.MustNotContain(y, exceptionFactory)); [Theory] [InlineData("Foo", "O", StringComparison.OrdinalIgnoreCase)] [InlineData("Bar", null, StringComparison.CurrentCulture)] [InlineData(null, "Baz", StringComparison.CurrentCultureIgnoreCase)] public static void CustomExceptionCustomSearch(string first, string second, StringComparison comparisonType) => Test.CustomException(first, second, comparisonType, (x, y, ct, exceptionFactory) => x.MustNotContain(y, ct, exceptionFactory)); [Fact] public static void NoCustomExceptionThrown() => "Foo".MustNotContain("Bar", (_, _) => new Exception()).Should().BeSameAs("Foo"); [Fact] public static void NoCustomExceptionThrownOnCustomSearch() => "Foo".MustNotContain("FOO", StringComparison.CurrentCulture, (_, _, _) => new Exception()).Should().BeSameAs("Foo"); [Fact] public static void CustomMessage() => Test.CustomMessage(message => "Foo".MustNotContain("o", message: message)); [Fact] public static void CustomMessageCustomSearch() => Test.CustomMessage(message => "Foo".MustNotContain("o", StringComparison.CurrentCulture, message: message)); [Fact] public static void CustomMessageParameterNull() => Test.CustomMessage(message => ((string) null).MustNotContain("Foo", message: message)); [Fact] public static void CustomMessageCustomSearchParameterNull() => Test.CustomMessage(message => ((string) null).MustNotContain("Foo", StringComparison.Ordinal, message: message)); [Fact] public static void CustomMessageValueNull() => Test.CustomMessage(message => "Foo".MustNotContain(null!, message: message)); [Fact] public static void CustomMessageCustomSearchValueNull() => Test.CustomMessage(message => "Foo".MustNotContain(null!, StringComparison.Ordinal, message: message)); [Fact] public static void CallerArgumentExpression() { const string bar = "Bar"; var act = () => bar.MustNotContain("ar"); act.Should().Throw() .WithParameterName(nameof(bar)); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/StringAssertions/MustNotEndWithTests.cs000066400000000000000000000053451470750352700324350ustar00rootroot00000000000000using System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.StringAssertions; public static class MustNotEndWithTests { [Theory] [InlineData("FooBar", "Bar")] [InlineData("When you play the game of thrones you win, or you die.", "die.")] public static void DoesEndWith(string x, string y) { var act = () => x.MustNotEndWith(y); var exception = act.Should().Throw().Which; exception.Message.Should().StartWith($"{nameof(x)} must not end with \"{y}\" (CurrentCulture), but it actually is \"{x}\"."); exception.ParamName.Should().BeSameAs(nameof(x)); } [Theory] [InlineData("Foo", "Bar", StringComparison.Ordinal)] [InlineData("12345", "1234", StringComparison.InvariantCultureIgnoreCase)] public static void DoesNotEndWith(string x, string y, StringComparison comparisonType) => x.MustNotEndWith(y, comparisonType).Should().BeSameAs(x); [Fact] public static void ParameterNull() { var act = () => ((string) null).MustNotEndWith("Foo"); act.Should().Throw(); } [Fact] public static void ValueNull() { var act = () => "Foo".MustNotEndWith(null!); act.Should().Throw(); } [Fact] public static void CustomMessage() => Test.CustomMessage(message => "FooBar".MustNotEndWith("Bar", message: message)); [Fact] public static void CustomMessageParameterNull() => Test.CustomMessage(message => ((string) null).MustNotEndWith("Bar", message: message)); [Fact] public static void DoesNotEndWithCustomException() => "Foo".MustNotEndWith("r", (_, _) => new Exception()).Should().Be("Foo"); [Fact] public static void DoesNotEndWithCustomExceptionAndComparisonType() => "Foo".MustNotEndWith("R", StringComparison.OrdinalIgnoreCase, (_, _, _) => new Exception()).Should().Be("Foo"); [Theory] [InlineData("FooBar", "Bar")] [InlineData("Foo", null)] [InlineData(null, "Baz")] public static void CustomException(string first, string second) => Test.CustomException(first, second, (s1, s2, exceptionFactory) => s1.MustNotEndWith(s2, exceptionFactory)); [Theory] [InlineData("FooBar", "Bar", StringComparison.Ordinal)] [InlineData(null, "Bar", StringComparison.Ordinal)] [InlineData("Baz", null, StringComparison.Ordinal)] public static void CustomExceptionWithComparisonType(string a, string b, StringComparison comparisonType) => Test.CustomException(a, b, comparisonType, (s1, s2, ct, exceptionFactory) => s1.MustNotEndWith(s2, ct, exceptionFactory)); } Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/StringAssertions/MustNotStartWithTests.cs000066400000000000000000000063471470750352700330270ustar00rootroot00000000000000using System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.StringAssertions; public static class MustNotStartWithTests { [Theory] [InlineData("Bar", "Foo")] [InlineData("When you play the game of thrones you win, or you die.", "Love and peace")] public static void DoesNotStartWith(string x, string y) => x.MustNotStartWith(y).Should().BeSameAs(x); [Theory] [InlineData("FooBar", "Foo")] [InlineData("12345678", "1234")] public static void StartsWith(string x, string y) { var act = () => x.MustNotStartWith(y); var exception = act.Should().Throw().Which; exception.Message.Should().StartWith($"{nameof(x)} must not start with \"{y}\" (CurrentCulture), but it actually is \"{x}\""); exception.ParamName.Should().BeSameAs(nameof(x)); } [Theory] [InlineData("FooBar", "Foo", StringComparison.Ordinal)] [InlineData("12345678", "1234", StringComparison.InvariantCultureIgnoreCase)] public static void StartsWithComparisonType(string x, string y, StringComparison comparisonType) { var act = () => x.MustNotStartWith(y, comparisonType); var exception = act.Should().Throw().Which; exception.Message.Should().StartWith($"{nameof(x)} must not start with \"{y}\" ({comparisonType}), but it actually is \"{x}\""); exception.ParamName.Should().BeSameAs(nameof(x)); } [Fact] public static void ParameterNull() { var act = () => ((string)null).MustNotStartWith("Foo"); act.Should().Throw(); } [Fact] public static void ValueNull() { var act = () => "Foo".MustNotStartWith(null!); act.Should().Throw(); } [Fact] public static void CustomMessage() => Test.CustomMessage(message => "FooBar".MustNotStartWith("Foo", message: message)); [Fact] public static void CustomMessageParameterNull() => Test.CustomMessage(message => ((string)null).MustNotStartWith("Bar", message: message)); [Fact] public static void NotStartsWithCustomException() => "Bar".MustNotStartWith("Foo", (_, _) => new Exception()).Should().Be("Bar"); [Fact] public static void NotStartsWithCustomExceptionAndComparisonType() => "Bar".MustNotStartWith("foo", StringComparison.OrdinalIgnoreCase, (_, _, _) => new Exception()).Should().Be("Bar"); [Theory] [InlineData("Foo", "Foo")] [InlineData("Foo", null)] [InlineData(null, "Baz")] public static void CustomException(string first, string second) => Test.CustomException(first, second, (s1, s2, exceptionFactory) => s1.MustNotStartWith(s2, exceptionFactory)); [Theory] [InlineData("Foo", "foo", StringComparison.OrdinalIgnoreCase)] [InlineData(null, "Bar", StringComparison.Ordinal)] [InlineData("Baz", null, StringComparison.Ordinal)] public static void CustomExceptionWithComparisonType(string a, string b, StringComparison comparisonType) => Test.CustomException(a, b, comparisonType, (s1, s2, ct, exceptionFactory) => s1.MustNotStartWith(s2, ct, exceptionFactory)); } Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/StringAssertions/MustStartWithTests.cs000066400000000000000000000053571470750352700323460ustar00rootroot00000000000000using System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.StringAssertions; public static class MustStartWithTests { [Theory] [InlineData("Foo", "Bar")] [InlineData("When you play the game of thrones you win, or you die. There is no middle ground.", "Love and peace")] public static void DoesNotStartWith(string x, string y) { var act = () => x.MustStartWith(y); var exception = act.Should().Throw().Which; exception.Message.Should().StartWith($"{nameof(x)} must start with \"{y}\" (CurrentCulture), but it actually is \"{x}\"."); exception.ParamName.Should().BeSameAs(nameof(x)); } [Theory] [InlineData("FooBar", "Foo", StringComparison.Ordinal)] [InlineData("12345678", "1234", StringComparison.InvariantCultureIgnoreCase)] public static void StartsWith(string x, string y, StringComparison comparisonType) => x.MustStartWith(y, comparisonType).Should().BeSameAs(x); [Fact] public static void ParameterNull() { var act = () => ((string) null).MustStartWith("Foo"); act.Should().Throw(); } [Fact] public static void ValueNull() { var act = () => "Foo".MustStartWith(null!); act.Should().Throw(); } [Fact] public static void CustomMessage() => Test.CustomMessage(message => "Foo".MustStartWith("Bar", message: message)); [Fact] public static void CustomMessageParameterNull() => Test.CustomMessage(message => ((string) null).MustStartWith("Bar", message: message)); [Fact] public static void StartsWithCustomException() => "Foo".MustStartWith("F", (_, _) => new Exception()).Should().Be("Foo"); [Fact] public static void StartsWithCustomExceptionAndComparisonType() => "Foo".MustStartWith("f", StringComparison.OrdinalIgnoreCase, (_, _, _) => new Exception()).Should().Be("Foo"); [Theory] [InlineData("Foo", "Bar")] [InlineData("Foo", null)] [InlineData(null, "Baz")] public static void CustomException(string first, string second) => Test.CustomException(first, second, (s1, s2, exceptionFactory) => s1.MustStartWith(s2, exceptionFactory)); [Theory] [InlineData("Foo", "Bar", StringComparison.Ordinal)] [InlineData(null, "Bar", StringComparison.Ordinal)] [InlineData("Baz", null, StringComparison.Ordinal)] public static void CustomExceptionWithComparisonType(string a, string b, StringComparison comparisonType) => Test.CustomException(a, b, comparisonType, (s1, s2, ct, exceptionFactory) => s1.MustStartWith(s2, ct, exceptionFactory)); }OrdinalIgnoreCaseIgnoreWhiteSpaceComparerTests.cs000066400000000000000000000033631470750352700376220ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/StringAssertionsusing System; using FluentAssertions; using Xunit; using Xunit.Abstractions; namespace Light.GuardClauses.Tests.StringAssertions; public sealed class OrdinalIgnoreCaseIgnoreWhiteSpaceComparerTests { private static readonly OrdinalIgnoreCaseIgnoreWhiteSpaceComparer Comparer = new (); private readonly ITestOutputHelper _output; public OrdinalIgnoreCaseIgnoreWhiteSpaceComparerTests(ITestOutputHelper output) => _output = output.MustNotBeNull(nameof(output)); [Theory] [InlineData("Foo", "FOO", true)] [InlineData(" Bar", "bar ", true)] [InlineData("B a z", "bAZ", true)] [InlineData("Qu\tx", " qux", true)] [InlineData("{\r\n \"foo\": \"Bar\"\r\n}", "{\"FOO\": \"BAR\"}", true)] [InlineData("Foo", "Bar", false)] [InlineData("", "some content", false)] [InlineData("", "", true)] public static void CheckEquals(string x, string y, bool expected) => Comparer.Equals(x, y).Should().Be(expected); [Theory] [InlineData(null, "Foo")] [InlineData("Foo", null)] public void EqualsStringNull(string x, string y) { // ReSharper disable once ReturnValueOfPureMethodIsNotUsed Action act = () => Comparer.Equals(x, y); act.Should().Throw().WriteExceptionTo(_output); } [Theory] [InlineData("Foo", "foo")] [InlineData("B a\tr", "Bar")] public static void CheckGetHashCode(string x, string y) => Comparer.GetHashCode(x).Should().Be(Comparer.GetHashCode(y)); [Fact] public void GetHashCodeStringNull() { // ReSharper disable once ReturnValueOfPureMethodIsNotUsed Action act = () => Comparer.GetHashCode(null!); act.Should().Throw().WriteExceptionTo(_output); } }OrdinalIgnoreWhiteSpaceComparerTests.cs000066400000000000000000000035411470750352700356600ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/StringAssertionsusing System; using FluentAssertions; using Xunit; using Xunit.Abstractions; namespace Light.GuardClauses.Tests.StringAssertions; public sealed class OrdinalIgnoreWhiteSpaceComparerTests { private static readonly OrdinalIgnoreWhiteSpaceComparer Comparer = new (); private readonly ITestOutputHelper _output; public OrdinalIgnoreWhiteSpaceComparerTests(ITestOutputHelper output) => _output = output.MustNotBeNull(nameof(output)); [Theory] [InlineData("Foo", " Foo", true)] [InlineData("Bar", "Bar ", true)] [InlineData("\t Baz\r\n", "Baz", true)] [InlineData("Qux", "Qux", true)] [InlineData("{\r\n \"foo\": 42\r\n}\r\n", "{\"foo\":42}", true)] [InlineData("Foo", "Bar", false)] [InlineData(" Baz", "Qux ", false)] [InlineData("Foo", "foo", false)] [InlineData("Bar\t", "bar ", false)] [InlineData("", "", true)] public static void CheckEquals(string x, string y, bool expected) => Comparer.Equals(x, y).Should().Be(expected); [Theory] [InlineData(null, "Foo")] [InlineData("Foo", null)] public void EqualsStringNull(string x, string y) { // ReSharper disable once ReturnValueOfPureMethodIsNotUsed Action act = () => Comparer.Equals(x, y); act.Should().Throw().WriteExceptionTo(_output); } [Theory] [InlineData("Foo", "Foo")] [InlineData(" Bar", "Bar ")] [InlineData("{\r\n\t\"foo\": 42\r\n}\r\n", "{\"foo\": 42}")] public static void CheckGetHashCode(string x, string y) => Comparer.GetHashCode(x).Should().Be(Comparer.GetHashCode(y)); [Fact] public void GetHashCodeStringNull() { // ReSharper disable once ReturnValueOfPureMethodIsNotUsed Action act = () => Comparer.GetHashCode(null); act.Should().Throw().WriteExceptionTo(_output); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/Test.cs000066400000000000000000000074571470750352700241220ustar00rootroot00000000000000using System; using FluentAssertions; using FluentAssertions.Specialized; using Xunit.Abstractions; using Xunit.Sdk; #nullable enable namespace Light.GuardClauses.Tests; public static class Test { private static readonly ExceptionDummy Exception = new (); private static readonly Func ExceptionFactory = () => Exception; public static void CustomException(Action> executeAssertion) { try { executeAssertion(ExceptionFactory); throw new XunitException("The assertion should have thrown a custom exception at this point."); } catch (ExceptionDummy exception) { exception.Should().BeSameAs(Exception); } } public static void CustomException(T invalidValue, Action> executeAssertion) { T? capturedParameter = default; Exception ExceptionFactory(T parameter) { capturedParameter = parameter; return Exception; } try { executeAssertion(invalidValue, ExceptionFactory); throw new XunitException("The assertion should have thrown a custom exception at this point."); } catch (ExceptionDummy exception) { exception.Should().BeSameAs(Exception); capturedParameter.Should().Be(invalidValue); } } public static void CustomException(T1 first, T2 second, Action> executeAssertion) { T1? capturedFirst = default; T2? capturedSecond = default; Exception ExceptionFactory(T1 x, T2 y) { capturedFirst = x; capturedSecond = y; return Exception; } try { executeAssertion(first, second, ExceptionFactory); throw new XunitException("The assertion should have thrown a custom exception at this point."); } catch (ExceptionDummy exception) { exception.Should().BeSameAs(Exception); capturedFirst.Should().Be(first); capturedSecond.Should().Be(second); } } public static void CustomException(T1 first, T2 second, T3 third, Action> executeAssertion) { T1? capturedFirst = default; T2? capturedSecond = default; T3? capturedThird = default; Exception ExceptionFactory(T1 x, T2 y, T3 z) { capturedFirst = x; capturedSecond = y; capturedThird = z; return Exception; } try { executeAssertion(first, second, third, ExceptionFactory); throw new XunitException("The assertion should have thrown a custom exception at this point."); } catch (ExceptionDummy exception) { exception.Should().BeSameAs(Exception); capturedFirst.Should().Be(first); capturedSecond.Should().Be(second); capturedThird.Should().Be(third); } } public static void CustomMessage(Action executeAssertion) where TException : Exception { const string message = "This is a custom exception message"; try { executeAssertion(message); throw new XunitException("The assertion should have thrown a custom exception at this point."); } catch (TException exception) { exception.Message.Should().Contain(message); } } private sealed class ExceptionDummy : Exception { }; public static void WriteExceptionTo(this ExceptionAssertions exceptionAssertions, ITestOutputHelper output) where T : Exception => output.WriteLine(exceptionAssertions.Which.ToString()); }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/TypeAssertions/000077500000000000000000000000001470750352700256335ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/TypeAssertions/DerivesFromTests.cs000066400000000000000000000055701470750352700314410ustar00rootroot00000000000000using System; using System.Collections.Generic; using FluentAssertions; using Xunit; namespace Light.GuardClauses.Tests.TypeAssertions; public static class DerivesFromTests { [Fact] public static void ReferenceTypeValidBaseClass() => TestIsDerivingFrom(typeof(string), typeof(object), true); [Fact] public static void ValueTypeValidBaseClass() => TestIsDerivingFrom(typeof(int), typeof(object), true); [Fact] public static void SameNonGenericType() { TestIsDerivingFrom(typeof(double), typeof(double), false); TestIsDerivingFrom(typeof(string), typeof(string), false); } [Fact] public static void ValueTypeNonObjectBaseClass() => TestIsDerivingFrom(typeof(double), typeof(ValueType), true); [Fact] public static void EnumTypeValidBaseClass() { TestIsDerivingFrom(typeof(ConsoleColor), typeof(Enum), true); TestIsDerivingFrom(typeof(Enum), typeof(ConsoleColor), false); } [Fact] public static void ClosedBoundGenericTypeWithValidGenericTypeDefinition() { TestIsDerivingFrom(typeof(StringDictionary), typeof(Dictionary<,>), true); TestIsDerivingFrom(typeof(Dictionary<,>), typeof(StringDictionary), false); } [Fact] public static void ClosedBoundGenericTypeWithObject() { TestIsDerivingFrom(typeof(Dictionary), typeof(object), true); TestIsDerivingFrom(typeof(object), typeof(Dictionary), false); } [Fact] public static void SameGenericType() { TestIsDerivingFrom(typeof(Dictionary), typeof(Dictionary), false); TestIsDerivingFrom(typeof(Dictionary<,>), typeof(Dictionary), false); } [Fact] public static void GenericTypeDefinitionOfSameType() => TestIsDerivingFrom(typeof(Dictionary), typeof(Dictionary<,>), false); [Fact] public static void WrongBaseType() => TestIsDerivingFrom(typeof(Exception), typeof(ArgumentException), false); private static void TestIsDerivingFrom(Type type, Type baseClass, bool expected) => type.DerivesFrom(baseClass).Should().Be(expected); [Fact] public static void TypeNull() { var type = default(Type); // ReSharper disable once ExpressionIsAlwaysNull Action act = () => type.DerivesFrom(typeof(object)); act.Should().Throw() .WithParameterName(nameof(type)); } [Fact] public static void BaseClassNull() { var baseClass = default(Type); // ReSharper disable once ExpressionIsAlwaysNull Action act = () => typeof(string).DerivesFrom(baseClass); act.Should().Throw() .WithParameterName(nameof(baseClass)); } public sealed class StringDictionary : Dictionary { } }EquivalentTypeCompererTests.cs000066400000000000000000000040531470750352700336040ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/TypeAssertionsusing System; using System.Collections; using System.Collections.Generic; using FluentAssertions; using Xunit; namespace Light.GuardClauses.Tests.TypeAssertions; public static class EquivalentTypeCompererTests { [Fact] public static void CheckEquality() { CheckEquals(typeof(string), typeof(string), true); CheckEquals(typeof(IComparer), typeof(IEnumerator), false); CheckEquals(typeof(List), typeof(List), true); CheckEquals(typeof(List), typeof(List<>), true); CheckEquals(typeof(List<>), typeof(List), true); CheckEquals(typeof(IDictionary<,>), typeof(IDictionary<,>), true); CheckEquals(typeof(IDictionary<,>), typeof(Dictionary<,>), false); CheckEquals(null, typeof(Dictionary<,>), false); CheckEquals(typeof(double), null, false); CheckEquals(null, null, true); } private static void CheckEquals(Type x, Type y, bool expected) => new EquivalentTypeComparer().Equals(x, y).Should().Be(expected); [Fact] public static void HashCode() { CheckGetHashCode(typeof(int), typeof(int), true); CheckGetHashCode(typeof(double), typeof(object), false); CheckGetHashCode(typeof(IList), typeof(IList<>), true); CheckGetHashCode(typeof(IDictionary), typeof(IDictionary<,>), true); CheckGetHashCode(typeof(Dictionary), typeof(IDictionary), false); CheckGetHashCode(typeof(Dictionary), typeof(IDictionary<,>), false); CheckGetHashCode(null, typeof(int), false); CheckGetHashCode(typeof(short), null, false); CheckGetHashCode(null, null, false); } private static void CheckGetHashCode(Type x, Type y, bool shouldBeEqualHashCodes) { var comparer = new EquivalentTypeComparer(); var firstHashCode = comparer.GetHashCode(x); var secondHashCode = comparer.GetHashCode(y); if (shouldBeEqualHashCodes) firstHashCode.Should().Be(secondHashCode); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/TypeAssertions/GenericTypeKinds.cs000066400000000000000000000012551470750352700313740ustar00rootroot00000000000000using System; using System.Collections.Generic; using System.Reflection; namespace Light.GuardClauses.Tests.TypeAssertions; public static class GenericTypeKinds { public static readonly Type NonGenericType = typeof(string); public static readonly Type ClosedConstructedGenericType = typeof(List); public static readonly Type GenericTypeDefinition = typeof(IList<>); public static readonly Type OpenConstructedGenericType = typeof(GuidDictionary<>).GetTypeInfo().BaseType; public static readonly Type GenericTypeParameter = typeof(GuidDictionary<>).GetTypeInfo().GenericTypeParameters[0]; public class GuidDictionary : Dictionary { } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/TypeAssertions/ImplementsTests.cs000066400000000000000000000042631470750352700313270ustar00rootroot00000000000000using System; using System.Collections; using System.Collections.Generic; using System.Collections.ObjectModel; using FluentAssertions; using Xunit; namespace Light.GuardClauses.Tests.TypeAssertions; public static class ImplementsTests { [Fact] public static void InterfaceTypes() { CheckImplements(typeof(ArrayList), typeof(IList), true); CheckImplements(typeof(List), typeof(IEnumerable), true); CheckImplements(typeof(List), typeof(IList<>), true); CheckImplements(typeof(ObservableCollection<>), typeof(ICollection<>), true); CheckImplements(typeof(ICollection), typeof(IEnumerable), true); CheckImplements(typeof(IList), typeof(ICollection<>), true); CheckImplements(typeof(IList<>), typeof(ICollection<>), true); CheckImplements(typeof(Exception), typeof(IObservable<>), false); CheckImplements(typeof(IList), typeof(IList), false); CheckImplements(typeof(IList), typeof(IList<>), false); CheckImplements(typeof(IList<>), typeof(IList<>), false); } [Fact] public static void OtherTypes() { CheckImplements(typeof(Array), typeof(MulticastDelegate), false); CheckImplements(typeof(string), typeof(object), false); CheckImplements(typeof(IsEquivalentTypeToTests.GenericType<>), typeof(int), false); } [Fact] public static void TypeNull() { var type = default(Type); // ReSharper disable once ExpressionIsAlwaysNull Action act = () => type.Implements(typeof(IComparable)); act.Should().Throw() .WithParameterName(nameof(type)); } [Fact] public static void InterfaceTypeNull() { var interfaceType = default(Type); // ReSharper disable once ExpressionIsAlwaysNull Action act = () => typeof(List).Implements(interfaceType); act.Should().Throw() .WithParameterName(nameof(interfaceType)); } private static void CheckImplements(Type type, Type interfaceType, bool expected) => type.Implements(interfaceType).Should().Be(expected); }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/TypeAssertions/InheritsFromTests.cs000066400000000000000000000052051470750352700316200ustar00rootroot00000000000000using System; using System.Collections.Generic; using System.Collections.ObjectModel; using System.Text; using FluentAssertions; using Xunit; namespace Light.GuardClauses.Tests.TypeAssertions; public static class InheritsFromTests { [Fact] public static void BaseClasses() { CheckInheritsFrom(typeof(ArgumentException), typeof(Exception), true); CheckInheritsFrom(typeof(ArgumentNullException), typeof(Exception), true); CheckInheritsFrom(typeof(List<>), typeof(Encoding), false); CheckInheritsFrom(typeof(ObservableCollection), typeof(Collection<>), true); CheckInheritsFrom(typeof(double), typeof(ValueType), true); } [Fact] public static void Interfaces() { CheckInheritsFrom(typeof(string), typeof(IComparable), true); CheckInheritsFrom(typeof(string), typeof(IEnumerable), true); CheckInheritsFrom(typeof(string), typeof(IEnumerable<>), true); CheckInheritsFrom(typeof(string), typeof(IEqualityComparer<>), false); CheckInheritsFrom(typeof(int), typeof(IEquatable), true); CheckInheritsFrom(typeof(int), typeof(IServiceProvider), false); CheckInheritsFrom(typeof(IList), typeof(ICollection), true); CheckInheritsFrom(typeof(IList), typeof(ICollection<>), true); CheckInheritsFrom(typeof(IList<>), typeof(IDictionary<,>), false); } [Fact] public static void OtherTypes() { CheckInheritsFrom(typeof(int), typeof(ConsoleColor), false); CheckInheritsFrom(typeof(string), typeof(double), false); CheckInheritsFrom(typeof(UnicodeEncoding), typeof(Func<>), false); } [Fact] public static void TypeNull() { var type = default(Type); // ReSharper disable once ExpressionIsAlwaysNull Action act = () => type.InheritsFrom(typeof(object)); act.Should().Throw() .WithParameterName(nameof(type)); } [Fact(DisplayName = "IsDerivingFromOrImplementing must throw an ArgumentNullException when the specified base type is null.")] public static void BaseTypeNull() { var baseClassOrInterfaceType = default(Type); // ReSharper disable once ExpressionIsAlwaysNull Action act = () => typeof(string).InheritsFrom(baseClassOrInterfaceType); act.Should().Throw() .WithParameterName(nameof(baseClassOrInterfaceType)); } private static void CheckInheritsFrom(Type type, Type baseClassOrInterfaceType, bool expected) { type.InheritsFrom(baseClassOrInterfaceType).Should().Be(expected); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/TypeAssertions/IsEquivalentToTypeTests.cs000066400000000000000000000066461470750352700327770ustar00rootroot00000000000000using FluentAssertions; using System; using System.Collections.Generic; using System.Linq; using System.Reflection; using Xunit; namespace Light.GuardClauses.Tests.TypeAssertions; public static class IsEquivalentTypeToTests { [Theory] [InlineData(typeof(string), typeof(string), true)] [InlineData(typeof(double), typeof(double), true)] [InlineData(typeof(int), typeof(object), false)] [InlineData(typeof(ArgumentException), typeof(Exception), false)] [InlineData(null, null, true)] [InlineData(null, typeof(object), false)] [InlineData(typeof(object), null, false)] public static void NonGenericTypes(Type type, Type other, bool expected) => type.IsEquivalentTypeTo(other).Should().Be(expected); [Fact] public static void GenericTypeDefinition() => TestEquivalence(typeof(List<>), typeof(List<>), true); [Fact] public static void ClosedConstructedGenericType() => TestEquivalence(typeof(IList), typeof(IList), true); [Fact] public static void UnequalClosedConstructedGenericType() => TestEquivalence(typeof(IReadOnlyList), typeof(IReadOnlyList), false); [Fact] public static void OpenConstructedGenericTypeAndGenericTypeDefinition() => TestEquivalence(typeof(SubTypeA<>).GetTypeInfo().BaseType, typeof(GenericType<>), true); [Fact] public static void ClosedConstructedBaseType() => TestEquivalence(typeof(SubTypeB).GetTypeInfo().BaseType, typeof(GenericType), true); [Fact] public static void ClosedConstructedBaseTypeAndGenericTypeDefinition() => TestEquivalence(typeof(SubTypeA).GetTypeInfo().BaseType, typeof(GenericType<>), true); [Fact] public static void DifferentTypes() => TestEquivalence(typeof(SubTypeA).GetTypeInfo().BaseType, typeof(List<>), false); [Fact] public static void OpenConstructedReturnTypeAndGenericTypeDefinition() => TestEquivalence(CreateDictionaryOfTKeyTValue.ReturnType, typeof(Dictionary<,>), true); [Fact] public static void PartiallyConstructedReturnTypeAndGenericTypeDefinition() => TestEquivalence(CreateDictionaryOfTKey.ReturnType, typeof(Dictionary<,>), true); [Fact] public static void DifferentConstructedGenericTypes() => TestEquivalence(CreateDictionaryOfTKeyTValue.ReturnType, CreateDictionaryOfTKey.ReturnType, false); private static void TestEquivalence(Type first, Type second, bool expected) { first.IsEquivalentTypeTo(second).Should().Be(expected); second.IsEquivalentTypeTo(first).Should().Be(expected); } public class GenericType { } public class SubTypeA : GenericType { } public class SubTypeB : GenericType { } public static Dictionary CreateDictionaryA() => new (); public static Dictionary CreateDictionaryB() => new (); private static readonly MethodInfo CreateDictionaryOfTKeyTValue; private static readonly MethodInfo CreateDictionaryOfTKey; static IsEquivalentTypeToTests() { var typeInfo = typeof(IsEquivalentTypeToTests).GetTypeInfo(); CreateDictionaryOfTKeyTValue = typeInfo.DeclaredMethods.First(m => m.IsStatic && m.Name.StartsWith(nameof(CreateDictionaryA))); CreateDictionaryOfTKey = typeInfo.DeclaredMethods.First(m => m.IsStatic && m.Name.StartsWith(nameof(CreateDictionaryB))); } }IsOpenConstructedGenericTypeTests.cs000066400000000000000000000022531470750352700347020ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/TypeAssertionsusing System; using FluentAssertions; using Xunit; namespace Light.GuardClauses.Tests.TypeAssertions; public static class IsOpenConstructedGenericTypeTests { [Fact] public static void NonGenericType() => GenericTypeKinds.NonGenericType.IsOpenConstructedGenericType().Should().BeFalse(); [Fact] public static void ClosedConstructedType() => GenericTypeKinds.ClosedConstructedGenericType.IsOpenConstructedGenericType().Should().BeFalse(); [Fact] public static void GenericTypeDefinition() => GenericTypeKinds.GenericTypeDefinition.IsOpenConstructedGenericType().Should().BeFalse(); [Fact] public static void OpenConstructedGenericType() => GenericTypeKinds.OpenConstructedGenericType.IsOpenConstructedGenericType().Should().BeTrue(); [Fact] public static void GenericTypeParameter() => GenericTypeKinds.GenericTypeParameter.IsOpenConstructedGenericType().Should().BeFalse(); [Fact] public static void ArgumentNull() { Action act = () => ((Type) null).IsOpenConstructedGenericType(); act.Should().Throw() .WithParameterName("type"); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/TypeAssertions/IsOrDerivesFromTests.cs000066400000000000000000000032371470750352700322340ustar00rootroot00000000000000using System; using System.Collections.Generic; using System.Collections.ObjectModel; using FluentAssertions; using Xunit; namespace Light.GuardClauses.Tests.TypeAssertions; public static class IsOrDerivesFromTests { [Fact] public static void BasicFunctionality() { CheckIsOrDerivesFrom(typeof(int), typeof(int), true); CheckIsOrDerivesFrom(typeof(int), typeof(ValueType), true); CheckIsOrDerivesFrom(typeof(int), typeof(double), false); CheckIsOrDerivesFrom(typeof(List<>), typeof(IList<>), false); CheckIsOrDerivesFrom(typeof(ObservableCollection), typeof(Collection), true); CheckIsOrDerivesFrom(typeof(ObservableCollection), typeof(Collection<>), true); CheckIsOrDerivesFrom(typeof(List<>), typeof(object), true); CheckIsOrDerivesFrom(typeof(List<>), typeof(HashSet<>), false); } [Fact] public static void TypeNull() { var type = default(Type); // ReSharper disable once ExpressionIsAlwaysNull Action act = () => type.IsOrDerivesFrom(typeof(object)); act.Should().Throw() .WithParameterName(nameof(type)); } [Fact] public static void OtherTypeNull() { var otherType = default(Type); // ReSharper disable once ExpressionIsAlwaysNull Action act = () => typeof(object).IsOrDerivesFrom(otherType); act.Should().Throw() .WithParameterName(nameof(otherType)); } private static void CheckIsOrDerivesFrom(Type type, Type otherType, bool expected) => type.IsOrDerivesFrom(otherType).Should().Be(expected); }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/TypeAssertions/IsOrImplementsTests.cs000066400000000000000000000032431470750352700321210ustar00rootroot00000000000000using System; using System.Collections.Generic; using FluentAssertions; using Xunit; namespace Light.GuardClauses.Tests.TypeAssertions; public static class IsOrImplementsTests { [Fact] public static void BasicFunctionality() { CheckIsOrImplements(typeof(string), typeof(string), true); CheckIsOrImplements(typeof(string), typeof(object), false); CheckIsOrImplements(typeof(string), typeof(IComparable), true); CheckIsOrImplements(typeof(ICollection), typeof(ICollection), true); CheckIsOrImplements(typeof(ICollection), typeof(ICollection<>), true); CheckIsOrImplements(typeof(ICollection), typeof(IEnumerable<>), true); CheckIsOrImplements(typeof(ICollection), typeof(IList), false); CheckIsOrImplements(typeof(ICollection), typeof(IList<>), false); } [Fact] public static void TypeNull() { var type = default(Type); // ReSharper disable once ExpressionIsAlwaysNull Action act = () => type.IsOrImplements(typeof(object)); act.Should().Throw() .WithParameterName(nameof(type)); } [Fact] public static void OtherTypeNull() { var otherType = default(Type); // ReSharper disable once ExpressionIsAlwaysNull Action act = () => typeof(object).IsOrImplements(otherType); act.Should().Throw() .WithParameterName(nameof(otherType)); } private static void CheckIsOrImplements(Type type, Type otherType, bool expected) => type.IsOrImplements(otherType).Should().Be(expected); }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/TypeAssertions/IsOrInheritsFromTests.cs000066400000000000000000000033341470750352700324160ustar00rootroot00000000000000using System; using System.Collections.Generic; using FluentAssertions; using Xunit; namespace Light.GuardClauses.Tests.TypeAssertions; public static class IsOrInheritsFromTests { [Fact] public static void BasicFunctionality() { CheckIsOrInheritsFrom(typeof(string), typeof(string), true); CheckIsOrInheritsFrom(typeof(int), typeof(ValueType), true); CheckIsOrInheritsFrom(typeof(double), typeof(decimal), false); CheckIsOrInheritsFrom(typeof(Exception), typeof(object), true); CheckIsOrInheritsFrom(typeof(char), typeof(IConvertible), true); CheckIsOrInheritsFrom(typeof(bool), typeof(IDisposable), false); CheckIsOrInheritsFrom(typeof(IList), typeof(ICollection), true); CheckIsOrInheritsFrom(typeof(IList), typeof(ICollection<>), true); CheckIsOrInheritsFrom(typeof(Dictionary), typeof(Dictionary), false); } [Fact] public static void TypeNull() { var type = default(Type); // ReSharper disable once ExpressionIsAlwaysNull Action act = () => type.IsOrInheritsFrom(typeof(object)); act.Should().Throw() .WithParameterName(nameof(type)); } [Fact] public static void OtherTypeNull() { var otherType = default(Type); // ReSharper disable once ExpressionIsAlwaysNull Action act = () => typeof(object).IsOrInheritsFrom(otherType); act.Should().Throw() .WithParameterName(nameof(otherType)); } private static void CheckIsOrInheritsFrom(Type type, Type otherType, bool expected) => type.IsOrInheritsFrom(otherType).Should().Be(expected); }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/UriAssertions/000077500000000000000000000000001470750352700254515ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/UriAssertions/MustBeAbsoluteUriTests.cs000066400000000000000000000052431470750352700324050ustar00rootroot00000000000000using System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.UriAssertions; public static class MustBeAbsoluteUriTests { [Theory(DisplayName = "MustBeAbsoluteUri must not throw an exception when the specified uri is an absolute one.")] [MemberData(nameof(AbsoluteUriData))] public static void AbsoluteUri(Uri absoluteUri) { var result = absoluteUri.MustBeAbsoluteUri(); result.Should().BeSameAs(absoluteUri); } public static readonly TheoryData AbsoluteUriData = new() { new Uri("http://localhost:8080/api/contacts/"), new Uri("https://my.service.com/contacts/new"), new Uri("ftp://172.20.10.5/") }; [Theory(DisplayName = "MustBeAbsoluteUri must throw an ArgumentException when the specified uri is a relative one.")] [MemberData(nameof(RelativeUriData))] public static void RelativeUri(Uri relativeUri) { Action act = () => relativeUri.MustBeAbsoluteUri(nameof(relativeUri)); act.Should().Throw() .And.Message.Should().Contain($"{nameof(relativeUri)} must be an absolute URI, but it actually is \"{relativeUri}\"."); } public static readonly TheoryData RelativeUriData = new() { new Uri("/api/orders", UriKind.Relative), new Uri("/contacts/new", UriKind.Relative) }; [Fact] public static void UriNull() { Action act = () => ((Uri) null).MustBeAbsoluteUri(); act.Should().Throw(); } [Fact] public static void CustomException() => Test.CustomException(new Uri("/api/foo", UriKind.Relative), (uri, exceptionFactory) => uri.MustBeAbsoluteUri(exceptionFactory)); [Fact] public static void CustomExceptionUriAbsolute() { var uri = new Uri("https://www.microsoft.com"); uri.MustBeAbsoluteUri(_ => null).Should().BeSameAs(uri); } [Fact] public static void CustomMessage() => Test.CustomMessage(message => new Uri("/home", UriKind.Relative).MustBeAbsoluteUri(message: message)); [Fact] public static void CustomMessageUriNull() => Test.CustomMessage(message => ((Uri)null).MustBeAbsoluteUri(message: message)); [Fact] public static void CallerArgumentExpression() { var relativeUri = new Uri("/api/hello", UriKind.Relative); var act = () => relativeUri.MustBeAbsoluteUri(); act.Should().Throw() .WithParameterName(nameof(relativeUri)); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/UriAssertions/MustBeRelativeUriTests.cs000066400000000000000000000045211470750352700324000ustar00rootroot00000000000000using System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.UriAssertions; public static class MustBeRelativeUriTests { [Theory] [MemberData(nameof(AbsoluteUris))] public static void UriAbsolute(Uri absoluteUri) { Action act = () => absoluteUri.MustBeRelativeUri(nameof(absoluteUri)); act.Should().Throw() .And.Message.Should().Contain($"{nameof(absoluteUri)} must be a relative URI, but it actually is \"{absoluteUri}\"."); } public static readonly TheoryData AbsoluteUris = new() { new Uri("https://www.microsoft.com"), new Uri("https://xunit.github.io/") }; [Theory] [MemberData(nameof(RelativeUris))] public static void UriRelative(Uri relativeUri) => relativeUri.MustBeRelativeUri().Should().BeSameAs(relativeUri); public static readonly TheoryData RelativeUris = new() { new Uri("api/login", UriKind.Relative), new Uri("/home", UriKind.Relative) }; [Fact] public static void UriNull() { Action act = () => ((Uri) null).MustBeRelativeUri(); act.Should().Throw(); } [Fact] public static void CustomException() => Test.CustomException(new Uri("fttp://server.com"), (uri, exceptionFactory) => uri.MustBeRelativeUri(exceptionFactory)); [Fact] public static void CustomExceptionUriRelative() { var url = new Uri("api/tweets", UriKind.Relative); url.MustBeRelativeUri(_ => null).Should().BeSameAs(url); } [Fact] public static void CustomMessage() => Test.CustomMessage(message => new Uri("ssh://foo.com").MustBeRelativeUri(message: message)); [Fact] public static void CustomMessageUriNull() => Test.CustomMessage(message => ((Uri) null).MustBeRelativeUri(message: message)); [Fact] public static void CallerArgumentExpression() { var absoluteUri = new Uri("https://www.duckduckgo.com", UriKind.Absolute); var act = () => absoluteUri.MustBeRelativeUri(); act.Should().Throw() .WithParameterName(nameof(absoluteUri)); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/UriAssertions/MustHaveOneSchemeOfTests.cs000066400000000000000000000072531470750352700326420ustar00rootroot00000000000000using System; using System.Collections.Generic; using System.Text; using FluentAssertions; using Light.GuardClauses.Exceptions; using Light.GuardClauses.FrameworkExtensions; using Xunit; namespace Light.GuardClauses.Tests.UriAssertions; public static class MustHaveOneSchemeOfTests { [Theory] [InlineData("http://foo.com/", new[] { "ftp", "ftps" })] [InlineData("fttps://bar.com/", new[] { "http", "https" })] public static void SchemeNotPresent(string uri, string[] schemes) { Action act = () => new Uri(uri).MustHaveOneSchemeOf(schemes, nameof(uri)); var exceptionAssertion = act.Should().Throw().Which; exceptionAssertion.Message.Should().Contain(new StringBuilder().AppendLine($"{nameof(uri)} must use one of the following schemes") .AppendItemsWithNewLine(schemes) .AppendLine($"but it actually is \"{uri}\".") .ToString()); exceptionAssertion.ParamName.Should().BeSameAs(nameof(uri)); } [Theory] [InlineData("http://www.feO2x.com", new[] { "http", "https" })] [InlineData("https://www.microsoft.com", new[] { "http", "https" })] public static void SchemePresent(string uri, string[] schemes) { var instance = new Uri(uri); instance.MustHaveOneSchemeOf(schemes).Should().BeSameAs(instance); } [Fact] public static void UriNull() { Action act = () => ((Uri) null).MustHaveOneSchemeOf(Array.Empty()); act.Should().Throw(); } [Fact] public static void UriRelative() { Action act = () => new Uri("/api/foo", UriKind.Relative).MustHaveOneSchemeOf(Array.Empty()); act.Should().Throw(); } [Theory] [MemberData(nameof(CustomExceptionData))] public static void CustomException(Uri url, List urlSchemes) => Test.CustomException(url, urlSchemes, (uri, schemes, exceptionFactory) => uri.MustHaveOneSchemeOf(schemes, exceptionFactory)); public static readonly TheoryData> CustomExceptionData = new () { { new Uri("https://www.microsoft.com"), new List { "http", "ftp" } }, { null, new List { "http", "https" } }, { new Uri("https://github.com"), null } }; [Fact] public static void CustomMessage() => Test.CustomMessage(message => new Uri("https://go.com").MustHaveOneSchemeOf(new[] { "http" }, message: message)); [Fact] public static void CustomMessageUrlRelative() => Test.CustomMessage(message => new Uri("/api", UriKind.Relative).MustHaveOneSchemeOf(new[] { "https" }, message: message)); [Fact] public static void CustomMessageUrlNull() => Test.CustomMessage(message => ((Uri) null).MustHaveOneSchemeOf(new[] { "http" }, message: message)); [Fact] public static void CustomMessageSchemesNull() => Test.CustomMessage(message => new Uri("https://www.dict.cc").MustHaveOneSchemeOf(null!, message: message)); [Fact] public static void CallerArgumentExpression() { var myUrl = new Uri("https://www.synnotech.de", UriKind.Absolute); var act = () => myUrl.MustHaveOneSchemeOf(new[] { "ftp", "ftps" }); act.Should().Throw() .WithParameterName(nameof(myUrl)); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.Tests/UriAssertions/MustHaveSchemeTests.cs000066400000000000000000000075621470750352700317160ustar00rootroot00000000000000using System; using FluentAssertions; using Light.GuardClauses.Exceptions; using Xunit; namespace Light.GuardClauses.Tests.UriAssertions; public static class MustHaveSchemeTests { [Theory(DisplayName = "MustHaveScheme must throw an InvalidUriSchemeException when the URI does not have the specified scheme.")] [MemberData(nameof(InvalidSchemeData))] public static void InvalidScheme(Uri uri, string scheme) { Action act = () => uri.MustHaveScheme(scheme, nameof(uri)); act.Should().Throw() .And.Message.Should().Contain($"{nameof(uri)} must use the scheme \"{scheme}\""); } public static readonly TheoryData InvalidSchemeData = new() { { new Uri("http://localhost:8080"), "https" }, { new Uri("http://my.service.com/upload"), "ftp" } }; [Theory(DisplayName = "MustHaveScheme must not throw an exception when the specified scheme is used by the URI.")] [MemberData(nameof(ValidSchemeData))] public static void ValidScheme(Uri uri, string scheme) { var result = uri.MustHaveScheme(scheme); result.Should().BeSameAs(uri); } public static readonly TheoryData ValidSchemeData = new() { { new Uri("https://www.google.com"), "https" }, { new Uri("ftps://192.168.177.2"), "ftps" } }; [Fact(DisplayName = "MustHaveScheme must throw an ArgumentNullException when the specified URI is null.")] public static void UriNull() { Action act = () => ((Uri) null).MustHaveScheme("foo"); act.Should().Throw(); } [Fact(DisplayName = "MustHaveScheme must throw an RelativeUriException when the specified URI is relative.")] public static void UriRelative() { Action act = () => new Uri("/api/foo", UriKind.Relative).MustHaveScheme("https"); act.Should().Throw(); } [Theory] [MemberData(nameof(CustomExceptionData))] public static void CustomException(Uri uri, string urlScheme) => Test.CustomException(uri, urlScheme, (url, scheme, exceptionFactory) => url.MustHaveScheme(scheme, exceptionFactory)); public static readonly TheoryData CustomExceptionData = new() { { new Uri("https://www.microsoft.com"), "http" }, { null, "ftp" }, { new Uri("https://duckduckgo.com/", UriKind.Absolute), null } }; [Fact] public static void CustomExceptionNoScheme() => Test.CustomException(new Uri("/contact", UriKind.Relative), (url, exceptionFactory) => url.MustHaveScheme("ssl", exceptionFactory)); [Fact] public static void CustomExceptionNoSchemeUriValid() { var url = new Uri("https://www.hbo.com/westworld"); url.MustHaveScheme("https", _ => new Exception()).Should().BeSameAs(url); } [Fact] public static void CustomExceptionSchemeIsValid() { var uri = new Uri("https://github.com/feO2x/Light.GuardClauses"); uri.MustHaveScheme("https", (_, _) => null).Should().BeSameAs(uri); } [Fact] public static void CustomMessage() => Test.CustomMessage(message => new Uri("ftp://foo.com").MustHaveScheme("https", message: message)); [Fact] public static void CustomMessageUriNull() => Test.CustomMessage(message => ((Uri) null).MustHaveScheme("http", message: message)); [Fact] public static void CallerArgumentExpression() { var myUrl = new Uri("https://microsoft.com", UriKind.Absolute); var act = () => myUrl.MustHaveScheme("ftps"); act.Should().Throw() .WithParameterName(nameof(myUrl)); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses.sln000066400000000000000000000101011470750352700222450ustar00rootroot00000000000000Microsoft Visual Studio Solution File, Format Version 12.00 # Visual Studio 15 VisualStudioVersion = 15.0.27130.2010 MinimumVisualStudioVersion = 15.0.26124.0 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Light.GuardClauses", "Light.GuardClauses\Light.GuardClauses.csproj", "{E850D655-B8C8-49B5-8336-D4743504B064}" EndProject Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Light.GuardClauses.Tests", "Light.GuardClauses.Tests\Light.GuardClauses.Tests.csproj", "{E804A19A-589D-49CC-A649-3092013E0133}" EndProject Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Light.GuardClauses.Performance", "Light.GuardClauses.Performance\Light.GuardClauses.Performance.csproj", "{1BBDC2C0-5822-42E4-80FF-9D8CAA62147B}" EndProject Global GlobalSection(SolutionConfigurationPlatforms) = preSolution Debug|Any CPU = Debug|Any CPU Debug|x64 = Debug|x64 Debug|x86 = Debug|x86 Release|Any CPU = Release|Any CPU Release|x64 = Release|x64 Release|x86 = Release|x86 EndGlobalSection GlobalSection(ProjectConfigurationPlatforms) = postSolution {E850D655-B8C8-49B5-8336-D4743504B064}.Debug|Any CPU.ActiveCfg = Debug|Any CPU {E850D655-B8C8-49B5-8336-D4743504B064}.Debug|Any CPU.Build.0 = Debug|Any CPU {E850D655-B8C8-49B5-8336-D4743504B064}.Debug|x64.ActiveCfg = Debug|Any CPU {E850D655-B8C8-49B5-8336-D4743504B064}.Debug|x64.Build.0 = Debug|Any CPU {E850D655-B8C8-49B5-8336-D4743504B064}.Debug|x86.ActiveCfg = Debug|Any CPU {E850D655-B8C8-49B5-8336-D4743504B064}.Debug|x86.Build.0 = Debug|Any CPU {E850D655-B8C8-49B5-8336-D4743504B064}.Release|Any CPU.ActiveCfg = Release|Any CPU {E850D655-B8C8-49B5-8336-D4743504B064}.Release|Any CPU.Build.0 = Release|Any CPU {E850D655-B8C8-49B5-8336-D4743504B064}.Release|x64.ActiveCfg = Release|Any CPU {E850D655-B8C8-49B5-8336-D4743504B064}.Release|x64.Build.0 = Release|Any CPU {E850D655-B8C8-49B5-8336-D4743504B064}.Release|x86.ActiveCfg = Release|Any CPU {E850D655-B8C8-49B5-8336-D4743504B064}.Release|x86.Build.0 = Release|Any CPU {E804A19A-589D-49CC-A649-3092013E0133}.Debug|Any CPU.ActiveCfg = Debug|Any CPU {E804A19A-589D-49CC-A649-3092013E0133}.Debug|Any CPU.Build.0 = Debug|Any CPU {E804A19A-589D-49CC-A649-3092013E0133}.Debug|x64.ActiveCfg = Debug|Any CPU {E804A19A-589D-49CC-A649-3092013E0133}.Debug|x64.Build.0 = Debug|Any CPU {E804A19A-589D-49CC-A649-3092013E0133}.Debug|x86.ActiveCfg = Debug|Any CPU {E804A19A-589D-49CC-A649-3092013E0133}.Debug|x86.Build.0 = Debug|Any CPU {E804A19A-589D-49CC-A649-3092013E0133}.Release|Any CPU.ActiveCfg = Release|Any CPU {E804A19A-589D-49CC-A649-3092013E0133}.Release|Any CPU.Build.0 = Release|Any CPU {E804A19A-589D-49CC-A649-3092013E0133}.Release|x64.ActiveCfg = Release|Any CPU {E804A19A-589D-49CC-A649-3092013E0133}.Release|x64.Build.0 = Release|Any CPU {E804A19A-589D-49CC-A649-3092013E0133}.Release|x86.ActiveCfg = Release|Any CPU {E804A19A-589D-49CC-A649-3092013E0133}.Release|x86.Build.0 = Release|Any CPU {1BBDC2C0-5822-42E4-80FF-9D8CAA62147B}.Debug|Any CPU.ActiveCfg = Debug|Any CPU {1BBDC2C0-5822-42E4-80FF-9D8CAA62147B}.Debug|Any CPU.Build.0 = Debug|Any CPU {1BBDC2C0-5822-42E4-80FF-9D8CAA62147B}.Debug|x64.ActiveCfg = Debug|Any CPU {1BBDC2C0-5822-42E4-80FF-9D8CAA62147B}.Debug|x64.Build.0 = Debug|Any CPU {1BBDC2C0-5822-42E4-80FF-9D8CAA62147B}.Debug|x86.ActiveCfg = Debug|Any CPU {1BBDC2C0-5822-42E4-80FF-9D8CAA62147B}.Debug|x86.Build.0 = Debug|Any CPU {1BBDC2C0-5822-42E4-80FF-9D8CAA62147B}.Release|Any CPU.ActiveCfg = Release|Any CPU {1BBDC2C0-5822-42E4-80FF-9D8CAA62147B}.Release|Any CPU.Build.0 = Release|Any CPU {1BBDC2C0-5822-42E4-80FF-9D8CAA62147B}.Release|x64.ActiveCfg = Release|Any CPU {1BBDC2C0-5822-42E4-80FF-9D8CAA62147B}.Release|x64.Build.0 = Release|Any CPU {1BBDC2C0-5822-42E4-80FF-9D8CAA62147B}.Release|x86.ActiveCfg = Release|Any CPU {1BBDC2C0-5822-42E4-80FF-9D8CAA62147B}.Release|x86.Build.0 = Release|Any CPU EndGlobalSection GlobalSection(SolutionProperties) = preSolution HideSolutionNode = FALSE EndGlobalSection GlobalSection(ExtensibilityGlobals) = postSolution SolutionGuid = {1566605B-18A9-423B-BB52-1406254EDE47} EndGlobalSection EndGlobal Light.GuardClauses-12.0.0/Code/Light.GuardClauses.sln.DotSettings000066400000000000000000000606251470750352700245330ustar00rootroot00000000000000 True None False HINT HINT HINT WARNING <?xml version="1.0" encoding="utf-16"?><Profile name="Kenny's Kleanup"><CSReorderTypeMembers>True</CSReorderTypeMembers><CSUpdateFileHeader>True</CSUpdateFileHeader><CSEnforceVarKeywordUsageSettings>True</CSEnforceVarKeywordUsageSettings><CSMakeFieldReadonly>True</CSMakeFieldReadonly><CSArrangeQualifiers>True</CSArrangeQualifiers><CSOptimizeUsings><OptimizeUsings>True</OptimizeUsings><EmbraceInRegion>False</EmbraceInRegion><RegionName></RegionName></CSOptimizeUsings><CSShortenReferences>True</CSShortenReferences><CSReformatCode>True</CSReformatCode><CSharpFormatDocComments>True</CSharpFormatDocComments><CppReformatCode>True</CppReformatCode><XMLReformatCode>True</XMLReformatCode><CssReformatCode>True</CssReformatCode><CSCodeStyleAttributes ArrangeTypeAccessModifier="True" ArrangeTypeMemberAccessModifier="True" SortModifiers="True" RemoveRedundantParentheses="False" AddMissingParentheses="False" ArrangeBraces="False" ArrangeAttributes="False" ArrangeArgumentsStyle="False" ArrangeCodeBodyStyle="False" ArrangeVarStyle="False" /><CSMakeAutoPropertyGetOnly>True</CSMakeAutoPropertyGetOnly><RemoveCodeRedundancies>True</RemoveCodeRedundancies><HtmlReformatCode>True</HtmlReformatCode><JsInsertSemicolon>True</JsInsertSemicolon><CorrectVariableKindsDescriptor>True</CorrectVariableKindsDescriptor><JsReformatCode>True</JsReformatCode><JsFormatDocComments>True</JsFormatDocComments><FormatAttributeQuoteDescriptor>True</FormatAttributeQuoteDescriptor></Profile> C# Cleanup Kenny's Kleanup True True True True True True True True True True TOGETHER_SAME_LINE True True True True True True NEVER NEVER NEVER NEVER DO_NOT_CHANGE True 500 False RemoveIndent RemoveIndent False False False False <?xml version="1.0" encoding="utf-16"?> <Patterns xmlns="urn:schemas-jetbrains-com:member-reordering-patterns"> <TypePattern DisplayName="COM interfaces or structs"> <TypePattern.Match> <Or> <And> <Kind Is="Interface" /> <Or> <HasAttribute Name="System.Runtime.InteropServices.InterfaceTypeAttribute" /> <HasAttribute Name="System.Runtime.InteropServices.ComImport" /> </Or> </And> <Kind Is="Struct" /> </Or> </TypePattern.Match> </TypePattern> <TypePattern DisplayName="xUnit Test Class"> <TypePattern.Match> <And> <Kind Is="Class" /> <HasMember> <Or> <HasAttribute Name="Xunit.FactAttribute" /> <HasAttribute Name="Xunit.TheoryAttribute" /> </Or> </HasMember> </And> </TypePattern.Match> </TypePattern> <TypePattern DisplayName="NUnit Test Fixtures" RemoveRegions="All"> <TypePattern.Match> <And> <Kind Is="Class" /> <HasAttribute Name="NUnit.Framework.TestFixtureAttribute" Inherited="True" /> </And> </TypePattern.Match> <Entry DisplayName="Setup/Teardown Methods"> <Entry.Match> <And> <Kind Is="Method" /> <Or> <HasAttribute Name="NUnit.Framework.SetUpAttribute" Inherited="True" /> <HasAttribute Name="NUnit.Framework.TearDownAttribute" Inherited="True" /> <HasAttribute Name="NUnit.Framework.FixtureSetUpAttribute" Inherited="True" /> <HasAttribute Name="NUnit.Framework.FixtureTearDownAttribute" Inherited="True" /> </Or> </And> </Entry.Match> </Entry> <Entry DisplayName="All other members" /> <Entry Priority="100" DisplayName="Test Methods"> <Entry.Match> <And> <Kind Is="Method" /> <HasAttribute Name="NUnit.Framework.TestAttribute" /> </And> </Entry.Match> <Entry.SortBy> <Name /> </Entry.SortBy> </Entry> </TypePattern> <TypePattern DisplayName="Default Pattern"> <Entry Priority="100" DisplayName="Public Delegates"> <Entry.Match> <And> <Access Is="Public" /> <Kind Is="Delegate" /> </And> </Entry.Match> <Entry.SortBy> <Name /> </Entry.SortBy> </Entry> <Entry Priority="100" DisplayName="Public Enums"> <Entry.Match> <And> <Access Is="Public" /> <Kind Is="Enum" /> </And> </Entry.Match> <Entry.SortBy> <Name /> </Entry.SortBy> </Entry> <Entry DisplayName="Static Fields and Constants"> <Entry.Match> <Or> <Kind Is="Constant" /> <And> <Kind Is="Field" /> <Static /> </And> </Or> </Entry.Match> <Entry.SortBy> <Kind Order="Constant Field" /> </Entry.SortBy> </Entry> <Entry DisplayName="Fields"> <Entry.Match> <And> <Kind Is="Field" /> <Not> <Static /> </Not> </And> </Entry.Match> <Entry.SortBy> <Readonly /> <Name /> </Entry.SortBy> </Entry> <Entry DisplayName="Constructors"> <Entry.Match> <Kind Is="Constructor" /> </Entry.Match> <Entry.SortBy> <Static /> </Entry.SortBy> </Entry> <Entry DisplayName="Properties, Indexers"> <Entry.Match> <Or> <Kind Is="Property" /> <Kind Is="Indexer" /> </Or> </Entry.Match> </Entry> <Entry Priority="100" DisplayName="Interface Implementations"> <Entry.Match> <And> <Kind Is="Member" /> <ImplementsInterface /> </And> </Entry.Match> <Entry.SortBy> <ImplementsInterface Immediate="True" /> </Entry.SortBy> </Entry> <Entry DisplayName="All other members" /> <Entry DisplayName="Nested Types"> <Entry.Match> <Kind Is="Type" /> </Entry.Match> </Entry> </TypePattern> </Patterns> False False True Replace Replace False True False False True False <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /> <Policy Inspect="True" Prefix="I" Suffix="" Style="AaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="T" Suffix="" Style="AaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /> <Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /> True D:\Programming\Light.GuardClauses\Code\Light.GuardClauses.sln.DotSettings True 1 True True True True True True True True True True True TrueLight.GuardClauses-12.0.0/Code/Light.GuardClauses/000077500000000000000000000000001470750352700215365ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses/CallerArgumentExpressionAttribute.cs000066400000000000000000000007471470750352700307460ustar00rootroot00000000000000#if !NET8_0 // ReSharper disable once CheckNamespace -- CallerArgumentExpression must be in exactly this namespace namespace System.Runtime.CompilerServices; [AttributeUsage(AttributeTargets.Parameter, AllowMultiple = false, Inherited = false)] internal sealed class CallerArgumentExpressionAttribute : Attribute { public CallerArgumentExpressionAttribute(string parameterName) { ParameterName = parameterName; } public string ParameterName { get; } } #endifLight.GuardClauses-12.0.0/Code/Light.GuardClauses/Check.CommonAssertions.cs000066400000000000000000001251231470750352700264100ustar00rootroot00000000000000using System; using System.Collections.Generic; using System.Runtime.CompilerServices; using JetBrains.Annotations; using Light.GuardClauses.Exceptions; using NotNullAttribute = System.Diagnostics.CodeAnalysis.NotNullAttribute; namespace Light.GuardClauses; /// /// The class provides access to all assertions of Light.GuardClauses. /// public static partial class Check { /// /// Ensures that the specified object reference is not null, or otherwise throws an . /// /// The object reference to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static T MustNotBeNull([NotNull, ValidatedNotNull, NoEnumeration] this T? parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : class { if (parameter is null) Throw.ArgumentNull(parameterName, message); return parameter; } /// /// Ensures that the specified object reference is not null, or otherwise throws your custom exception. /// /// The reference to be checked. /// The delegate that creates your custom exception. /// Your custom exception thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; exceptionFactory:null => halt")] public static T MustNotBeNull([NotNull, ValidatedNotNull, NoEnumeration] this T? parameter, Func exceptionFactory) where T : class { if (parameter is null) Throw.CustomException(exceptionFactory); return parameter; } /// /// Ensures that the specified parameter is not the default value, or otherwise throws an /// for reference types, or an for value types. /// /// The value to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is a reference type and null. /// Thrown when is a value type and the default value. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static T MustNotBeDefault([NotNull, ValidatedNotNull] this T parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (default(T) is null) { if (parameter is null) Throw.ArgumentNull(parameterName, message); return parameter; } if (EqualityComparer.Default.Equals(parameter, default!)) Throw.ArgumentDefault(parameterName, message); // If we end up here, we have a value type which cannot be null #pragma warning disable CS8777 // Parameter must have a non-null value when exiting. return parameter; #pragma warning restore CS8777 } /// /// Ensures that the specified parameter is not the default value, or otherwise throws your custom exception. /// /// The value to be checked. /// The delegate that creates your custom exception. /// Your custom exception thrown when is the default value. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; exceptionFactory:null => halt")] public static T MustNotBeDefault([NotNull, ValidatedNotNull] this T parameter, Func exceptionFactory) { if (default(T) is null) { if (parameter is null) Throw.CustomException(exceptionFactory); return parameter; } if (EqualityComparer.Default.Equals(parameter, default!)) Throw.CustomException(exceptionFactory); // If we end up here, we have a value type which cannot be null #pragma warning disable CS8777 // Parameter must have a non-null value when exiting. return parameter; #pragma warning restore CS8777 } /// /// Ensures that the specified parameter is not null when is a reference type, or otherwise /// throws an . PLEASE NOTICE: you should only use this assertion in generic contexts, /// use by default. /// /// The value to be checked for null. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is a reference type and is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static T MustNotBeNullReference([NotNull, ValidatedNotNull, NoEnumeration] this T parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (default(T) != null) { // If we end up here, parameter cannot be null #pragma warning disable CS8777 // Parameter must have a non-null value when exiting. return parameter; #pragma warning restore CS8777 // Parameter must have a non-null value when exiting. } if (parameter is null) Throw.ArgumentNull(parameterName, message); return parameter; } /// /// Ensures that the specified parameter is not null when is a reference type, or otherwise /// throws your custom exception. PLEASE NOTICE: you should only use this assertion in generic contexts, /// use by default. /// /// The value to be checked for null. /// The delegate that creates your custom exception. /// Your custom exception thrown when is a reference type and is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; exceptionFactory:null => halt")] public static T MustNotBeNullReference([NotNull, ValidatedNotNull, NoEnumeration] this T parameter, Func exceptionFactory) { if (default(T) != null) { // If we end up here, parameter cannot be null #pragma warning disable CS8777 // Parameter must have a non-null value when exiting. return parameter; #pragma warning restore CS8777 // Parameter must have a non-null value when exiting. } if (parameter is null) Throw.CustomException(exceptionFactory); return parameter; } /// /// Ensures that can be cast to and returns the cast value, or otherwise throws a . /// /// The value to be cast. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when cannot be cast to . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static T MustBeOfType([NotNull, ValidatedNotNull, NoEnumeration] this object? parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.MustNotBeNull(parameterName, message) is T castValue) return castValue; Throw.InvalidTypeCast(parameter, typeof(T), parameterName, message); return default; } /// /// Ensures that can be cast to and returns the cast value, or otherwise throws your custom exception. /// /// The value to be cast. /// The delegate that creates your custom exception. The is passed to this delegate. /// Your custom exception thrown when cannot be cast to . [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; exceptionFactory:null => halt")] public static T MustBeOfType([NotNull, ValidatedNotNull, NoEnumeration] this object? parameter, Func exceptionFactory) { if (parameter is T castValue) return castValue; Throw.CustomException(exceptionFactory, parameter); return default; } /// /// Checks if the specified value is a valid enum value of its type. This is true when the specified value /// is one of the constants defined in the enum, or a valid flags combination when the enum type is marked /// with the . /// /// The type of the enum. /// The enum value to be checked. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsValidEnumValue(this T parameter) where T : struct, Enum => EnumInfo.IsValidEnumValue(parameter); /// /// Ensures that the specified enum value is valid, or otherwise throws an . An enum value /// is valid when the specified value is one of the constants defined in the enum, or a valid flags combination when the enum type /// is marked with the . /// /// The type of the enum. /// The value to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is no valid enum value. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T MustBeValidEnumValue(this T parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : struct, Enum { if (!EnumInfo.IsValidEnumValue(parameter)) Throw.EnumValueNotDefined(parameter, parameterName, message); return parameter; } /// /// Ensures that the specified enum value is valid, or otherwise throws your custom exception. An enum value /// is valid when the specified value is one of the constants defined in the enum, or a valid flags combination when the enum type /// is marked with the . /// /// The type of the enum. /// The value to be checked. /// The delegate that creates your custom exception. The is passed to this delegate. /// Your custom exception thrown when is no valid enum value, or when is no enum type. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("exceptionFactory:null => halt")] public static T MustBeValidEnumValue(this T parameter, Func exceptionFactory) where T : struct, Enum { if (!EnumInfo.IsValidEnumValue(parameter)) Throw.CustomException(exceptionFactory, parameter); return parameter; } /// /// Checks if the specified GUID is an empty one. /// /// The GUID to be checked. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsEmpty(this Guid parameter) => parameter == Guid.Empty; /// /// Ensures that the specified GUID is not empty, or otherwise throws an . /// /// The GUID to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is an empty GUID. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Guid MustNotBeEmpty(this Guid parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter == Guid.Empty) Throw.EmptyGuid(parameterName, message); return parameter; } /// /// Ensures that the specified GUID is not empty, or otherwise throws your custom exception. /// /// The GUID to be checked. /// The delegate that creates your custom exception. /// Your custom exception thrown when is an empty GUID. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("exceptionFactory:null => halt")] public static Guid MustNotBeEmpty(this Guid parameter, Func exceptionFactory) { if (parameter == Guid.Empty) Throw.CustomException(exceptionFactory); return parameter; } /// /// Checks if the specified is true and throws an in this case. /// /// The condition to be checked. The exception is thrown when it is true. /// The message that will be passed to the (optional). /// Thrown when is true. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static void InvalidOperation(bool condition, string? message = null) { if (condition) Throw.InvalidOperation(message); } /// /// Checks if the specified is true and throws an in this case. /// /// The condition to be checked. The exception is thrown when it is true. /// The message that will be passed to the . /// Thrown when is true. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static void InvalidState(bool condition, string? message = null) { if (condition) Throw.InvalidState(message); } /// /// Checks if the specified is true and throws an in this case. /// /// The condition to be checked. The exception is thrown when it is true. /// The name of the parameter (optional). /// The message that will be passed to the (optional). /// Thrown when is true. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static void InvalidArgument(bool condition, string? parameterName = null, string? message = null) { if (condition) Throw.Argument(parameterName, message); } /// /// Checks if the specified is true and throws your custom exception in this case. /// /// The condition to be checked. The exception is thrown when it is true. /// The delegate that creates your custom exception. /// Your custom exception thrown when is true. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("exceptionFactory:null => halt")] public static void InvalidArgument(bool condition, Func exceptionFactory) { if (condition) Throw.CustomException(exceptionFactory); } /// /// Checks if the specified is true and throws your custom exception in this case. /// /// The condition to be checked. The exception is thrown when it is true. /// The value that is checked in the . This value is passed to the . /// The delegate that creates your custom exception. The is passed to this delegate. /// Your custom exception thrown when is true. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("exceptionFactory:null => halt")] public static void InvalidArgument(bool condition, T parameter, Func exceptionFactory) { if (condition) Throw.CustomException(exceptionFactory, parameter); } /// /// Ensures that the specified nullable has a value and returns it, or otherwise throws a . /// /// The nullable to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when has no value. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T MustHaveValue([NotNull, NoEnumeration] this T? parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : struct { if (!parameter.HasValue) Throw.NullableHasNoValue(parameterName, message); return parameter.Value; } /// /// Ensures that the specified nullable has a value and returns it, or otherwise throws your custom exception. /// /// The nullable to be checked. /// The delegate that creates your custom exception. /// Thrown when has no value. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("exceptionFactory:null => halt")] public static T MustHaveValue([NotNull, NoEnumeration] this T? parameter, Func exceptionFactory) where T : struct { if (!parameter.HasValue) Throw.CustomException(exceptionFactory); return parameter.Value; } /// /// Checks if and point to the same object. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] // ReSharper disable StringLiteralTypo [ContractAnnotation("parameter:notNull => true, other:notnull; parameter:notNull => false, other:canbenull; other:notnull => true, parameter:notnull; other:notnull => false, parameter:canbenull")] // ReSharper restore StringLiteralTypo public static bool IsSameAs([NoEnumeration] this T? parameter, [NoEnumeration] T? other) where T : class => ReferenceEquals(parameter, other); /// /// Ensures that and do not point to the same object instance, or otherwise /// throws a . /// /// The first reference to be checked. /// The second reference to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when both and point to the same object. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T? MustNotBeSameAs([NoEnumeration] this T? parameter, [NoEnumeration] T? other, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : class { if (ReferenceEquals(parameter, other)) Throw.SameObjectReference(parameter, parameterName, message); return parameter; } /// /// Ensures that and do not point to the same object instance, or otherwise /// throws your custom exception. /// /// The first reference to be checked. /// The second reference to be checked. /// The delegate that creates your custom exception. is passed to this delegate. /// Thrown when both and point to the same object. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T? MustNotBeSameAs([NoEnumeration] this T? parameter, T? other, Func exceptionFactory) where T : class { if (ReferenceEquals(parameter, other)) Throw.CustomException(exceptionFactory, parameter); return parameter; } /// /// Ensures that is equal to using the default equality comparer, or otherwise throws a . /// /// The first value to be compared. /// The other value to be compared. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when and are not equal. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T MustBe(this T parameter, T other, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (!EqualityComparer.Default.Equals(parameter, other)) Throw.ValuesNotEqual(parameter, other, parameterName, message); return parameter; } /// /// Ensures that is equal to using the default equality comparer, or otherwise throws your custom exception. /// /// The first value to be compared. /// The other value to be compared. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when and are not equal. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T MustBe(this T parameter, T other, Func exceptionFactory) { if (!EqualityComparer.Default.Equals(parameter, other)) Throw.CustomException(exceptionFactory, parameter, other); return parameter; } /// /// Ensures that is equal to using the specified equality comparer, or otherwise throws a . /// /// The first value to be compared. /// The other value to be compared. /// The equality comparer used for comparing the two values. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when and are not equal. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("equalityComparer:null => halt")] public static T MustBe(this T parameter, T other, IEqualityComparer equalityComparer, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (!equalityComparer.MustNotBeNull(nameof(equalityComparer), message).Equals(parameter, other)) Throw.ValuesNotEqual(parameter, other, parameterName, message); return parameter; } /// /// Ensures that is equal to using the specified equality comparer, or otherwise throws your custom exception. /// /// The first value to be compared. /// The other value to be compared. /// The equality comparer used for comparing the two values. /// The delegate that creates your custom exception. , , and are passed to this delegate. /// Your custom exception thrown when and are not equal, or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("equalityComparer:null => halt")] public static T MustBe(this T parameter, T other, IEqualityComparer equalityComparer, Func, Exception> exceptionFactory) { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (equalityComparer is null || !equalityComparer.Equals(parameter, other)) Throw.CustomException(exceptionFactory, parameter, other, equalityComparer!); return parameter; } /// /// Ensures that is not equal to using the default equality comparer, or otherwise throws a . /// /// The first value to be compared. /// The other value to be compared. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when and are equal. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T MustNotBe(this T parameter, T other, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (EqualityComparer.Default.Equals(parameter, other)) Throw.ValuesEqual(parameter, other, parameterName, message); return parameter; } /// /// Ensures that is not equal to using the default equality comparer, or otherwise throws your custom exception. /// /// The first value to be compared. /// The other value to be compared. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when and are equal. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T MustNotBe(this T parameter, T other, Func exceptionFactory) { if (EqualityComparer.Default.Equals(parameter, other)) Throw.CustomException(exceptionFactory, parameter, other); return parameter; } /// /// Ensures that is not equal to using the specified equality comparer, or otherwise throws a . /// /// The first value to be compared. /// The other value to be compared. /// The equality comparer used for comparing the two values. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when and are equal. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("equalityComparer:null => halt")] public static T MustNotBe(this T parameter, T other, IEqualityComparer equalityComparer, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (equalityComparer.MustNotBeNull(nameof(equalityComparer), message).Equals(parameter, other)) Throw.ValuesEqual(parameter, other, parameterName, message); return parameter; } /// /// Ensures that is not equal to using the specified equality comparer, or otherwise throws your custom exception. /// /// The first value to be compared. /// The other value to be compared. /// The equality comparer used for comparing the two values. /// The delegate that creates your custom exception. , , and are passed to this delegate. /// Your custom exception thrown when and are equal, or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("equalityComparer:null => halt")] public static T MustNotBe(this T parameter, T other, IEqualityComparer equalityComparer, Func, Exception> exceptionFactory) { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (equalityComparer is null || equalityComparer.Equals(parameter, other)) Throw.CustomException(exceptionFactory, parameter, other, equalityComparer!); return parameter; } /// /// Checks if the specified value is approximately the same as the other value, using the given tolerance. /// /// The first value to be compared. /// The second value to be compared. /// The tolerance indicating how much the two values may differ from each other. /// /// True if and are equal or if their absolute difference /// is smaller than the given , otherwise false. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsApproximately(this double value, double other, double tolerance) => Math.Abs(value - other) < tolerance; /// /// Checks if the specified value is approximately the same as the other value, using the default tolerance of 0.0001. /// /// The first value to be compared. /// The second value to be compared. /// /// True if and are equal or if their absolute difference /// is smaller than 0.0001, otherwise false. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsApproximately(this double value, double other) => Math.Abs(value - other) < 0.0001; /// /// Checks if the specified value is approximately the same as the other value, using the given tolerance. /// /// The first value to compare. /// The second value to compare. /// The tolerance indicating how much the two values may differ from each other. /// /// True if and are equal or if their absolute difference /// is smaller than the given , otherwise false. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsApproximately(this float value, float other, float tolerance) => Math.Abs(value - other) < tolerance; /// /// Checks if the specified value is approximately the same as the other value, using the default tolerance of 0.0001f. /// /// The first value to be compared. /// The second value to be compared. /// /// True if and are equal or if their absolute difference /// is smaller than 0.0001f, otherwise false. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsApproximately(this float value, float other) => Math.Abs(value - other) < 0.0001f; /// /// Checks if the specified value is greater than or approximately the same as the other value, using the given tolerance. /// /// The first value to compare. /// The second value to compare. /// The tolerance indicating how much the two values may differ from each other. /// /// True if is greater than or if their absolute difference /// is smaller than the given , otherwise false. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsGreaterThanOrApproximately(this double value, double other, double tolerance) => value > other || value.IsApproximately(other, tolerance); /// /// Checks if the specified value is greater than or approximately the same as the other value, using the default tolerance of 0.0001. /// /// The first value to compare. /// The second value to compare. /// /// True if is greater than or if their absolute difference /// is smaller than 0.0001, otherwise false. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsGreaterThanOrApproximately(this double value, double other) => value > other || value.IsApproximately(other); /// /// Checks if the specified value is greater than or approximately the same as the other value, using the given tolerance. /// /// The first value to compare. /// The second value to compare. /// The tolerance indicating how much the two values may differ from each other. /// /// True if is greater than or if their absolute difference /// is smaller than the given , otherwise false. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsGreaterThanOrApproximately(this float value, float other, float tolerance) => value > other || value.IsApproximately(other, tolerance); /// /// Checks if the specified value is greater than or approximately the same as the other value, using the default tolerance of 0.0001f. /// /// The first value to compare. /// The second value to compare. /// /// True if is greater than or if their absolute difference /// is smaller than 0.0001, otherwise false. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsGreaterThanOrApproximately(this float value, float other) => value > other || value.IsApproximately(other); /// /// Checks if the specified value is less than or approximately the same as the other value, using the given tolerance. /// /// The first value to compare. /// The second value to compare. /// The tolerance indicating how much the two values may differ from each other. /// /// True if is less than or if their absolute difference /// is smaller than the given , otherwise false. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsLessThanOrApproximately(this double value, double other, double tolerance) => value < other || value.IsApproximately(other, tolerance); /// /// Checks if the specified value is less than or approximately the same as the other value, using the default tolerance of 0.0001. /// /// The first value to compare. /// The second value to compare. /// /// True if is less than or if their absolute difference /// is smaller than 0.0001, otherwise false. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsLessThanOrApproximately(this double value, double other) => value < other || value.IsApproximately(other); /// /// Checks if the specified value is less than or approximately the same as the other value, using the given tolerance. /// /// The first value to compare. /// The second value to compare. /// The tolerance indicating how much the two values may differ from each other. /// /// True if is less than or if their absolute difference /// is smaller than the given , otherwise false. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsLessThanOrApproximately(this float value, float other, float tolerance) => value < other || value.IsApproximately(other, tolerance); /// /// Checks if the specified value is less than or approximately the same as the other value, using the default tolerance of 0.0001f. /// /// The first value to compare. /// The second value to compare. /// /// True if is less than or if their absolute difference /// is smaller than 0.0001f, otherwise false. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsLessThanOrApproximately(this float value, float other) => value < other || value.IsApproximately(other); }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Check.ComparableAssertions.cs000066400000000000000000000746201470750352700272320ustar00rootroot00000000000000using System; using JetBrains.Annotations; using System.Runtime.CompilerServices; using Light.GuardClauses.Exceptions; using NotNullAttribute = System.Diagnostics.CodeAnalysis.NotNullAttribute; namespace Light.GuardClauses; public static partial class Check { /* * ------------------------------------- * Must Not Be Less Than * Must Be Greater Than or Equal To * ------------------------------------- */ /// /// Ensures that the specified is not less than the given value, or otherwise throws an . /// /// The comparable to be checked. /// The boundary value that must be less than or equal to . /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when the specified is less than . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static T MustNotBeLessThan([NotNull, ValidatedNotNull] this T parameter, T other, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable { if (parameter.MustNotBeNullReference(parameterName, message).CompareTo(other) < 0) Throw.MustNotBeLessThan(parameter, other, parameterName, message); return parameter; } /// /// Ensures that the specified is not less than the given value, or otherwise throws your custom exception. /// /// The comparable to be checked. /// The boundary value that must be less than or equal to . /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when the specified is less than , or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; exceptionFactory:null => halt")] public static T MustNotBeLessThan([NotNull, ValidatedNotNull] this T parameter, T other, Func exceptionFactory) where T : IComparable { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract -- caller might have NRTs off if (parameter is null || parameter.CompareTo(other) < 0) Throw.CustomException(exceptionFactory, parameter!, other); return parameter; } /// /// Ensures that the specified is not less than the given value, or otherwise throws an . /// /// The comparable to be checked. /// The boundary value that must be less than or equal to . /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when the specified is less than . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static T MustBeGreaterThanOrEqualTo([NotNull, ValidatedNotNull] this T parameter, T other, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable { if (parameter.MustNotBeNullReference(parameterName, message).CompareTo(other) < 0) Throw.MustBeGreaterThanOrEqualTo(parameter, other, parameterName, message); return parameter; } /// /// Ensures that the specified is not less than the given value, or otherwise throws your custom exception. /// /// The comparable to be checked. /// The boundary value that must be less than or equal to . /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when the specified is less than , or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; exceptionFactory:null => halt")] public static T MustBeGreaterThanOrEqualTo([NotNull, ValidatedNotNull] this T parameter, T other, Func exceptionFactory) where T : IComparable { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (parameter is null || parameter.CompareTo(other) < 0) Throw.CustomException(exceptionFactory, parameter!, other); return parameter; } /* * ------------------------------------- * Must Be Less Than * Must Not Be Greater Than or Equal To * ------------------------------------- */ /// /// Ensures that the specified is less than the given value, or otherwise throws an . /// /// The comparable to be checked. /// The boundary value that must be greater than . /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when the specified is not less than . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static T MustBeLessThan([NotNull, ValidatedNotNull] this T parameter, T other, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable { if (parameter.MustNotBeNullReference(parameterName, message).CompareTo(other) >= 0) Throw.MustBeLessThan(parameter, other, parameterName, message); return parameter; } /// /// Ensures that the specified is less than the given value, or otherwise throws your custom exception. /// /// The comparable to be checked. /// The boundary value that must be greater than . /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when the specified is not less than , or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; exceptionFactory:null => halt")] public static T MustBeLessThan([NotNull, ValidatedNotNull] this T parameter, T other, Func exceptionFactory) where T : IComparable { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (parameter is null || parameter.CompareTo(other) >= 0) Throw.CustomException(exceptionFactory, parameter!, other); return parameter; } /// /// Ensures that the specified is less than the given value, or otherwise throws an . /// /// The comparable to be checked. /// The boundary value that must be greater than . /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when the specified is not less than . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static T MustNotBeGreaterThanOrEqualTo([NotNull, ValidatedNotNull] this T parameter, T other, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable { if (parameter.MustNotBeNullReference(parameterName, message).CompareTo(other) >= 0) Throw.MustNotBeGreaterThanOrEqualTo(parameter, other, parameterName, message); return parameter; } /// /// Ensures that the specified is less than the given value, or otherwise throws your custom exception. /// /// The comparable to be checked. /// The boundary value that must be greater than . /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when the specified is not less than , or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; exceptionFactory:null => halt")] public static T MustNotBeGreaterThanOrEqualTo([NotNull, ValidatedNotNull] this T parameter, T other, Func exceptionFactory) where T : IComparable { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (parameter is null || parameter.CompareTo(other) >= 0) Throw.CustomException(exceptionFactory, parameter!, other); return parameter; } /* * ------------------------------------- * Must Be Greater Than * Must Not Be Less Than or Equal To * ------------------------------------- */ /// /// Ensures that the specified is greater than the given value, or otherwise throws an . /// /// The comparable to be checked. /// The boundary value that must be less than . /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when the specified is less than or equal to . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static T MustBeGreaterThan([NotNull, ValidatedNotNull] this T parameter, T other, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable { if (parameter.MustNotBeNullReference(parameterName, message).CompareTo(other) <= 0) Throw.MustBeGreaterThan(parameter, other, parameterName, message); return parameter; } /// /// Ensures that the specified is greater than the given value, or otherwise throws your custom exception. /// /// The comparable to be checked. /// The boundary value that must be less than . /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when the specified is less than or equal to , or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; exceptionFactory:null => halt")] public static T MustBeGreaterThan([NotNull, ValidatedNotNull] this T parameter, T other, Func exceptionFactory) where T : IComparable { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (parameter is null || parameter.CompareTo(other) <= 0) Throw.CustomException(exceptionFactory, parameter!, other); return parameter; } /// /// Ensures that the specified is greater than the given value, or otherwise throws an . /// /// The comparable to be checked. /// The boundary value that must be less than . /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when the specified is less than or equal to . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static T MustNotBeLessThanOrEqualTo([NotNull, ValidatedNotNull] this T parameter, T other, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable { if (parameter.MustNotBeNullReference(parameterName, message).CompareTo(other) <= 0) Throw.MustNotBeLessThanOrEqualTo(parameter, other, parameterName, message); return parameter; } /// /// Ensures that the specified is greater than the given value, or otherwise throws your custom exception. /// /// The comparable to be checked. /// The boundary value that must be less than . /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when the specified is less than or equal to , or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; exceptionFactory:null => halt")] public static T MustNotBeLessThanOrEqualTo([NotNull, ValidatedNotNull] this T parameter, T other, Func exceptionFactory) where T : IComparable { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (parameter is null || parameter.CompareTo(other) <= 0) Throw.CustomException(exceptionFactory, parameter!, other); return parameter; } /* * ------------------------------------- * Must Not Be Greater Than * Must Be Less Than or Equal To * ------------------------------------- */ /// /// Ensures that the specified is not greater than the given value, or otherwise throws an . /// /// The comparable to be checked. /// The boundary value that must be greater than or equal to . /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when the specified is greater than . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static T MustNotBeGreaterThan([NotNull, ValidatedNotNull] this T parameter, T other, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable { if (parameter.MustNotBeNullReference(parameterName, message).CompareTo(other) > 0) Throw.MustNotBeGreaterThan(parameter, other, parameterName, message); return parameter; } /// /// Ensures that the specified is not greater than the given value, or otherwise throws your custom exception. /// /// The comparable to be checked. /// The boundary value that must be greater than or equal to . /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when the specified is greater than , or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; exceptionFactory:null => halt")] public static T MustNotBeGreaterThan([NotNull, ValidatedNotNull] this T parameter, T other, Func exceptionFactory) where T : IComparable { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (parameter is null || parameter.CompareTo(other) > 0) Throw.CustomException(exceptionFactory, parameter!, other); return parameter; } /// /// Ensures that the specified is not greater than the given value, or otherwise throws an . /// /// The comparable to be checked. /// The boundary value that must be greater than or equal to . /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when the specified is greater than . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static T MustBeLessThanOrEqualTo([NotNull, ValidatedNotNull] this T parameter, T other, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable { if (parameter.MustNotBeNullReference(parameterName, message).CompareTo(other) > 0) Throw.MustBeLessThanOrEqualTo(parameter, other, parameterName, message); return parameter; } /// /// Ensures that the specified is not greater than the given value, or otherwise throws your custom exception. /// /// The comparable to be checked. /// The boundary value that must be greater than or equal to . /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when the specified is greater than , or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; exceptionFactory:null => halt")] public static T MustBeLessThanOrEqualTo([NotNull, ValidatedNotNull] this T parameter, T other, Func exceptionFactory) where T : IComparable { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (parameter is null || parameter.CompareTo(other) > 0) Throw.CustomException(exceptionFactory, parameter!, other); return parameter; } /* * ------------------------------------- * Ranges * ------------------------------------- */ /// /// Checks if the value is within the specified range. /// /// The comparable to be checked. /// The range where must be in-between. /// True if the parameter is within the specified range, else false. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsIn([NotNull, ValidatedNotNull] this T parameter, Range range) where T : IComparable => range.IsValueWithinRange(parameter); /// /// Checks if the value is not within the specified range. /// /// The comparable to be checked. /// The range where must not be in-between. /// True if the parameter is not within the specified range, else false. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsNotIn([NotNull, ValidatedNotNull] this T parameter, Range range) where T : IComparable => !range.IsValueWithinRange(parameter); /// /// Ensures that is within the specified range, or otherwise throws an . /// /// The type of the parameter to be checked. /// The parameter to be checked. /// The range where must be in-between. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is not within . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static T MustBeIn([NotNull, ValidatedNotNull] this T parameter, Range range, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable { if (!range.IsValueWithinRange(parameter.MustNotBeNullReference(parameterName, message))) Throw.MustBeInRange(parameter, range, parameterName, message); return parameter; } /// /// Ensures that is within the specified range, or otherwise throws your custom exception. /// /// The parameter to be checked. /// The range where must be in-between. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when is not within , or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; exceptionFactory:null => halt")] public static T MustBeIn([NotNull, ValidatedNotNull] this T parameter, Range range, Func, Exception> exceptionFactory) where T : IComparable { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (parameter is null || !range.IsValueWithinRange(parameter)) Throw.CustomException(exceptionFactory, parameter!, range); return parameter; } /// /// Ensures that is not within the specified range, or otherwise throws an . /// /// The type of the parameter to be checked. /// The parameter to be checked. /// The range where must not be in-between. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is within . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static T MustNotBeIn([NotNull, ValidatedNotNull] this T parameter, Range range, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable { if (range.IsValueWithinRange(parameter.MustNotBeNullReference(parameterName, message))) Throw.MustNotBeInRange(parameter, range, parameterName, message); return parameter; } /// /// Ensures that is not within the specified range, or otherwise throws your custom exception. /// /// The parameter to be checked. /// The range where must not be in-between. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when is within , or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; exceptionFactory:null => halt")] public static T MustNotBeIn([NotNull, ValidatedNotNull] this T parameter, Range range, Func, Exception> exceptionFactory) where T : IComparable { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (parameter is null || range.IsValueWithinRange(parameter)) Throw.CustomException(exceptionFactory, parameter!, range); return parameter; } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Check.DateTimeAssertions.cs000066400000000000000000000135671470750352700266640ustar00rootroot00000000000000using System; using JetBrains.Annotations; using System.Runtime.CompilerServices; using Light.GuardClauses.Exceptions; namespace Light.GuardClauses; public static partial class Check { /// /// Ensures that the specified uses , or otherwise throws an . /// /// The date time to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when does not use . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static DateTime MustBeUtc(this DateTime parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.Kind != DateTimeKind.Utc) Throw.MustBeUtcDateTime(parameter, parameterName, message); return parameter; } /// /// Ensures that the specified uses , or otherwise throws your custom exception. /// /// The date time to be checked. /// The delegate that creates your custom exception. is passed to this delegate. /// Your custom exception thrown when does not use . [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("exceptionFactory:null => halt")] public static DateTime MustBeUtc(this DateTime parameter, Func exceptionFactory) { if (parameter.Kind != DateTimeKind.Utc) Throw.CustomException(exceptionFactory, parameter); return parameter; } /// /// Ensures that the specified uses , or otherwise throws an . /// /// The date time to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when does not use . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static DateTime MustBeLocal(this DateTime parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.Kind != DateTimeKind.Local) Throw.MustBeLocalDateTime(parameter, parameterName, message); return parameter; } /// /// Ensures that the specified uses , or otherwise throws your custom exception. /// /// The date time to be checked. /// The delegate that creates your custom exception. is passed to this delegate. /// Your custom exception thrown when does not use . [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("exceptionFactory:null => halt")] public static DateTime MustBeLocal(this DateTime parameter, Func exceptionFactory) { if (parameter.Kind != DateTimeKind.Local) Throw.CustomException(exceptionFactory, parameter); return parameter; } /// /// Ensures that the specified uses , or otherwise throws an . /// /// The date time to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when does not use . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static DateTime MustBeUnspecified(this DateTime parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.Kind != DateTimeKind.Unspecified) Throw.MustBeUnspecifiedDateTime(parameter, parameterName, message); return parameter; } /// /// Ensures that the specified uses , or otherwise throws your custom exception. /// /// The date time to be checked. /// The delegate that creates your custom exception. is passed to this delegate. /// Your custom exception thrown when does not use . [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("exceptionFactory:null => halt")] public static DateTime MustBeUnspecified(this DateTime parameter, Func exceptionFactory) { if (parameter.Kind != DateTimeKind.Unspecified) Throw.CustomException(exceptionFactory, parameter); return parameter; } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Check.EnumerableAssertions.cs000066400000000000000000001266111470750352700272420ustar00rootroot00000000000000using System; using System.Collections; using System.Collections.Generic; using System.Diagnostics.CodeAnalysis; using System.Linq; using System.Runtime.CompilerServices; using JetBrains.Annotations; using Light.GuardClauses.Exceptions; using Light.GuardClauses.FrameworkExtensions; using NotNullAttribute = System.Diagnostics.CodeAnalysis.NotNullAttribute; namespace Light.GuardClauses; public static partial class Check { /// /// Ensures that the collection has the specified number of items, or otherwise throws an . /// /// The collection to be checked. /// The number of items the collection must have. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when does not have the specified number of items. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static TCollection MustHaveCount([NotNull, ValidatedNotNull] this TCollection? parameter, int count, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where TCollection : class, IEnumerable { if (parameter!.Count(parameterName, message) != count) Throw.InvalidCollectionCount(parameter, count, parameterName, message); return parameter; } /// /// Ensures that the collection has the specified number of items, or otherwise throws your custom exception. /// /// The collection to be checked. /// The number of items the collection must have. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when does not have the specified number of items, or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static TCollection MustHaveCount([NotNull, ValidatedNotNull] this TCollection? parameter, int count, Func exceptionFactory) where TCollection : class, IEnumerable { if (parameter is null || parameter.Count() != count) Throw.CustomException(exceptionFactory, parameter, count); return parameter; } /// /// Checks if the specified collection is null or empty. /// /// The collection to be checked. /// True if the collection is null or empty, else false. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("=> true, collection:canbenull; => false, collection:notnull")] public static bool IsNullOrEmpty([NotNullWhen(false)] this IEnumerable? collection) => collection is null || collection.Count() == 0; /// /// Ensures that the collection is not null or empty, or otherwise throws an . /// /// The collection to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when has no items. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static TCollection MustNotBeNullOrEmpty([NotNull, ValidatedNotNull] this TCollection? parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where TCollection : class, IEnumerable { if (parameter.Count(parameterName, message) == 0) Throw.EmptyCollection(parameterName, message); return parameter; } /// /// Ensures that the collection is not null or empty, or otherwise throws your custom exception. /// /// The collection to be checked. /// The delegate that creates your custom exception. /// Thrown when has no items, or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static TCollection MustNotBeNullOrEmpty([NotNull, ValidatedNotNull] this TCollection? parameter, Func exceptionFactory) where TCollection : class, IEnumerable { if (parameter is null || parameter.Count() == 0) Throw.CustomException(exceptionFactory, parameter); return parameter; } /// /// Ensures that the collection contains the specified item, or otherwise throws a . /// /// The collection to be checked. /// The item that must be part of the collection. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when does not contain . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static TCollection MustContain([NotNull, ValidatedNotNull] this TCollection? parameter, TItem item, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where TCollection : class, IEnumerable { if (parameter is ICollection collection) { if (!collection.Contains(item)) Throw.MissingItem(parameter, item, parameterName, message); return parameter; } if (!parameter.MustNotBeNull(parameterName, message).Contains(item)) Throw.MissingItem(parameter, item, parameterName, message); return parameter; } /// /// Ensures that the collection contains the specified item, or otherwise throws your custom exception. /// /// The collection to be checked. /// The item that must be part of the collection. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when does not contain , or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static TCollection MustContain([NotNull, ValidatedNotNull] this TCollection? parameter, TItem item, Func exceptionFactory) where TCollection : class, IEnumerable { if (parameter is ICollection collection) { if (!collection.Contains(item)) Throw.CustomException(exceptionFactory, parameter, item); return parameter; } if (parameter is null || !parameter.Contains(item)) Throw.CustomException(exceptionFactory, parameter, item); return parameter; } /// /// Ensures that the collection does not contain the specified item, or otherwise throws an . /// /// The collection to be checked. /// The item that must not be part of the collection. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when contains . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static TCollection MustNotContain([NotNull, ValidatedNotNull] this TCollection? parameter, TItem item, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where TCollection : class, IEnumerable { if (parameter is ICollection collection) { if (collection.Contains(item)) Throw.ExistingItem(parameter, item, parameterName, message); return parameter; } if (parameter.MustNotBeNull(parameterName, message).Contains(item)) Throw.ExistingItem(parameter, item, parameterName, message); return parameter; } /// /// Ensures that the collection does not contain the specified item, or otherwise throws your custom exception. /// /// The collection to be checked. /// The item that must not be part of the collection. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when contains . [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static TCollection MustNotContain([NotNull, ValidatedNotNull] this TCollection? parameter, TItem item, Func exceptionFactory) where TCollection : class, IEnumerable { if (parameter is ICollection collection) { if (collection.Contains(item)) Throw.CustomException(exceptionFactory, parameter, item); return parameter; } if (parameter is null || parameter.Contains(item)) Throw.CustomException(exceptionFactory, parameter, item); return parameter; } /// /// Checks if the given is one of the specified . /// /// The item to be checked. /// The collection that might contain the . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("items:null => halt")] // ReSharper disable once RedundantNullableFlowAttribute - the attribute has an effect, see Issue72NotNullAttribute tests public static bool IsOneOf(this TItem item, [NotNull, ValidatedNotNull] IEnumerable items) { if (items is ICollection collection) return collection.Contains(item); if (items is string @string && item is char character) return @string.IndexOf(character) != -1; return items.MustNotBeNull(nameof(items)).ContainsViaForeach(item); } /// /// Ensures that the value is one of the specified items, or otherwise throws a . /// /// The value to be checked. /// The items that should contain the value. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is not equal to one of the specified . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("items:null => halt")] // ReSharper disable once RedundantNullableFlowAttribute - the attribute has an effect, see Issue72NotNullAttribute tests public static TItem MustBeOneOf(this TItem parameter, [NotNull, ValidatedNotNull] IEnumerable items, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { // ReSharper disable PossibleMultipleEnumeration if (!parameter.IsOneOf(items.MustNotBeNull(nameof(items), message))) Throw.ValueNotOneOf(parameter, items, parameterName, message); return parameter; // ReSharper restore PossibleMultipleEnumeration } /// /// Ensures that the value is one of the specified items, or otherwise throws your custom exception. /// /// The value to be checked. /// The items that should contain the value. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when is not equal to one of the specified , or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("items:null => halt")] public static TItem MustBeOneOf(this TItem parameter, [NotNull, ValidatedNotNull] TCollection items, Func exceptionFactory) where TCollection : class, IEnumerable { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (items is null || !parameter.IsOneOf(items)) Throw.CustomException(exceptionFactory, parameter, items!); return parameter; } /// /// Ensures that the value is not one of the specified items, or otherwise throws a . /// /// The value to be checked. /// The items that must not contain the value. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is equal to one of the specified . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("items:null => halt")] // ReSharper disable once RedundantNullableFlowAttribute - the attribute has an effect, see Issue72NotNullAttribute tests public static TItem MustNotBeOneOf(this TItem parameter, [NotNull, ValidatedNotNull] IEnumerable items, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { // ReSharper disable PossibleMultipleEnumeration if (parameter.IsOneOf(items.MustNotBeNull(nameof(items), message))) Throw.ValueIsOneOf(parameter, items, parameterName, message); return parameter; // ReSharper restore PossibleMultipleEnumeration } /// /// Ensures that the value is not one of the specified items, or otherwise throws your custom exception. /// /// The value to be checked. /// The items that must not contain the value. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when is equal to one of the specified , or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("items:null => halt")] public static TItem MustNotBeOneOf(this TItem parameter, [NotNull, ValidatedNotNull] TCollection items, Func exceptionFactory) where TCollection : class, IEnumerable { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (items is null || parameter.IsOneOf(items)) Throw.CustomException(exceptionFactory, parameter, items!); return parameter; } /// /// Ensures that the collection has at least the specified number of items, or otherwise throws an . /// /// The collection to be checked. /// The number of items the collection should have at least. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when does not contain at least the specified number of items. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static TCollection MustHaveMinimumCount([NotNull, ValidatedNotNull] this TCollection? parameter, int count, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where TCollection : class, IEnumerable { if (parameter.Count(parameterName, message) < count) Throw.InvalidMinimumCollectionCount(parameter, count, parameterName, message); return parameter; } /// /// Ensures that the collection has at least the specified number of items, or otherwise throws your custom exception. /// /// The collection to be checked. /// The number of items the collection should have at least. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when does not contain at least the specified number of items, or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static TCollection MustHaveMinimumCount([NotNull, ValidatedNotNull] this TCollection? parameter, int count, Func exceptionFactory) where TCollection : class, IEnumerable { if (parameter is null || parameter.Count() < count) Throw.CustomException(exceptionFactory, parameter, count); return parameter; } /// /// Ensures that the collection has at most the specified number of items, or otherwise throws an . /// /// The collection to be checked. /// The number of items the collection should have at most. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when does not contain at most the specified number of items. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static TCollection MustHaveMaximumCount([NotNull, ValidatedNotNull] this TCollection? parameter, int count, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where TCollection : class, IEnumerable { if (parameter.Count(parameterName, message) > count) Throw.InvalidMaximumCollectionCount(parameter, count, parameterName, message); return parameter; } /// /// Ensures that the collection has at most the specified number of items, or otherwise throws your custom exception. /// /// The collection to be checked. /// The number of items the collection should have at most. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when does not contain at most the specified number of items, or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static TCollection MustHaveMaximumCount([NotNull, ValidatedNotNull] this TCollection? parameter, int count, Func exceptionFactory) where TCollection : class, IEnumerable { if (parameter is null || parameter.Count() > count) Throw.CustomException(exceptionFactory, parameter, count); return parameter; } /// /// Ensures that the span has the specified length, or otherwise throws an . /// /// The span to be checked. /// The length that the span must have. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when does not have the specified length. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Span MustHaveLength(this Span parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.Length != length) Throw.InvalidSpanLength(parameter, length, parameterName, message); return parameter; } /// /// Ensures that the span has the specified length, or otherwise throws your custom exception. /// /// The span to be checked. /// The length that the span must have. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when does not have the specified length. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Span MustHaveLength(this Span parameter, int length, SpanExceptionFactory exceptionFactory) { if (parameter.Length != length) Throw.CustomSpanException(exceptionFactory, parameter, length); return parameter; } /// /// Ensures that the span has the specified length, or otherwise throws your custom exception. /// /// The span to be checked. /// The length that the span must have. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Your custom exception thrown when does not have the specified length. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ReadOnlySpan MustHaveLength(this ReadOnlySpan parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.Length != length) Throw.InvalidSpanLength(parameter, length, parameterName, message); return parameter; } /// /// Ensures that the span has the specified length, or otherwise throws your custom exception. /// /// The span to be checked. /// The length that the span must have. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when does not have the specified length. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ReadOnlySpan MustHaveLength(this ReadOnlySpan parameter, int length, ReadOnlySpanExceptionFactory exceptionFactory) { if (parameter.Length != length) Throw.CustomSpanException(exceptionFactory, parameter, length); return parameter; } /// /// Ensures that the span is longer than the specified length, or otherwise throws an . /// /// The span to be checked. /// The value that the span must be longer than. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is shorter than or equal to . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Span MustBeLongerThan(this Span parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.Length <= length) Throw.SpanMustBeLongerThan(parameter, length, parameterName, message); return parameter; } /// /// Ensures that the span is longer than the specified length, or otherwise throws your custom exception. /// /// The span to be checked. /// The length value that the span must be longer than. /// The delegate that creates your custom exception. and are passed to it. /// Your custom exception thrown when is shorter than or equal to . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Span MustBeLongerThan(this Span parameter, int length, SpanExceptionFactory exceptionFactory) { if (parameter.Length <= length) Throw.CustomSpanException(exceptionFactory, parameter, length); return parameter; } /// /// Ensures that the span is longer than the specified length, or otherwise throws an . /// /// The span to be checked. /// The value that the span must be longer than. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is shorter than or equal to . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ReadOnlySpan MustBeLongerThan(this ReadOnlySpan parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.Length <= length) Throw.SpanMustBeLongerThan(parameter, length, parameterName, message); return parameter; } /// /// Ensures that the span is longer than the specified length, or otherwise throws your custom exception. /// /// The span to be checked. /// The length value that the span must be longer than. /// The delegate that creates your custom exception. and are passed to it. /// Your custom exception thrown when is shorter than or equal to . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ReadOnlySpan MustBeLongerThan(this ReadOnlySpan parameter, int length, ReadOnlySpanExceptionFactory exceptionFactory) { if (parameter.Length <= length) Throw.CustomSpanException(exceptionFactory, parameter, length); return parameter; } /// /// Ensures that the span is longer than or equal to the specified length, or otherwise throws an . /// /// The span to be checked. /// The value that the span must be longer than or equal to. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is shorter than . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Span MustBeLongerThanOrEqualTo(this Span parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.Length < length) Throw.SpanMustBeLongerThanOrEqualTo(parameter, length, parameterName, message); return parameter; } /// /// Ensures that the span is longer than or equal to the specified length, or otherwise throws your custom exception. /// /// The span to be checked. /// The value that the span must be longer than or equal to. /// The delegate that creates your custom exception. and are passed to it. /// Your custom exception thrown when is shorter than . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Span MustBeLongerThanOrEqualTo(this Span parameter, int length, SpanExceptionFactory exceptionFactory) { if (parameter.Length < length) Throw.CustomSpanException(exceptionFactory, parameter, length); return parameter; } /// /// Ensures that the span is longer than or equal to the specified length, or otherwise throws an . /// /// The span to be checked. /// The value that the span must be longer than or equal to. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is shorter than . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ReadOnlySpan MustBeLongerThanOrEqualTo(this ReadOnlySpan parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.Length < length) Throw.SpanMustBeLongerThanOrEqualTo(parameter, length, parameterName, message); return parameter; } /// /// Ensures that the span is longer than or equal to the specified length, or otherwise throws your custom exception. /// /// The span to be checked. /// The value that the span must be longer than or equal to. /// The delegate that creates your custom exception. and are passed to it. /// Your custom exception thrown when is shorter than . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ReadOnlySpan MustBeLongerThanOrEqualTo(this ReadOnlySpan parameter, int length, ReadOnlySpanExceptionFactory exceptionFactory) { if (parameter.Length < length) Throw.CustomSpanException(exceptionFactory, parameter, length); return parameter; } /// /// Ensures that the span is shorter than the specified length, or otherwise throws an . /// /// The span to be checked. /// The length value that the span must be shorter than. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is longer than or equal to . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Span MustBeShorterThan(this Span parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.Length >= length) Throw.SpanMustBeShorterThan(parameter, length, parameterName, message); return parameter; } /// /// Ensures that the span is shorter than the specified length, or otherwise throws your custom exception. /// /// The span to be checked. /// The length value that the span must be shorter than. /// The delegate that creates your custom exception. and are passed to it. /// Your custom exception thrown when is longer than or equal to . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Span MustBeShorterThan(this Span parameter, int length, SpanExceptionFactory exceptionFactory) { if (parameter.Length >= length) Throw.CustomSpanException(exceptionFactory, parameter, length); return parameter; } /// /// Ensures that the span is shorter than the specified length, or otherwise throws an . /// /// The span to be checked. /// The length value that the span must be shorter than. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is longer than or equal to . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ReadOnlySpan MustBeShorterThan(this ReadOnlySpan parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.Length >= length) Throw.SpanMustBeShorterThan(parameter, length, parameterName, message); return parameter; } /// /// Ensures that the span is shorter than the specified length, or otherwise throws your custom exception. /// /// The span to be checked. /// The length value that the span must be shorter than. /// The delegate that creates your custom exception. and are passed to it. /// Your custom exception thrown when is longer than or equal to . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ReadOnlySpan MustBeShorterThan(this ReadOnlySpan parameter, int length, ReadOnlySpanExceptionFactory exceptionFactory) { if (parameter.Length >= length) Throw.CustomSpanException(exceptionFactory, parameter, length); return parameter; } /// /// Ensures that the span is shorter than or equal to the specified length, or otherwise throws an . /// /// The span to be checked. /// The length value that the span must be shorter than or equal to. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is longer than . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Span MustBeShorterThanOrEqualTo(this Span parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.Length > length) Throw.SpanMustBeShorterThanOrEqualTo(parameter, length, parameterName, message); return parameter; } /// /// Ensures that the span is shorter than or equal to the specified length, or otherwise throws your custom exception. /// /// The span to be checked. /// The length value that the span must be shorter than or equal to. /// The delegate that creates your custom exception. and are passed to it. /// Your custom exception thrown when is longer than . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Span MustBeShorterThanOrEqualTo(this Span parameter, int length, SpanExceptionFactory exceptionFactory) { if (parameter.Length > length) Throw.CustomSpanException(exceptionFactory, parameter, length); return parameter; } /// /// Ensures that the span is shorter than or equal to the specified length, or otherwise throws an . /// /// The span to be checked. /// The length value that the span must be shorter than or equal to. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is longer than . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ReadOnlySpan MustBeShorterThanOrEqualTo(this ReadOnlySpan parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.Length > length) Throw.SpanMustBeShorterThanOrEqualTo(parameter, length, parameterName, message); return parameter; } /// /// Ensures that the span is shorter than or equal to the specified length, or otherwise throws your custom exception. /// /// The span to be checked. /// The length value that the span must be shorter than or equal to. /// The delegate that creates your custom exception. and are passed to it. /// Your custom exception thrown when is longer than . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ReadOnlySpan MustBeShorterThanOrEqualTo(this ReadOnlySpan parameter, int length, ReadOnlySpanExceptionFactory exceptionFactory) { if (parameter.Length > length) Throw.CustomSpanException(exceptionFactory, parameter, length); return parameter; } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Check.StringAssertions.cs000066400000000000000000003225211470750352700264270ustar00rootroot00000000000000using System; using System.Diagnostics.CodeAnalysis; using System.Text.RegularExpressions; using JetBrains.Annotations; using Light.GuardClauses.Exceptions; using Light.GuardClauses.FrameworkExtensions; using System.Runtime.CompilerServices; using NotNullAttribute = System.Diagnostics.CodeAnalysis.NotNullAttribute; namespace Light.GuardClauses; public static partial class Check { /// /// Checks if the specified string is null or empty. /// /// The string to be checked. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("=> false, string:notnull; => true, string:canbenull")] public static bool IsNullOrEmpty([NotNullWhen(false)] this string? @string) => string.IsNullOrEmpty(@string); /// /// Ensures that the specified string is not null or empty, or otherwise throws an or . /// /// The string to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is an empty string. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustNotBeNullOrEmpty([NotNull, ValidatedNotNull] this string? parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter is null) Throw.ArgumentNull(parameterName, message); if (parameter.Length == 0) Throw.EmptyString(parameterName, message); return parameter; } /// /// Ensures that the specified string is not null or empty, or otherwise throws your custom exception. /// /// The string to be checked. /// The delegate that creates your custom exception. is passed to this delegate. /// Your custom exception thrown when is an empty string or null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; exceptionFactory:null => halt")] public static string MustNotBeNullOrEmpty([NotNull, ValidatedNotNull] this string? parameter, Func exceptionFactory) { if (parameter.IsNullOrEmpty()) Throw.CustomException(exceptionFactory, parameter); return parameter; } /// /// Checks if the specified string is null, empty, or contains only white space. /// /// The string to be checked. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("=> false, string:notnull; => true, string:canbenull")] public static bool IsNullOrWhiteSpace([NotNullWhen(false)] this string? @string) => string.IsNullOrWhiteSpace(@string); /// /// Ensures that the specified string is not null, empty, or contains only white space, or otherwise throws an , an , or a . /// /// The string to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when contains only white space. /// Thrown when is an empty string. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustNotBeNullOrWhiteSpace([NotNull, ValidatedNotNull] this string? parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { parameter.MustNotBeNullOrEmpty(parameterName, message); foreach (var character in parameter) { if (!character.IsWhiteSpace()) return parameter; } Throw.WhiteSpaceString(parameter, parameterName, message); return null; } /// /// Ensures that the specified string is not null, empty, or contains only white space, or otherwise throws your custom exception. /// /// The string to be checked. /// The delegate that creates your custom exception. is passed to this delegate. /// Your custom exception thrown when is null, empty, or contains only white space. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; exceptionFactory: null => halt")] public static string MustNotBeNullOrWhiteSpace([NotNull, ValidatedNotNull] this string? parameter, Func exceptionFactory) { if (parameter.IsNullOrWhiteSpace()) Throw.CustomException(exceptionFactory, parameter); return parameter; } /// /// Checks if the specified character is a white space character. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsWhiteSpace(this char character) => char.IsWhiteSpace(character); /// /// Checks if the specified character is a letter. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsLetter(this char character) => char.IsLetter(character); /// /// Checks if the specified character is a letter or digit. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsLetterOrDigit(this char character) => char.IsLetterOrDigit(character); /// /// Checks if the specified character is a digit. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsDigit(this char character) => char.IsDigit(character); /// /// Ensures that the two strings are equal using the specified , or otherwise throws a . /// /// The first string to be compared. /// The second string to be compared. /// The enum value specifying how the two strings should be compared. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is not equal to . /// Thrown when is not a valid value from the enum. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static string? MustBe(this string? parameter, string? other, StringComparison comparisonType, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (!string.Equals(parameter, other, comparisonType)) Throw.ValuesNotEqual(parameter, other, parameterName, message); return parameter; } /// /// Ensures that the two strings are equal using the specified , or otherwise throws your custom exception. /// /// The first string to be compared. /// The second string to be compared. /// The enum value specifying how the two strings should be compared. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when is not equal to . /// Thrown when is not a valid value from the enum. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static string? MustBe(this string? parameter, string? other, StringComparison comparisonType, Func exceptionFactory) { if (!string.Equals(parameter, other, comparisonType)) Throw.CustomException(exceptionFactory, parameter, other, comparisonType); return parameter; } /// /// Ensures that the two strings are equal using the specified , or otherwise throws a . /// /// The first string to be compared. /// The second string to be compared. /// The enum value specifying how the two strings should be compared. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is not equal to . /// Thrown when is not a valid value from the enum. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static string? MustBe(this string? parameter, string? other, StringComparisonType comparisonType, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (!parameter.Equals(other, comparisonType)) Throw.ValuesNotEqual(parameter, other, parameterName, message); return parameter; } /// /// Ensures that the two strings are equal using the specified , or otherwise throws your custom exception. /// /// The first string to be compared. /// The second string to be compared. /// The enum value specifying how the two strings should be compared. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when is not equal to . /// Thrown when is not a valid value from the enum. public static string? MustBe(this string? parameter, string? other, StringComparisonType comparisonType, Func exceptionFactory) { if (!parameter.Equals(other, comparisonType)) Throw.CustomException(exceptionFactory, parameter, other, comparisonType); return parameter; } /// /// Ensures that the two strings are not equal using the specified , or otherwise throws a . /// /// The first string to be compared. /// The second string to be compared. /// The enum value specifying how the two strings should be compared. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is equal to . /// Thrown when is not a valid value from the enum. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static string? MustNotBe(this string? parameter, string? other, StringComparison comparisonType, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (string.Equals(parameter, other, comparisonType)) Throw.ValuesEqual(parameter, other, parameterName, message); return parameter; } /// /// Ensures that the two strings are not equal using the specified , or otherwise throws your custom exception. /// /// The first string to be compared. /// The second string to be compared. /// The enum value specifying how the two strings should be compared. /// The delegate that creates your custom exception. , , and are passed to this delegate. /// Your custom exception thrown when is equal to . /// Thrown when is not a valid value from the enum. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static string? MustNotBe(this string? parameter, string? other, StringComparison comparisonType, Func exceptionFactory) { if (string.Equals(parameter, other, comparisonType)) Throw.CustomException(exceptionFactory, parameter, other); return parameter; } /// /// Ensures that the two strings are not equal using the specified , or otherwise throws a . /// /// The first string to be compared. /// The second string to be compared. /// The enum value specifying how the two strings should be compared. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is equal to . /// Thrown when is not a valid value from the enum. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static string? MustNotBe(this string? parameter, string? other, StringComparisonType comparisonType, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.Equals(other, comparisonType)) Throw.ValuesEqual(parameter, other, parameterName, message); return parameter; } /// /// Ensures that the two strings are not equal using the specified , or otherwise throws your custom exception. /// /// The first string to be compared. /// The second string to be compared. /// The enum value specifying how the two strings should be compared. /// The delegate that creates your custom exception. , , and are passed to this delegate. /// Your custom exception thrown when is equal to . /// Thrown when is not a valid value from the enum. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static string? MustNotBe(this string? parameter, string? other, StringComparisonType comparisonType, Func exceptionFactory) { if (parameter.Equals(other, comparisonType)) Throw.CustomException(exceptionFactory, parameter, other, comparisonType); return parameter; } /// /// Ensures that the string matches the specified regular expression, or otherwise throws a . /// /// The string to be checked. /// The regular expression used for pattern matching. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when does not match the specified regular expression. /// Thrown when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; regex:null => halt")] public static string MustMatch([NotNull, ValidatedNotNull] this string? parameter, Regex regex, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (!regex.MustNotBeNull(nameof(regex), message).IsMatch(parameter.MustNotBeNull(parameterName, message))) Throw.StringDoesNotMatch(parameter, regex, parameterName, message); return parameter; } /// /// Ensures that the string matches the specified regular expression, or otherwise throws your custom exception. /// /// The string to be checked. /// The regular expression used for pattern matching. /// The delegate that creates your custom exception. and are passed to this delegate. /// /// Your custom exception thrown when does not match the specified regular expression, /// or when is null, /// or when is null. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static string MustMatch([NotNull, ValidatedNotNull] this string? parameter, Regex regex, Func exceptionFactory) { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (parameter is null || regex is null || !regex.IsMatch(parameter)) Throw.CustomException(exceptionFactory, parameter, regex!); return parameter; } /// /// Checks if the specified strings are equal, using the given comparison rules. /// /// The first string to compare. /// The second string to compare. /// One of the enumeration values that specifies the rules for the comparison. /// True if the two strings are considered equal, else false. /// Thrown when is no valid enum value. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool Equals(this string? @string, string? value, StringComparisonType comparisonType) { if ((int) comparisonType < 6) return string.Equals(@string, value, (StringComparison) comparisonType); if (comparisonType == StringComparisonType.OrdinalIgnoreWhiteSpace) return @string.EqualsOrdinalIgnoreWhiteSpace(value); if (comparisonType == StringComparisonType.OrdinalIgnoreCaseIgnoreWhiteSpace) return @string.EqualsOrdinalIgnoreCaseIgnoreWhiteSpace(value); Throw.EnumValueNotDefined(comparisonType, nameof(comparisonType)); return false; } /// /// Ensures that the string contains the specified substring, or otherwise throws a . /// /// The string to be checked. /// The substring that must be part of . /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when does not contain . /// Thrown when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustContain([NotNull, ValidatedNotNull] this string? parameter, string? value, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (!parameter.MustNotBeNull(parameterName, message).Contains(value.MustNotBeNull(nameof(value), message))) { Throw.StringDoesNotContain(parameter, value, parameterName, message); } return parameter; } /// /// Ensures that the string contains the specified value, or otherwise throws your custom exception. /// /// The string to be checked. /// The substring that must be part of . /// The delegate that creates you custom exception. and are passed to this delegate. /// /// Your custom exception thrown when does not contain , /// or when is null, /// or when is null. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustContain([NotNull, ValidatedNotNull] this string? parameter, string value, Func exceptionFactory) { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (parameter is null || value is null || !parameter.Contains(value)) { Throw.CustomException(exceptionFactory, parameter, value!); } return parameter; } /// /// Ensures that the string contains the specified value, or otherwise throws a . /// /// The string to be checked. /// The substring that must be part of . /// One of the enumeration values that specifies the rules for the search. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when does not contain . /// Thrown when or is null. /// Thrown when is not a valid value. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustContain([NotNull, ValidatedNotNull] this string? parameter, string value, StringComparison comparisonType, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.MustNotBeNull(parameterName, message).IndexOf(value.MustNotBeNull(nameof(value), message), comparisonType) < 0) { Throw.StringDoesNotContain(parameter, value, comparisonType, parameterName, message); } return parameter; } /// /// Ensures that the string contains the specified value, or otherwise throws your custom exception. /// /// The string to be checked. /// The substring that must be part of . /// One of the enumeration values that specifies the rules for the search. /// The delegate that creates you custom exception. , , and are passed to this delegate. /// /// Your custom exception thrown when does not contain , /// or when is null, /// or when is null. /// /// Thrown when is not a valid value. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustContain([NotNull, ValidatedNotNull] this string? parameter, string value, StringComparison comparisonType, Func exceptionFactory) { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (parameter is null || value is null || parameter.IndexOf(value, comparisonType) < 0) { Throw.CustomException(exceptionFactory, parameter, value!, comparisonType); } return parameter; } /// /// Ensures that the string does not contain the specified value, or otherwise throws a . /// /// The string to be checked. /// The string that must not be part of . /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when contains . /// Thrown when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustNotContain([NotNull, ValidatedNotNull] this string? parameter, string value, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.MustNotBeNull(parameterName, message).Contains(value.MustNotBeNull(nameof(value), message))) { Throw.StringContains(parameter, value, parameterName, message); } return parameter; } /// /// Ensures that the string does not contain the specified value, or otherwise throws your custom exception. /// /// The string to be checked. /// The string that must not be part of . /// The delegate that creates your custom exception (optional). and are passed to this delegate. /// /// Your custom exception thrown when contains , /// or when is null, /// or when is null. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustNotContain([NotNull, ValidatedNotNull] this string? parameter, string value, Func exceptionFactory) { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (parameter is null || value is null || parameter.Contains(value)) Throw.CustomException(exceptionFactory, parameter, value!); return parameter; } /// /// Ensures that the string does not contain the specified value, or otherwise throws a . /// /// The string to be checked. /// The string that must not be part of . /// One of the enumeration values that specifies the rules for the search. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when contains . /// Thrown when or is null. /// Thrown when is not a valid value. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustNotContain([NotNull, ValidatedNotNull] this string? parameter, string value, StringComparison comparisonType, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.MustNotBeNull(parameterName, message).IndexOf(value.MustNotBeNull(nameof(value), message), comparisonType) >= 0) Throw.StringContains(parameter, value, comparisonType, parameterName, message); return parameter; } /// /// Ensures that the string does not contain the specified value, or otherwise throws your custom exception. /// /// The string to be checked. /// The string that must not be part of . /// One of the enumeration values that specifies the rules for the search. /// The delegate that creates your custom exception (optional). , , and are passed to this delegate. /// /// Your custom exception thrown when contains , /// or when is null, /// or when is null. /// /// Thrown when is not a valid value. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustNotContain([NotNull, ValidatedNotNull] this string? parameter, string value, StringComparison comparisonType, Func exceptionFactory) { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (parameter is null || value is null || parameter.IndexOf(value, comparisonType) >= 0) Throw.CustomException(exceptionFactory, parameter, value!, comparisonType); return parameter; } /// /// Checks if the string contains the specified value using the given comparison type. /// /// The string to be checked. /// The other string. /// One of the enumeration values that specifies the rules for the search. /// True if contains , else false. /// Thrown when or is null. /// Thrown when is not a valid value. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("string:null => halt; value:null => halt")] // ReSharper disable once RedundantNullableFlowAttribute public static bool Contains([NotNull, ValidatedNotNull] this string @string, string value, StringComparison comparisonType) => @string.MustNotBeNull(nameof(@string)).IndexOf(value.MustNotBeNull(nameof(value)), comparisonType) >= 0; /// /// Checks if the string is a substring of the other string. /// /// The string to be checked. /// The other string. /// True if is a substring of , else false. /// Thrown when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("value:null => halt; other:null => halt")] // ReSharper disable RedundantNullableFlowAttribute public static bool IsSubstringOf([NotNull, ValidatedNotNull] this string value, [NotNull, ValidatedNotNull] string other) => other.MustNotBeNull(nameof(other)).Contains(value); // ReSharper restore RedundantNullableFlowAttribute /// /// Checks if the string is a substring of the other string. /// /// The string to be checked. /// The other string. /// One of the enumeration values that specifies the rules for the search. /// True if is a substring of , else false. /// Thrown when or is null. /// Thrown when is not a valid value. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("value:null => halt; other:null => halt")] // ReSharper disable RedundantNullableFlowAttribute public static bool IsSubstringOf([NotNull, ValidatedNotNull] this string value, [NotNull, ValidatedNotNull] string other, StringComparison comparisonType) => other.MustNotBeNull(nameof(other)).IndexOf(value, comparisonType) != -1; // ReSharper disable RedundantNullableFlowAttribute /// /// Ensures that the string is a substring of the specified other string, or otherwise throws a . /// /// The string to be checked. /// The other string that must contain . /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when does not contain . /// Thrown when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; value:null => halt")] public static string MustBeSubstringOf([NotNull, ValidatedNotNull] this string? parameter, string value, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (!value.MustNotBeNull(nameof(value), message).Contains(parameter.MustNotBeNull(parameterName, message))) Throw.NotSubstring(parameter, value, parameterName, message); return parameter; } /// /// Ensures that the string is a substring of the specified other string, or otherwise throws your custom exception. /// /// The string to be checked. /// The other string that must contain . /// The delegate that creates your custom exception. and are passed to this delegate. /// /// Your custom exception thrown when does not contain , /// or when is null, /// or when is null. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; value:null => halt")] public static string MustBeSubstringOf([NotNull, ValidatedNotNull] this string? parameter, string value, Func exceptionFactory) { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (parameter is null || value is null || !value.Contains(parameter)) Throw.CustomException(exceptionFactory, parameter, value!); return parameter; } /// /// Ensures that the string is a substring of the specified other string, or otherwise throws a . /// /// The string to be checked. /// The other string that must contain . /// One of the enumeration values that specifies the rules for the search. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when does not contain . /// Thrown when or is null. /// Thrown when is not a valid value. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; value:null => halt")] public static string MustBeSubstringOf([NotNull, ValidatedNotNull] this string? parameter, string value, StringComparison comparisonType, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (value.MustNotBeNull(nameof(value), message).IndexOf(parameter.MustNotBeNull(parameterName, message), comparisonType) == -1) Throw.NotSubstring(parameter, value, comparisonType, parameterName, message); return parameter; } /// /// Ensures that the string is a substring of the specified other string, or otherwise throws your custom exception. /// /// The string to be checked. /// The other string that must contain . /// One of the enumeration values that specifies the rules for the search. /// The delegate that creates your custom exception. , , and are passed to this delegate. /// /// Your custom exception thrown when does not contain , /// or when is null, /// or when is null. /// /// Thrown when is not a valid value. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; value:null => halt")] public static string MustBeSubstringOf([NotNull, ValidatedNotNull] this string? parameter, string value, StringComparison comparisonType, Func exceptionFactory) { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (parameter is null || value is null || value.IndexOf(parameter, comparisonType) == -1) Throw.CustomException(exceptionFactory, parameter, value!, comparisonType); return parameter; } /// /// Ensures that the string is not a substring of the specified other string, or otherwise throws a . /// /// The string to be checked. /// The other string that must not contain . /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when contains . /// Thrown when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; value:null => halt")] public static string MustNotBeSubstringOf([NotNull, ValidatedNotNull] this string? parameter, string value, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (value.MustNotBeNull(nameof(value), message).Contains(parameter.MustNotBeNull(parameterName, message))) Throw.Substring(parameter, value, parameterName, message); return parameter; } /// /// Ensures that the string is not a substring of the specified other string, or otherwise throws your custom exception. /// /// The string to be checked. /// The other string that must not contain . /// The delegate that creates your custom exception. and are passed to this delegate. /// /// Your custom exception thrown when contains , /// or when is null, /// or when is null. /// /// Thrown when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; value:null => halt")] public static string MustNotBeSubstringOf([NotNull, ValidatedNotNull] this string? parameter, string value, Func exceptionFactory) { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (parameter is null || value is null || value.Contains(parameter)) Throw.CustomException(exceptionFactory, parameter, value!); return parameter; } /// /// Ensures that the string is not a substring of the specified other string, or otherwise throws a . /// /// The string to be checked. /// The other string that must not contain . /// One of the enumeration values that specifies the rules for the search. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when contains . /// Thrown when or is null. /// Thrown when is not a valid value. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; value:null => halt")] public static string MustNotBeSubstringOf([NotNull, ValidatedNotNull] this string? parameter, string value, StringComparison comparisonType, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (value.MustNotBeNull(nameof(value), message).IndexOf(parameter.MustNotBeNull(parameterName, message), comparisonType) != -1) Throw.Substring(parameter, value, comparisonType, parameterName, message); return parameter; } /// /// Ensures that the string is not a substring of the specified other string, or otherwise throws your custom exception. /// /// The string to be checked. /// The other string that must not contain . /// One of the enumeration values that specifies the rules for the search. /// The delegate that creates your custom exception. , , and are passed to this delegate. /// /// Your custom exception thrown when contains , /// or when is null, /// or when is null. /// /// Thrown when is not a valid value. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; value:null => halt")] public static string MustNotBeSubstringOf([NotNull, ValidatedNotNull] this string? parameter, string value, StringComparison comparisonType, Func exceptionFactory) { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (parameter is null || value is null || value.IndexOf(parameter, comparisonType) != -1) Throw.CustomException(exceptionFactory, parameter, value!, comparisonType); return parameter; } /// /// Ensures that the string starts with the specified value, or otherwise throws a . /// /// The string to be checked. /// The other string must start with. /// One of the enumeration values that specifies the rules for the search (optional). The default value is . /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when does not start with . /// Thrown when or is null. /// Thrown when is not a valid value. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; value:null => halt")] public static string MustStartWith( [NotNull, ValidatedNotNull] this string? parameter, [NotNull, ValidatedNotNull] string value, StringComparison comparisonType = StringComparison.CurrentCulture, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null ) { if (!parameter.MustNotBeNull(parameterName, message).StartsWith(value, comparisonType)) { Throw.StringDoesNotStartWith(parameter, value, comparisonType, parameterName, message); } return parameter; } /// /// Ensures that the string starts with the specified value, or otherwise throws your custom exception. /// /// The string to be checked. /// The other string must start with. /// The delegate that creates your custom exception. and are passed to this delegate. /// /// Your custom exception thrown when does not start with , /// or when is null, /// or when is null. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; value:null => halt; exceptionFactory:null => halt")] public static string MustStartWith( [NotNull, ValidatedNotNull] this string? parameter, [NotNull, ValidatedNotNull] string value, [NotNull, ValidatedNotNull] Func exceptionFactory ) { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract -- caller might have NRTs turned off if (parameter is null || value is null || !parameter.StartsWith(value)) { Throw.CustomException(exceptionFactory, parameter, value!); } return parameter; } /// /// Ensures that the string starts with the specified value, or otherwise throws your custom exception. /// /// The string to be checked. /// The other string must start with. /// One of the enumeration values that specifies the rules for the search. /// The delegate that creates your custom exception. , , and are passed to this delegate. /// /// Your custom exception thrown when does not start with , /// or when is null, /// or when is null. /// /// Thrown when is not a valid value. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; value:null => halt; exceptionFactory:null => halt")] public static string MustStartWith( [NotNull, ValidatedNotNull] this string? parameter, [NotNull, ValidatedNotNull] string value, StringComparison comparisonType, [NotNull, ValidatedNotNull] Func exceptionFactory ) { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract -- caller might have NRTs turned off if (parameter is null || value is null || !comparisonType.IsValidEnumValue() || !parameter.StartsWith(value, comparisonType)) { Throw.CustomException(exceptionFactory, parameter, value!, comparisonType); } return parameter; } /// /// Ensures that the string does not start with the specified value, or otherwise throws a . /// /// The string to be checked. /// The other string that must not start with. /// One of the enumeration values that specifies the rules for the search (optional). The default value is . /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when starts with . /// Thrown when or is null. public static string MustNotStartWith( [NotNull, ValidatedNotNull] this string? parameter, [NotNull, ValidatedNotNull] string value, StringComparison comparisonType = StringComparison.CurrentCulture, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null ) { if (parameter.MustNotBeNull(parameterName, message).StartsWith(value, comparisonType)) { Throw.StringStartsWith(parameter, value, comparisonType, parameterName, message); } return parameter; } /// /// Ensures that the string does not start with the specified value, or otherwise throws your custom exception. /// /// The string to be checked. /// The other string that must not start with. /// The delegate that creates your custom exception. and are passed to this delegate. /// /// Your custom exception thrown when does not start with , /// or when is null, /// or when is null. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; value:null => halt; exceptionFactory:null => halt")] public static string MustNotStartWith( [NotNull, ValidatedNotNull] this string? parameter, [NotNull, ValidatedNotNull] string value, [NotNull, ValidatedNotNull] Func exceptionFactory ) { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract -- caller might have NRTs turned off if (parameter is null || value is null || parameter.StartsWith(value)) { Throw.CustomException(exceptionFactory, parameter, value!); } return parameter; } /// /// Ensures that the string does not start with the specified value, or otherwise throws your custom exception. /// /// The string to be checked. /// The other string that must not start with. /// One of the enumeration values that specifies the rules for the search. /// The delegate that creates your custom exception. , , and are passed to this delegate. /// /// Your custom exception thrown when does not start with , /// or when is null, /// or when is null. /// /// Thrown when is not a valid value. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; value:null => halt; exceptionFactory:null => halt")] public static string MustNotStartWith( [NotNull, ValidatedNotNull] this string? parameter, [NotNull, ValidatedNotNull] string value, StringComparison comparisonType, [NotNull, ValidatedNotNull] Func exceptionFactory ) { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract -- caller might have NRTs turned off if (parameter is null || value is null || parameter.StartsWith(value, comparisonType)) { Throw.CustomException(exceptionFactory, parameter, value!, comparisonType); } return parameter; } /// /// Ensures that the string ends with the specified value, or otherwise throws a . /// /// The string to be checked. /// The other string must end with. /// One of the enumeration values that specifies the rules for the search (optional). The default value is . /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when does not end with . /// Thrown when or is null. /// Thrown when is not a valid value. public static string MustEndWith( [NotNull, ValidatedNotNull] this string? parameter, [NotNull, ValidatedNotNull] string value, StringComparison comparisonType = StringComparison.CurrentCulture, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null ) { if (!parameter.MustNotBeNull(parameterName, message).EndsWith(value, comparisonType)) { Throw.StringDoesNotEndWith(parameter, value, comparisonType, parameterName, message); } return parameter; } /// /// Ensures that the string ends with the specified value, or otherwise throws a . /// /// The string to be checked. /// The other string must end with. /// The delegate that creates your custom exception. and are passed to this delegate. /// /// Your custom exception thrown when does not end with , /// or when is null, /// or when is null. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; value:null => halt; exceptionFactory:null => halt")] public static string MustEndWith( [NotNull, ValidatedNotNull] this string? parameter, [NotNull, ValidatedNotNull] string value, [NotNull, ValidatedNotNull] Func exceptionFactory ) { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract -- caller might have NRTs turned off if (parameter is null || value is null || !parameter.EndsWith(value)) { Throw.CustomException(exceptionFactory, parameter, value!); } return parameter; } /// /// Ensures that the string ends with the specified value, or otherwise throws a . /// /// The string to be checked. /// The other string must end with. /// One of the enumeration values that specifies the rules for the search. /// The delegate that creates your custom exception. , , and are passed to this delegate. /// /// Your custom exception thrown when does not end with , /// or when is null, /// or when is null. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; value:null => halt; exceptionFactory:null => halt")] public static string MustEndWith( [NotNull, ValidatedNotNull] this string? parameter, [NotNull, ValidatedNotNull] string value, StringComparison comparisonType, [NotNull, ValidatedNotNull] Func exceptionFactory ) { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract -- caller might have NRTs turned off if (parameter is null || value is null || !parameter.EndsWith(value, comparisonType)) { Throw.CustomException(exceptionFactory, parameter, value!, comparisonType); } return parameter; } /// /// Ensures that the string does not end with the specified value, or otherwise throws a . /// /// The string to be checked. /// The other string must not end with. /// One of the enumeration values that specifies the rules for the search (optional). The default value is . /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when ends with . /// Thrown when or is null. /// Thrown when is not a valid value. public static string MustNotEndWith( [NotNull, ValidatedNotNull] this string? parameter, [NotNull, ValidatedNotNull] string value, StringComparison comparisonType = StringComparison.CurrentCulture, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null ) { if (parameter.MustNotBeNull(parameterName, message).EndsWith(value, comparisonType)) { Throw.StringEndsWith(parameter, value, comparisonType, parameterName, message); } return parameter; } /// /// Ensures that the string does not end with the specified value, or otherwise throws a . /// /// The string to be checked. /// The other string must not end with. /// The delegate that creates your custom exception. and are passed to this delegate. /// /// Your custom exception thrown when ends with , /// or when is null, /// or when is null. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; value:null => halt; exceptionFactory:null => halt")] public static string MustNotEndWith( [NotNull, ValidatedNotNull] this string? parameter, [NotNull, ValidatedNotNull] string value, [NotNull, ValidatedNotNull] Func exceptionFactory ) { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract -- caller might have NRTs turned off if (parameter is null || value is null || parameter.EndsWith(value)) { Throw.CustomException(exceptionFactory, parameter, value!); } return parameter; } /// /// Ensures that the string does not end with the specified value, or otherwise throws a . /// /// The string to be checked. /// The other string must not end with. /// One of the enumeration values that specifies the rules for the search. /// The delegate that creates your custom exception. , , and are passed to this delegate. /// /// Your custom exception thrown when ends with , /// or when is null, /// or when is null. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; value:null => halt; exceptionFactory:null => halt")] public static string MustNotEndWith( [NotNull, ValidatedNotNull] this string? parameter, [NotNull, ValidatedNotNull] string value, StringComparison comparisonType, [NotNull, ValidatedNotNull] Func exceptionFactory ) { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract -- caller might have NRTs turned off if (parameter is null || value is null || parameter.EndsWith(value, comparisonType)) { Throw.CustomException(exceptionFactory, parameter, value!, comparisonType); } return parameter; } /// /// Checks if the specified string is an email address using the default email regular expression /// defined in . /// /// The string to be checked if it is an email address. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("emailAddress:null => false")] public static bool IsEmailAddress([NotNullWhen(true)] this string? emailAddress) => emailAddress != null && RegularExpressions.EmailRegex.IsMatch(emailAddress); /// /// Checks if the specified string is an email address using the provided regular expression for validation. /// /// The string to be checked. /// The regular expression that determines whether the input string is an email address. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("emailAddress:null => false; emailAddressPattern:null => halt")] public static bool IsEmailAddress([NotNullWhen(true)] this string? emailAddress, Regex emailAddressPattern) => emailAddress != null && emailAddressPattern.MustNotBeNull(nameof(emailAddressPattern)).IsMatch(emailAddress); /// /// Ensures that the string is a valid email address using the default email regular expression /// defined in , or otherwise throws an . /// /// The email address that will be validated. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is no valid email address. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeEmailAddress([NotNull, ValidatedNotNull] this string? parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (!parameter.MustNotBeNull(parameterName, message).IsEmailAddress()) Throw.InvalidEmailAddress(parameter, parameterName, message); return parameter; } /// /// Ensures that the string is a valid email address using the default email regular expression /// defined in , or otherwise throws your custom exception. /// /// The email address that will be validated. /// The delegate that creates your custom exception. is passed to this delegate. /// Your custom exception thrown when is null or no valid email address. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeEmailAddress([NotNull, ValidatedNotNull] this string? parameter, Func exceptionFactory) { if (!parameter.IsEmailAddress()) Throw.CustomException(exceptionFactory, parameter); return parameter; } /// /// Ensures that the string is a valid email address using the provided regular expression, /// or otherwise throws an . /// /// The email address that will be validated. /// The regular expression that determines if the input string is a valid email. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is no valid email address. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; emailAddressPattern:null => halt")] public static string MustBeEmailAddress([NotNull, ValidatedNotNull] this string? parameter, Regex emailAddressPattern, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (!parameter.MustNotBeNull(parameterName, message).IsEmailAddress(emailAddressPattern)) Throw.InvalidEmailAddress(parameter, parameterName, message); return parameter; } /// /// Ensures that the string is a valid email address using the provided regular expression, /// or otherwise throws your custom exception. /// /// The email address that will be validated. /// The regular expression that determines if the input string is a valid email. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when is null or no valid email address. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; emailAddressPattern:null => halt")] public static string MustBeEmailAddress([NotNull, ValidatedNotNull] this string? parameter, Regex emailAddressPattern, Func exceptionFactory) { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (emailAddressPattern is null || !parameter.IsEmailAddress(emailAddressPattern)) Throw.CustomException(exceptionFactory, parameter, emailAddressPattern!); return parameter; } /// /// Ensures that the string is shorter than the specified length, or otherwise throws a . /// /// The string to be checked. /// The length that the string must be shorter than. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when has a length greater than or equal to . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeShorterThan([NotNull, ValidatedNotNull] this string? parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.MustNotBeNull(parameterName, message).Length >= length) Throw.StringNotShorterThan(parameter, length, parameterName, message); return parameter; } /// /// Ensures that the string is shorter than the specified length, or otherwise throws your custom exception. /// /// The string to be checked. /// The length that the string must be shorter than. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when is null or when it has a length greater than or equal to . [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeShorterThan([NotNull, ValidatedNotNull] this string? parameter, int length, Func exceptionFactory) { if (parameter is null || parameter.Length >= length) Throw.CustomException(exceptionFactory, parameter, length); return parameter; } /// /// Ensures that the string is shorter than or equal to the specified length, or otherwise throws a . /// /// The string to be checked. /// The length that the string must be shorter than or equal to. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when has a length greater than . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeShorterThanOrEqualTo([NotNull, ValidatedNotNull] this string? parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.MustNotBeNull(parameterName, message).Length > length) Throw.StringNotShorterThanOrEqualTo(parameter, length, parameterName, message); return parameter; } /// /// Ensures that the string is shorter than or equal to the specified length, or otherwise throws your custom exception. /// /// The string to be checked. /// The length that the string must be shorter than or equal to. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when is null or when it has a length greater than . [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeShorterThanOrEqualTo([NotNull, ValidatedNotNull] this string? parameter, int length, Func exceptionFactory) { if (parameter is null || parameter.Length > length) Throw.CustomException(exceptionFactory, parameter, length); return parameter; } /// /// Ensures that the string has the specified length, or otherwise throws a . /// /// The string to be checked. /// The asserted length of the string. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when has a length other than . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustHaveLength([NotNull, ValidatedNotNull] this string? parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.MustNotBeNull(parameterName, message).Length != length) Throw.StringLengthNotEqualTo(parameter, length, parameterName, message); return parameter; } /// /// Ensures that the string has the specified length, or otherwise throws your custom exception. /// /// The string to be checked. /// The asserted length of the string. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when is null or when it has a length other than . [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustHaveLength([NotNull, ValidatedNotNull] this string? parameter, int length, Func exceptionFactory) { if (parameter is null || parameter.Length != length) Throw.CustomException(exceptionFactory, parameter, length); return parameter; } /// /// Ensures that the string is longer than the specified length, or otherwise throws a . /// /// The string to be checked. /// The length that the string must be longer than. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when has a length shorter than or equal to . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeLongerThan([NotNull, ValidatedNotNull] this string? parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.MustNotBeNull(parameterName, message).Length <= length) Throw.StringNotLongerThan(parameter, length, parameterName, message); return parameter; } /// /// Ensures that the string is longer than the specified length, or otherwise throws your custom exception. /// /// The string to be checked. /// The length that the string must be longer than. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when is null or when it has a length shorter than or equal to . [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeLongerThan([NotNull, ValidatedNotNull] this string? parameter, int length, Func exceptionFactory) { if (parameter is null || parameter.Length <= length) Throw.CustomException(exceptionFactory, parameter, length); return parameter; } /// /// Ensures that the string is longer than or equal to the specified length, or otherwise throws a . /// /// The string to be checked. /// The length that the string must be longer than or equal to. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when has a length shorter than . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeLongerThanOrEqualTo([NotNull, ValidatedNotNull] this string? parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.MustNotBeNull(parameterName, message).Length < length) Throw.StringNotLongerThanOrEqualTo(parameter, length, parameterName, message); return parameter; } /// /// Ensures that the string is longer than or equal to the specified length, or otherwise throws your custom exception. /// /// The string to be checked. /// The length that the string must be longer than or equal to. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when is null or when it has a length shorter than . [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeLongerThanOrEqualTo([NotNull, ValidatedNotNull] this string? parameter, int length, Func exceptionFactory) { if (parameter is null || parameter.Length < length) Throw.CustomException(exceptionFactory, parameter, length); return parameter; } /// /// Ensures that the string's length is within the specified range, or otherwise throws a . /// /// The string to be checked. /// The range where the string's length must be in-between. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when the length of is not with the specified . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustHaveLengthIn([NotNull, ValidatedNotNull] this string? parameter, Range range, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (!range.IsValueWithinRange(parameter.MustNotBeNull(parameterName, message).Length)) Throw.StringLengthNotInRange(parameter, range, parameterName, message); return parameter; } /// /// Ensures that the string's length is within the specified range, or otherwise throws your custom exception. /// /// The string to be checked. /// The range where the string's length must be in-between. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when is null or its length is not within the specified range. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustHaveLengthIn([NotNull, ValidatedNotNull] this string? parameter, Range range, Func, Exception> exceptionFactory) { if (parameter is null || !range.IsValueWithinRange(parameter.Length)) Throw.CustomException(exceptionFactory, parameter, range); return parameter; } /// /// Checks if the string is either "\n" or "\r\n". This is done independently of the current value of . /// /// The string to be checked. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("=> false, parameter:canbenull; => true, parameter:notnull")] public static bool IsNewLine([NotNullWhen(true)] this string? parameter) => parameter == "\n" || parameter == "\r\n"; /// /// Ensures that the string is either "\n" or "\r\n", or otherwise throws a . This is done independently of the current value of . /// /// The string to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is not equal to "\n" or "\r\n". /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeNewLine([NotNull, ValidatedNotNull] this string? parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (!parameter.MustNotBeNull(parameterName, message).IsNewLine()) Throw.NotNewLine(parameter, parameterName, message); return parameter; } /// /// Ensures that the string is either "\n" or "\r\n", or otherwise throws your custom exception. This is done independently of the current value of . /// /// The string to be checked. /// The delegate that creates your custom exception. is passed to this delegate. /// Your custom exception thrown when is not equal to "\n" or "\r\n". [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeNewLine([NotNull, ValidatedNotNull] this string? parameter, Func exceptionFactory) { if (!parameter.IsNewLine()) Throw.CustomException(exceptionFactory, parameter); return parameter; } /// /// Checks if the specified string is trimmed, i.e. it does not start or end with /// white space characters. Inputting an empty string will return true. When null is passed, /// you can control the return value with which will /// return true by default. /// /// The string to be checked. /// /// The value indicating whether true or false should be returned from this method when the /// is null. The default value is true. /// /// /// True if the is trimmed, else false. An empty string will result in true. /// You can control the return value with when the /// is null. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsTrimmed(this string? parameter, bool regardNullAsTrimmed = true) => parameter is null ? regardNullAsTrimmed : parameter.AsSpan().IsTrimmed(); /// /// Checks if the specified character span is trimmed, i.e. it does not start or end with /// white space characters. Inputting an empty span will return true. /// /// The character span to be checked. /// True if the is trimmed, else false. An empty span will result in true. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsTrimmed(this ReadOnlySpan parameter) => parameter.Length == 0 || !parameter[0].IsWhiteSpace() && !parameter[parameter.Length - 1].IsWhiteSpace(); /// /// Ensures that the string is not null and trimmed, or otherwise throws a . /// Empty strings are regarded as trimmed. /// /// The string to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// /// Thrown when is not trimmed, i.e. they start or end with white space characters. /// Empty strings are regarded as trimmed. /// /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeTrimmed([NotNull, ValidatedNotNull] this string? parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (!parameter.MustNotBeNull(parameterName, message).IsTrimmed()) Throw.NotTrimmed(parameter, parameterName, message); return parameter; } /// /// Ensures that the string is not null and trimmed, or otherwise throws your custom exception. /// Empty strings are regarded as trimmed. /// /// The string to be checked. /// The delegate that creates your custom exception. is passed to this delegate. /// Your custom exception thrown when is null or not trimmed. Empty strings are regarded as trimmed. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeTrimmed([NotNull, ValidatedNotNull] this string? parameter, Func exceptionFactory) { if (parameter is null || !parameter.AsSpan().IsTrimmed()) Throw.CustomException(exceptionFactory, parameter); return parameter; } /// /// Checks if the specified string is trimmed at the start, i.e. it does not start with /// white space characters. Inputting an empty string will return true. /// /// The string to be checked. /// /// The value indicating whether true or false should be returned from this method when the /// is null. The default value is true. /// /// /// True if the is trimmed at the start, else false. /// An empty string will result in true. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsTrimmedAtStart(this string? parameter, bool regardNullAsTrimmed = true) => parameter is null ? regardNullAsTrimmed : parameter.AsSpan().IsTrimmedAtStart(); /// /// Checks if the specified character span is trimmed at the start, i.e. it does not start with /// white space characters. Inputting an empty span will return true. /// /// The character span to be checked. /// /// True if the is trimmed at the start, else false. /// An empty span will result in true. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsTrimmedAtStart(this ReadOnlySpan parameter) => parameter.Length == 0 || !parameter[0].IsWhiteSpace(); /// /// Ensures that the string is not null and trimmed at the start, or otherwise throws a . /// Empty strings are regarded as trimmed. /// /// The string to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// /// Thrown when is not trimmed at the start, i.e. they start with white space characters. /// Empty strings are regarded as trimmed. /// /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeTrimmedAtStart([NotNull, ValidatedNotNull] this string? parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (!parameter.MustNotBeNull(parameterName, message).IsTrimmedAtStart()) Throw.NotTrimmedAtStart(parameter, parameterName, message); return parameter; } /// /// Ensures that the string is not null and trimmed at the start, or otherwise throws your custom exception. /// Empty strings are regarded as trimmed. /// /// The string to be checked. /// The delegate that creates your custom exception. is passed to this delegate. /// Your custom exception thrown when is null or not trimmed at the start. Empty strings are regarded as trimmed. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeTrimmedAtStart([NotNull, ValidatedNotNull] this string? parameter, Func exceptionFactory) { if (parameter is null || !parameter.AsSpan().IsTrimmedAtStart()) Throw.CustomException(exceptionFactory, parameter); return parameter; } /// /// Checks if the specified string is trimmed at the end, i.e. it does not end with /// white space characters. Inputting an empty string will return true. /// /// The string to be checked. /// /// The value indicating whether true or false should be returned from this method when the /// is null. The default value is true. /// /// /// True if the is trimmed at the start, else false. /// An empty string will result in true. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsTrimmedAtEnd(this string? parameter, bool regardNullAsTrimmed = true) => parameter is null ? regardNullAsTrimmed : parameter.AsSpan().IsTrimmedAtEnd(); /// /// Checks if the specified character span is trimmed at the end, i.e. it does not end with /// white space characters. Inputting an empty span will return true. /// /// The character span to be checked. /// /// True if the is trimmed at the end, else false. /// An empty span will result in true. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsTrimmedAtEnd(this ReadOnlySpan parameter) => parameter.Length == 0 || !parameter[parameter.Length - 1].IsWhiteSpace(); /// /// Ensures that the string is not null and trimmed at the end, or otherwise throws a . /// Empty strings are regarded as trimmed. /// /// The string to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// /// Thrown when is not trimmed at the end, i.e. they end with white space characters. /// Empty strings are regarded as trimmed. /// /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeTrimmedAtEnd([NotNull, ValidatedNotNull] this string? parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (!parameter.MustNotBeNull(parameterName, message).IsTrimmedAtEnd()) Throw.NotTrimmedAtEnd(parameter, parameterName, message); return parameter; } /// /// Ensures that the string is not null and trimmed at the end, or otherwise throws your custom exception. /// Empty strings are regarded as trimmed. /// /// The string to be checked. /// The delegate that creates your custom exception. is passed to this delegate. /// Your custom exception thrown when is null or not trimmed at the end. Empty strings are regarded as trimmed. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeTrimmedAtEnd([NotNull, ValidatedNotNull] this string? parameter, Func exceptionFactory) { if (parameter is null || !parameter.AsSpan().IsTrimmedAtEnd()) Throw.CustomException(exceptionFactory, parameter); return parameter; } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Check.TypeAssertions.cs000066400000000000000000000471341470750352700261060ustar00rootroot00000000000000using System; using System.Collections.Generic; using System.Runtime.CompilerServices; using JetBrains.Annotations; #if NET8_0 using System.Diagnostics.CodeAnalysis; #endif using NotNullAttribute = System.Diagnostics.CodeAnalysis.NotNullAttribute; namespace Light.GuardClauses; public static partial class Check { /// /// Checks if the two specified types are equivalent. This is true when both types are equal or /// when one type is a constructed generic type and the other type is the corresponding generic type definition. /// /// The first type to be checked. /// The other type to be checked. /// /// True if both types are null, or if both are equal, or if one type /// is a constructed generic type and the other one is the corresponding generic type definition, else false. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsEquivalentTypeTo(this Type? type, Type? other) => ReferenceEquals(type, other) || !(type is null) && !(other is null) && (type == other || type.IsConstructedGenericType != other.IsConstructedGenericType && CheckTypeEquivalency(type, other)); private static bool CheckTypeEquivalency(Type type, Type other) { if (type.IsConstructedGenericType) return type.GetGenericTypeDefinition() == other; return other.GetGenericTypeDefinition() == type; } /// /// Checks if the type implements the specified interface type. Internally, this method uses /// so that constructed generic types and their corresponding generic type definitions are regarded as equal. /// /// The type to be checked. /// The interface type that should implement. /// Thrown when or is null. [ContractAnnotation("type:null => halt; interfaceType:null => halt")] public static bool Implements( #if NET8_0 [DynamicallyAccessedMembers(DynamicallyAccessedMemberTypes.Interfaces)] #endif // ReSharper disable RedundantNullableFlowAttribute -- NotNull has an effect, see Issue72NotNullAttributeTests [NotNull, ValidatedNotNull] this Type type, [NotNull, ValidatedNotNull] Type interfaceType // ReSharper restore RedundantNullableFlowAttribute ) { type.MustNotBeNull(); interfaceType.MustNotBeNull(); var implementedInterfaces = type.GetInterfaces(); for (var i = 0; i < implementedInterfaces.Length; ++i) { if (interfaceType.IsEquivalentTypeTo(implementedInterfaces[i])) return true; } return false; } /// /// Checks if the type implements the specified interface type. This overload uses the specified /// to compare the interface types. /// /// The type to be checked. /// The interface type that should implement. /// The equality comparer used to compare the interface types. /// Thrown when , or , or is null. [ContractAnnotation("type:null => halt; interfaceType:null => halt; typeComparer:null => halt")] public static bool Implements( #if NET8_0 [DynamicallyAccessedMembers(DynamicallyAccessedMemberTypes.Interfaces)] #endif // ReSharper disable RedundantNullableFlowAttribute -- NotNull has an effect, see Issue72NotNullAttributeTests [NotNull, ValidatedNotNull] this Type type, [NotNull, ValidatedNotNull] Type interfaceType, [NotNull, ValidatedNotNull] IEqualityComparer typeComparer // ReSharper restore RedundantNullableFlowAttribute ) { type.MustNotBeNull(); interfaceType.MustNotBeNull(); typeComparer.MustNotBeNull(); var implementedInterfaces = type.GetInterfaces(); for (var i = 0; i < implementedInterfaces.Length; ++i) { if (typeComparer.Equals(implementedInterfaces[i], interfaceType)) return true; } return false; } /// /// Checks if the given is equal to the specified or if it implements it. Internally, this /// method uses so that constructed generic types and their corresponding generic type definitions are regarded as equal. /// /// The type to be checked. /// The type that is equivalent to or the interface type that implements. /// Thrown when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("type:null => halt; otherType:null => halt")] public static bool IsOrImplements( #if NET8_0 [DynamicallyAccessedMembers(DynamicallyAccessedMemberTypes.Interfaces)] #endif // ReSharper disable RedundantNullableFlowAttribute -- NotNull has an effect, see Issue72NotNullAttributeTests [NotNull, ValidatedNotNull] this Type type, [NotNull, ValidatedNotNull] Type otherType) => // ReSharper restore RedundantNullableFlowAttribute type.IsEquivalentTypeTo(otherType.MustNotBeNull(nameof(otherType))) || type.Implements(otherType); /// /// Checks if the given is equal to the specified or if it implements it. This overload uses the specified /// to compare the types. /// /// , /// The type to be checked. /// The type that is equivalent to or the interface type that implements. /// The equality comparer used to compare the interface types. /// Thrown when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("type:null => halt; otherType:null => halt")] public static bool IsOrImplements( #if NET8_0 [DynamicallyAccessedMembers(DynamicallyAccessedMemberTypes.Interfaces)] #endif // ReSharper disable RedundantNullableFlowAttribute -- NotNull has an effect, see Issue72NotNullAttributeTests [NotNull, ValidatedNotNull] this Type type, [NotNull, ValidatedNotNull] Type otherType, [NotNull, ValidatedNotNull] IEqualityComparer typeComparer) => // ReSharper restore RedundantNullableFlowAttribute typeComparer.MustNotBeNull(nameof(typeComparer)).Equals(type.MustNotBeNull(nameof(type)), otherType.MustNotBeNull(nameof(otherType))) || type.Implements(otherType, typeComparer); /// /// Checks if the specified type derives from the other type. Internally, this method uses /// by default so that constructed generic types and their corresponding generic type definitions are regarded as equal. /// /// The type info to be checked. /// The base class that should derive from. /// Thrown when or is null. [ContractAnnotation("type:null => halt; baseClass:null => halt")] // ReSharper disable RedundantNullableFlowAttribute -- NotNull has an effect, see Issue72NotNullAttributeTests public static bool DerivesFrom([NotNull, ValidatedNotNull] this Type type, [NotNull, ValidatedNotNull] Type baseClass) // ReSharper restore RedundantNullableFlowAttribute { baseClass.MustNotBeNull(nameof(baseClass)); var currentBaseType = type.MustNotBeNull(nameof(type)).BaseType; while (currentBaseType != null) { if (currentBaseType.IsEquivalentTypeTo(baseClass)) return true; currentBaseType = currentBaseType.BaseType; } return false; } /// /// Checks if the specified type derives from the other type. This overload uses the specified /// to compare the types. /// /// The type info to be checked. /// The base class that should derive from. /// The equality comparer used to compare the types. /// Thrown when , or , or is null. [ContractAnnotation("type:null => halt; baseClass:null => halt; typeComparer:null => halt")] // ReSharper disable RedundantNullableFlowAttribute -- NotNull has an effect, see Issue72NotNullAttributeTests public static bool DerivesFrom([NotNull, ValidatedNotNull] this Type type, [NotNull, ValidatedNotNull] Type baseClass, [NotNull, ValidatedNotNull] IEqualityComparer typeComparer) // ReSharper restore RedundantNullableFlowAttribute { baseClass.MustNotBeNull(nameof(baseClass)); typeComparer.MustNotBeNull(nameof(typeComparer)); var currentBaseType = type.MustNotBeNull(nameof(type)).BaseType; while (currentBaseType != null) { if (typeComparer.Equals(currentBaseType, baseClass)) return true; currentBaseType = currentBaseType.BaseType; } return false; } /// /// Checks if the given is equal to the specified or if it derives from it. Internally, this /// method uses so that constructed generic types and their corresponding generic type definitions are regarded as equal. /// /// The type to be checked. /// The type that is equivalent to or the base class type where derives from. /// Thrown when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("type:null => halt; otherType:null => halt")] // ReSharper disable RedundantNullableFlowAttribute -- NotNull has an effect, see Issue72NotNullAttributeTests public static bool IsOrDerivesFrom([NotNull, ValidatedNotNull] this Type type, [NotNull, ValidatedNotNull] Type otherType) => // ReSharper restore RedundantNullableFlowAttribute type.IsEquivalentTypeTo(otherType.MustNotBeNull(nameof(otherType))) || type.DerivesFrom(otherType); /// /// Checks if the given is equal to the specified or if it derives from it. This overload uses the specified /// to compare the types. /// /// The type to be checked. /// The type that is equivalent to or the base class type where derives from. /// The equality comparer used to compare the types. /// Thrown when , or , or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("type:null => halt; otherType:null => halt; typeComparer:null => halt")] // ReSharper disable RedundantNullableFlowAttribute -- NotNull has an effect, see Issue72NotNullAttributeTests public static bool IsOrDerivesFrom([NotNull, ValidatedNotNull] this Type type, [NotNull, ValidatedNotNull] Type otherType, [NotNull, ValidatedNotNull] IEqualityComparer typeComparer) => // ReSharper restore RedundantNullableFlowAttribute typeComparer.MustNotBeNull(nameof(typeComparer)).Equals(type, otherType.MustNotBeNull(nameof(otherType))) || type.DerivesFrom(otherType, typeComparer); /// /// Checks if the given type derives from the specified base class or interface type. Internally, this method uses /// so that constructed generic types and their corresponding generic type definitions are regarded as equal. /// /// The type to be checked. /// The type describing an interface or base class that should derive from or implement. /// Thrown when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("type:null => halt; baseClassOrInterfaceType:null => halt")] public static bool InheritsFrom( #if NET8_0 [DynamicallyAccessedMembers(DynamicallyAccessedMemberTypes.Interfaces)] #endif // ReSharper disable RedundantNullableFlowAttribute -- NotNull has an effect, see Issue72NotNullAttributeTests [NotNull, ValidatedNotNull] this Type type, [NotNull, ValidatedNotNull] Type baseClassOrInterfaceType) => // ReSharper restore RedundantNullableFlowAttribute baseClassOrInterfaceType.MustNotBeNull(nameof(baseClassOrInterfaceType)) .IsInterface ? type.Implements(baseClassOrInterfaceType) : type.DerivesFrom(baseClassOrInterfaceType); /// /// Checks if the given type derives from the specified base class or interface type. This overload uses the specified /// to compare the types. /// /// The type to be checked. /// The type describing an interface or base class that should derive from or implement. /// The equality comparer used to compare the types. /// Thrown when , or , or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("type:null => halt; baseClassOrInterfaceType:null => halt; typeComparer:null => halt")] public static bool InheritsFrom( #if NET8_0 [DynamicallyAccessedMembers(DynamicallyAccessedMemberTypes.Interfaces)] #endif // ReSharper disable RedundantNullableFlowAttribute -- NotNull has an effect, see Issue72NotNullAttributeTests [NotNull, ValidatedNotNull] this Type type, [NotNull, ValidatedNotNull] Type baseClassOrInterfaceType, [NotNull, ValidatedNotNull] IEqualityComparer typeComparer) => // ReSharper restore RedundantNullableFlowAttribute baseClassOrInterfaceType.MustNotBeNull(nameof(baseClassOrInterfaceType)) .IsInterface ? type.Implements(baseClassOrInterfaceType, typeComparer) : type.DerivesFrom(baseClassOrInterfaceType, typeComparer); /// /// Checks if the given is equal to the specified or if it derives from it or implements it. /// Internally, this method uses so that constructed generic types and their corresponding generic type definitions /// are regarded as equal. /// /// The type to be checked. /// The type that is equivalent to or the base class type where derives from. /// Thrown when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("type:null => halt; otherType:null => halt")] public static bool IsOrInheritsFrom( #if NET8_0 [DynamicallyAccessedMembers(DynamicallyAccessedMemberTypes.Interfaces)] #endif // ReSharper disable RedundantNullableFlowAttribute -- NotNull has an effect, see Issue72NotNullAttributeTests [NotNull, ValidatedNotNull] this Type type, [NotNull, ValidatedNotNull] Type otherType) => // ReSharper restore RedundantNullableFlowAttribute type.IsEquivalentTypeTo(otherType.MustNotBeNull(nameof(otherType))) || type.InheritsFrom(otherType); /// /// Checks if the given is equal to the specified or if it derives from it or implements it. /// This overload uses the specified to compare the types. /// /// The type to be checked. /// The type that is equivalent to or the base class type where derives from. /// The equality comparer used to compare the types. /// Thrown when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("type:null => halt; otherType:null => halt; typeComparer:null => halt")] public static bool IsOrInheritsFrom( #if NET8_0 [DynamicallyAccessedMembers(DynamicallyAccessedMemberTypes.Interfaces)] #endif // ReSharper disable RedundantNullableFlowAttribute -- NotNull has an effect, see Issue72NotNullAttributeTests [NotNull, ValidatedNotNull] this Type type, [NotNull, ValidatedNotNull] Type otherType, [NotNull, ValidatedNotNull] IEqualityComparer typeComparer) => // ReSharper restore RedundantNullableFlowAttribute typeComparer.MustNotBeNull(nameof(typeComparer)).Equals(type, otherType.MustNotBeNull(nameof(otherType))) || type.InheritsFrom(otherType, typeComparer); /// /// Checks if the given is a generic type that has open generic parameters, /// but is no generic type definition. /// /// The type to be checked. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("type:null => halt")] // ReSharper disable once RedundantNullableFlowAttribute -- NotNull has an effect, see Issue72NotNullAttributeTests public static bool IsOpenConstructedGenericType([NotNull, ValidatedNotNull] this Type type) => type.MustNotBeNull(nameof(type)).IsGenericType && type.ContainsGenericParameters && type.IsGenericTypeDefinition == false; }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Check.UriAssertions.cs000066400000000000000000000455531470750352700257270ustar00rootroot00000000000000using System; using System.Collections.Generic; using System.Linq; using JetBrains.Annotations; using Light.GuardClauses.Exceptions; using System.Runtime.CompilerServices; using NotNullAttribute = System.Diagnostics.CodeAnalysis.NotNullAttribute; namespace Light.GuardClauses; public static partial class Check { /// /// Ensures that the specified URI is an absolute one, or otherwise throws a . /// /// The URI to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is not an absolute URI. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static Uri MustBeAbsoluteUri([NotNull, ValidatedNotNull] this Uri? parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.MustNotBeNull(parameterName, message).IsAbsoluteUri == false) Throw.MustBeAbsoluteUri(parameter, parameterName, message); return parameter; } /// /// Ensures that the specified URI is an absolute one, or otherwise throws your custom exception. /// /// The URI to be checked. /// The delegate that creates the exception to be thrown. is passed to this delegate. /// Your custom exception thrown when is not an absolute URI, or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static Uri MustBeAbsoluteUri([NotNull, ValidatedNotNull] this Uri? parameter, Func exceptionFactory) { if (parameter is null || parameter.IsAbsoluteUri == false) Throw.CustomException(exceptionFactory, parameter); return parameter; } /// /// Ensures that the specified URI is a relative one, or otherwise throws an . /// /// The URI to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is an absolute URI. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static Uri MustBeRelativeUri([NotNull, ValidatedNotNull] this Uri? parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.MustNotBeNull(parameterName, message).IsAbsoluteUri) Throw.MustBeRelativeUri(parameter, parameterName, message); return parameter; } /// /// Ensures that the specified URI is a relative one, or otherwise throws your custom exception. /// /// The URI to be checked. /// The delegate that creates your custom exception. is passed to this delegate. /// Your custom exception thrown when is an absolute URI, or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static Uri MustBeRelativeUri([NotNull, ValidatedNotNull] this Uri? parameter, Func exceptionFactory) { if (parameter is null || parameter.IsAbsoluteUri) Throw.CustomException(exceptionFactory, parameter); return parameter; } /// /// Ensures that the has the specified scheme, or otherwise throws an . /// /// The URI to be checked. /// The scheme that the URI should have. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when uses a different scheme than the specified one. /// Thrown when is relative and thus has no scheme. /// Throw when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static Uri MustHaveScheme([NotNull, ValidatedNotNull] this Uri? parameter, string scheme, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (string.Equals(parameter.MustBeAbsoluteUri(parameterName, message).Scheme, scheme) == false) Throw.UriMustHaveScheme(parameter, scheme, parameterName, message); return parameter; } /// /// Ensures that the has the specified scheme, or otherwise throws your custom exception. /// /// The URI to be checked. /// The scheme that the URI should have. /// The delegate that creates the exception to be thrown. is passed to this delegate. /// /// Your custom exception thrown when uses a different scheme than the specified one, /// or when is a relative URI, /// or when is null. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static Uri MustHaveScheme([NotNull, ValidatedNotNull] this Uri? parameter, string scheme, Func exceptionFactory) { if (string.Equals(parameter.MustBeAbsoluteUri(exceptionFactory).Scheme, scheme) == false) Throw.CustomException(exceptionFactory, parameter); return parameter; } /// /// Ensures that the has the specified scheme, or otherwise throws your custom exception. /// /// The URI to be checked. /// The scheme that the URI should have. /// The delegate that creates the exception to be thrown. and are passed to this delegate. /// /// Your custom exception thrown when uses a different scheme than the specified one, /// or when is a relative URI, /// or when is null. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static Uri MustHaveScheme([NotNull, ValidatedNotNull] this Uri? parameter, string scheme, Func exceptionFactory) { if (parameter is null || !parameter.IsAbsoluteUri || parameter.Scheme.Equals(scheme) == false) Throw.CustomException(exceptionFactory, parameter, scheme); return parameter; } /// /// Ensures that the specified URI has the "https" scheme, or otherwise throws an . /// /// The URI to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when uses a different scheme than "https". /// Thrown when is relative and thus has no scheme. /// Throw when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static Uri MustBeHttpsUrl([NotNull, ValidatedNotNull] this Uri? parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => parameter.MustHaveScheme("https", parameterName, message); /// /// Ensures that the specified URI has the "https" scheme, or otherwise throws your custom exception. /// /// The URI to be checked. /// The delegate that creates the exception to be thrown. is passed to this delegate. /// /// Your custom exception thrown when uses a different scheme than "https", /// or when is a relative URI, /// or when is null. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static Uri MustBeHttpsUrl([NotNull, ValidatedNotNull] this Uri? parameter, Func exceptionFactory) => parameter.MustHaveScheme("https", exceptionFactory); /// /// Ensures that the specified URI has the "http" scheme, or otherwise throws an . /// /// The URI to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when uses a different scheme than "http". /// Thrown when is relative and thus has no scheme. /// Throw when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static Uri MustBeHttpUrl([NotNull, ValidatedNotNull] this Uri? parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => parameter.MustHaveScheme("http", parameterName, message); /// /// Ensures that the specified URI has the "http" scheme, or otherwise throws your custom exception. /// /// The URI to be checked. /// The delegate that creates the exception to be thrown. is passed to this delegate. /// /// Your custom exception thrown when uses a different scheme than "http", /// or when is a relative URI, /// or when is null. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static Uri MustBeHttpUrl([NotNull, ValidatedNotNull] this Uri? parameter, Func exceptionFactory) => parameter.MustHaveScheme("http", exceptionFactory); /// /// Ensures that the specified URI has the "http" or "https" scheme, or otherwise throws an . /// /// The URI to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when uses a different scheme than "http" or "https". /// Thrown when is relative and thus has no scheme. /// Throw when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static Uri MustBeHttpOrHttpsUrl([NotNull, ValidatedNotNull] this Uri? parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.MustBeAbsoluteUri(parameterName, message).Scheme.Equals("https") == false && parameter.Scheme.Equals("http") == false) Throw.UriMustHaveOneSchemeOf(parameter, new[] { "https", "http" }, parameterName, message); return parameter; } /// /// Ensures that the specified URI has the "http" or "https" scheme, or otherwise throws your custom exception. /// /// The URI to be checked. /// The delegate that creates the exception to be thrown. is passed to this delegate. /// /// Your custom exception thrown when uses a different scheme than "http" or "https", /// or when is a relative URI, /// or when is null. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static Uri MustBeHttpOrHttpsUrl([NotNull, ValidatedNotNull] this Uri? parameter, Func exceptionFactory) { if (parameter.MustBeAbsoluteUri(exceptionFactory).Scheme.Equals("https") == false && parameter.Scheme.Equals("http") == false) Throw.CustomException(exceptionFactory, parameter); return parameter; } /// /// Ensures that the URI has one of the specified schemes, or otherwise throws an . /// /// The URI to be checked. /// One of these strings must be equal to the scheme of the URI. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when the scheme is not equal to one of the specified schemes. /// Thrown when is relative and thus has no scheme. /// Throw when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; schemes:null => halt")] public static Uri MustHaveOneSchemeOf([NotNull, ValidatedNotNull] this Uri? parameter, IEnumerable schemes, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { // ReSharper disable PossibleMultipleEnumeration parameter.MustBeAbsoluteUri(parameterName, message); if (schemes is ICollection collection) { if (!collection.Contains(parameter.Scheme)) Throw.UriMustHaveOneSchemeOf(parameter, schemes, parameterName, message); return parameter; } if (!schemes.MustNotBeNull(nameof(schemes), message).Contains(parameter.Scheme)) Throw.UriMustHaveOneSchemeOf(parameter, schemes, parameterName, message); return parameter; // ReSharper restore PossibleMultipleEnumeration } /// /// Ensures that the URI has one of the specified schemes, or otherwise throws your custom exception. /// /// The URI to be checked. /// One of these strings must be equal to the scheme of the URI. /// The delegate that creates your custom exception. /// /// Your custom exception thrown when the scheme is not equal to one of the specified schemes, /// or when is a relative URI, /// or when is null. /// /// Throw when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static Uri MustHaveOneSchemeOf([NotNull, ValidatedNotNull] this Uri? parameter, TCollection schemes, Func exceptionFactory) where TCollection : class, IEnumerable { if (parameter is null || !parameter.IsAbsoluteUri) Throw.CustomException(exceptionFactory, parameter, schemes); if (schemes is ICollection collection) { if (!collection.Contains(parameter.Scheme)) Throw.CustomException(exceptionFactory, parameter, schemes); return parameter; } // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (schemes is null || !schemes.Contains(parameter.Scheme)) Throw.CustomException(exceptionFactory, parameter, schemes!); return parameter; } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/CreateSignedNuGetPackage.cmd000066400000000000000000000002401470750352700267730ustar00rootroot00000000000000dotnet pack Light.GuardClauses.csproj -c Release /p:SignAssembly=true /p:AssemblyOriginatorKeyFile=bin/Light.GuardClauses.snk /p:ContinuousIntegrationBuild=trueLight.GuardClauses-12.0.0/Code/Light.GuardClauses/EnumInfo.cs000066400000000000000000000070651470750352700236150ustar00rootroot00000000000000using System; using System.Collections.Generic; using System.Reflection; using System.Runtime.CompilerServices; namespace Light.GuardClauses; /// /// Provides meta-information about enum values and the flag bitmask if the enum is marked with the . /// Can be used to validate that an enum value is valid. /// /// The type of the enum. public static class EnumInfo where T : struct, Enum { // ReSharper disable StaticMemberInGenericType /// /// Gets the value indicating whether the enum type is marked with the flags attribute. /// public static readonly bool IsFlagsEnum = typeof(T).GetCustomAttribute(Types.FlagsAttributeType) != null; /// /// Gets the flags pattern when is true. If the enum is not a flags enum, then 0UL is returned. /// public static readonly ulong FlagsPattern; private static readonly int EnumSize = Unsafe.SizeOf(); private static readonly T[] EnumConstantsArray; /// /// Gets the values of the enum as a read-only collection. /// public static ReadOnlyMemory EnumConstants { get; } static EnumInfo() { #if NET8_0 EnumConstantsArray = Enum.GetValues(); #else EnumConstantsArray = (T[]) Enum.GetValues(typeof(T)); #endif EnumConstants = new (EnumConstantsArray); if (!IsFlagsEnum) return; for (var i = 0; i < EnumConstantsArray.Length; ++i) { var convertedValue = ConvertToUInt64(EnumConstantsArray[i]); FlagsPattern |= convertedValue; } } [MethodImpl(MethodImplOptions.AggressiveInlining)] private static bool IsValidFlagsValue(T enumValue) { var convertedValue = ConvertToUInt64(enumValue); return (FlagsPattern & convertedValue) == convertedValue; } private static bool IsValidValue(T parameter) { var comparer = EqualityComparer.Default; for (var i = 0; i < EnumConstantsArray.Length; ++i) if (comparer.Equals(EnumConstantsArray[i], parameter)) return true; return false; } /// /// Checks if the specified enum value is valid. This is true if either the enum is a standard enum and the enum value corresponds /// to one of the enum constant values or if the enum type is marked with the and the given value /// is a valid combination of bits for this type. /// /// The enum value to be checked. /// True if either the enum value is [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsValidEnumValue(T enumValue) => IsFlagsEnum ? IsValidFlagsValue(enumValue) : IsValidValue(enumValue); private static ulong ConvertToUInt64(T value) { switch (EnumSize) { case 1: return Unsafe.As(ref value); case 2: return Unsafe.As(ref value); case 4: return Unsafe.As(ref value); case 8: return Unsafe.As(ref value); default: ThrowUnknownEnumSize(); return default; } } private static void ThrowUnknownEnumSize() { throw new InvalidOperationException($"The enum type \"{typeof(T)}\" has an unknown size of {EnumSize}. This means that the underlying enum type is not one of the supported ones."); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/EquivalentTypeComparer.cs000066400000000000000000000037711470750352700265450ustar00rootroot00000000000000using System; using System.Collections.Generic; using System.Runtime.CompilerServices; namespace Light.GuardClauses; /// /// Represents an that uses /// to compare types. This check works like the normal type equality comparison, but when two /// generic types are compared, they are regarded as equal when one of them is a constructed generic type /// and the other one is the corresponding generic type definition. /// public sealed class EquivalentTypeComparer : IEqualityComparer { /// /// Gets a singleton instance of the equality comparer. /// public static readonly EquivalentTypeComparer Instance = new EquivalentTypeComparer(); /// /// Checks if the two types are equivalent (using ). /// This check works like the normal type equality comparison, but when two /// generic types are compared, they are regarded as equal when one of them is a constructed generic type /// and the other one is the corresponding generic type definition. /// /// The first type. /// The second type. [MethodImpl(MethodImplOptions.AggressiveInlining)] public bool Equals(Type? x, Type? y) => x.IsEquivalentTypeTo(y); /// /// Returns the hash code of the given type. When the specified type is a constructed generic type, /// the hash code of the generic type definition is returned instead. /// /// The type whose hash code is requested. [MethodImpl(MethodImplOptions.AggressiveInlining)] public int GetHashCode(Type type) => // ReSharper disable once ConditionIsAlwaysTrueOrFalse type is null ? 0 : type.IsConstructedGenericType ? type.GetGenericTypeDefinition().GetHashCode() : type.GetHashCode(); }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Exceptions/000077500000000000000000000000001470750352700236575ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Exceptions/AbsoluteUriException.cs000066400000000000000000000014521470750352700303250ustar00rootroot00000000000000using System; using System.Runtime.Serialization; namespace Light.GuardClauses.Exceptions; /// /// This exception indicates that an URI is absolute instead of relative. /// [Serializable] public class AbsoluteUriException : UriException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public AbsoluteUriException(string? parameterName = null, string? message = null) : base(parameterName, message) { } #if !NET8_0 /// protected AbsoluteUriException(SerializationInfo info, StreamingContext context) : base(info, context) { } #endif }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Exceptions/ArgumentDefaultException.cs000066400000000000000000000015051470750352700311550ustar00rootroot00000000000000using System; using System.Runtime.Serialization; namespace Light.GuardClauses.Exceptions; /// /// This exception indicates that a value of a value type is the default value. /// [Serializable] public class ArgumentDefaultException : ArgumentException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public ArgumentDefaultException(string? parameterName = null, string? message = null) : base(message, parameterName) { } #if !NET8_0 /// protected ArgumentDefaultException(SerializationInfo info, StreamingContext context) : base(info, context) { } #endif }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Exceptions/CollectionException.cs000066400000000000000000000014511470750352700301610ustar00rootroot00000000000000using System; using System.Runtime.Serialization; namespace Light.GuardClauses.Exceptions; /// /// This exception indicates that the state of a collection is invalid. /// [Serializable] public class CollectionException : ArgumentException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public CollectionException(string? parameterName = null, string? message = null) : base(message, parameterName) { } #if !NET8_0 /// protected CollectionException(SerializationInfo info, StreamingContext context) : base(info, context) { } #endif }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Exceptions/EmptyCollectionException.cs000066400000000000000000000015001470750352700311730ustar00rootroot00000000000000using System; using System.Runtime.Serialization; namespace Light.GuardClauses.Exceptions; /// /// This exception indicates that a collection has no items. /// [Serializable] public class EmptyCollectionException : InvalidCollectionCountException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public EmptyCollectionException(string? parameterName = null, string? message = null) : base(parameterName, message) { } #if !NET8_0 /// protected EmptyCollectionException(SerializationInfo info, StreamingContext context) : base(info, context) { } #endif }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Exceptions/EmptyGuidException.cs000066400000000000000000000014251470750352700277760ustar00rootroot00000000000000using System; using System.Runtime.Serialization; namespace Light.GuardClauses.Exceptions; /// /// This exception indicates that that a GUID is empty. /// [Serializable] public class EmptyGuidException : ArgumentException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public EmptyGuidException(string? parameterName = null, string? message = null) : base(message, parameterName) { } #if !NET8_0 /// protected EmptyGuidException(SerializationInfo info, StreamingContext context) : base(info, context) { } #endif }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Exceptions/EmptyStringException.cs000066400000000000000000000014301470750352700303500ustar00rootroot00000000000000using System; using System.Runtime.Serialization; namespace Light.GuardClauses.Exceptions; /// /// This exception indicates that a string is empty. /// [Serializable] public class EmptyStringException : StringException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public EmptyStringException(string? parameterName = null, string? message = null) : base(parameterName, message) { } #if !NET8_0 /// protected EmptyStringException(SerializationInfo info, StreamingContext context) : base(info, context) { } #endif }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Exceptions/EnumValueNotDefinedException.cs000066400000000000000000000015101470750352700317230ustar00rootroot00000000000000using System; using System.Runtime.Serialization; namespace Light.GuardClauses.Exceptions; /// /// This exception indicates that a value is not defined in the corresponding enum type. /// [Serializable] public class EnumValueNotDefinedException : ArgumentException { /// /// Creates a new instance of . /// /// The name of the parameter. /// The message of the exception. public EnumValueNotDefinedException(string? parameterName = null, string? message = null) : base(message, parameterName) { } #if !NET8_0 /// protected EnumValueNotDefinedException(SerializationInfo info, StreamingContext context) : base(info, context) { } #endif }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Exceptions/ExistingItemException.cs000066400000000000000000000015101470750352700304730ustar00rootroot00000000000000using System; using System.Runtime.Serialization; namespace Light.GuardClauses.Exceptions; /// /// This exception indicates that a collection contains an item that must not be part of it. /// [Serializable] public class ExistingItemException : CollectionException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public ExistingItemException(string? parameterName = null, string? message = null) : base(parameterName, message) { } #if !NET8_0 /// protected ExistingItemException(SerializationInfo info, StreamingContext context) : base(info, context) { } #endif }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Exceptions/InvalidCollectionCountException.cs000066400000000000000000000015421470750352700325020ustar00rootroot00000000000000using System; using System.Runtime.Serialization; namespace Light.GuardClauses.Exceptions; /// /// This exception indicates that a collection has an invalid number of items. /// [Serializable] public class InvalidCollectionCountException : CollectionException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public InvalidCollectionCountException(string? parameterName = null, string? message = null) : base(parameterName, message) { } #if !NET8_0 /// protected InvalidCollectionCountException(SerializationInfo info, StreamingContext context) : base(info, context) { } #endif }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Exceptions/InvalidConfigurationException.cs000066400000000000000000000015351470750352700322070ustar00rootroot00000000000000using System; using System.Runtime.Serialization; namespace Light.GuardClauses.Exceptions; /// /// This exception indicates that configuration data is invalid. /// [Serializable] public class InvalidConfigurationException : Exception { /// /// Initializes a new instance of . /// /// The message of the exception (optional). /// The exception that is the cause of this one (optional). public InvalidConfigurationException(string? message = null, Exception? innerException = null) : base(message, innerException) { } #if !NET8_0 /// protected InvalidConfigurationException(SerializationInfo info, StreamingContext context) : base(info, context) { } #endif }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Exceptions/InvalidDateTimeException.cs000066400000000000000000000015031470750352700310670ustar00rootroot00000000000000using System; using System.Runtime.Serialization; namespace Light.GuardClauses.Exceptions; /// /// This exception indicates that a value is invalid. /// [Serializable] public class InvalidDateTimeException : ArgumentException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public InvalidDateTimeException(string? parameterName = null, string? message = null) : base(message, parameterName) { } #if !NET8_0 /// protected InvalidDateTimeException(SerializationInfo info, StreamingContext context) : base(info, context) { } #endif }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Exceptions/InvalidEmailAddressException.cs000066400000000000000000000014771470750352700317420ustar00rootroot00000000000000using System; using System.Runtime.Serialization; namespace Light.GuardClauses.Exceptions; /// /// This exception indicates that an Email address is invalid. /// [Serializable] public class InvalidEmailAddressException : StringException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public InvalidEmailAddressException(string? parameterName = null, string? message = null) : base(parameterName, message) { } #if !NET8_0 /// protected InvalidEmailAddressException(SerializationInfo info, StreamingContext context) : base(info, context) { } #endif }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Exceptions/InvalidStateException.cs000066400000000000000000000014711470750352700304570ustar00rootroot00000000000000using System; using System.Runtime.Serialization; namespace Light.GuardClauses.Exceptions; /// /// This exception indicates that the data is in invalid state. /// [Serializable] public class InvalidStateException : Exception { /// /// Creates a new instance of . /// /// The message of the exception (optional). /// The exception that is the cause of this one (optional). public InvalidStateException(string? message = null, Exception? innerException = null) : base(message, innerException) { } #if !NET8_0 /// protected InvalidStateException(SerializationInfo info, StreamingContext context) : base(info, context) { } #endif }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Exceptions/InvalidUriSchemeException.cs000066400000000000000000000014641470750352700312650ustar00rootroot00000000000000using System; using System.Runtime.Serialization; namespace Light.GuardClauses.Exceptions; /// /// This exception indicates that an URI has an invalid scheme. /// [Serializable] public class InvalidUriSchemeException : UriException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public InvalidUriSchemeException(string? parameterName = null, string? message = null) : base(parameterName, message) { } #if !NET8_0 /// protected InvalidUriSchemeException(SerializationInfo info, StreamingContext context) : base(info, context) { } #endif }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Exceptions/MissingItemException.cs000066400000000000000000000014611470750352700303170ustar00rootroot00000000000000using System; using System.Runtime.Serialization; namespace Light.GuardClauses.Exceptions; /// /// This exception indicates that an item is not present in a collection. /// [Serializable] public class MissingItemException : CollectionException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public MissingItemException(string? parameterName = null, string? message = null) : base(parameterName, message) { } #if !NET8_0 /// protected MissingItemException(SerializationInfo info, StreamingContext context) : base(info, context) { } #endif }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Exceptions/NullableHasNoValueException.cs000066400000000000000000000015161470750352700315540ustar00rootroot00000000000000using System; using System.Runtime.Serialization; namespace Light.GuardClauses.Exceptions; /// /// This exception indicates that a has no value. /// [Serializable] public class NullableHasNoValueException : ArgumentException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public NullableHasNoValueException(string? parameterName = null, string? message = null) : base(message, parameterName) { } #if !NET8_0 /// protected NullableHasNoValueException(SerializationInfo info, StreamingContext context) : base(info, context) { } #endif }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Exceptions/RelativeUriException.cs000066400000000000000000000014521470750352700303220ustar00rootroot00000000000000using System; using System.Runtime.Serialization; namespace Light.GuardClauses.Exceptions; /// /// This exception indicates that an URI is relative instead of absolute. /// [Serializable] public class RelativeUriException : UriException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public RelativeUriException(string? parameterName = null, string? message = null) : base(parameterName, message) { } #if !NET8_0 /// protected RelativeUriException(SerializationInfo info, StreamingContext context) : base(info, context) { } #endif }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Exceptions/SameObjectReferenceException.cs000066400000000000000000000015201470750352700317160ustar00rootroot00000000000000using System; using System.Runtime.Serialization; namespace Light.GuardClauses.Exceptions; /// /// This exception indicates that two references point to the same object. /// [Serializable] public class SameObjectReferenceException : ArgumentException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public SameObjectReferenceException(string? parameterName = null, string? message = null) : base(message, parameterName) { } #if !NET8_0 /// protected SameObjectReferenceException(SerializationInfo info, StreamingContext context) : base(info, context) { } #endif }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Exceptions/StringDoesNotMatchException.cs000066400000000000000000000015201470750352700316020ustar00rootroot00000000000000using System; using System.Runtime.Serialization; namespace Light.GuardClauses.Exceptions; /// /// This exception indicates that a string is not matching a regular expression. /// [Serializable] public class StringDoesNotMatchException : StringException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public StringDoesNotMatchException(string? parameterName = null, string? message = null) : base(parameterName, message) { } #if !NET8_0 /// protected StringDoesNotMatchException(SerializationInfo info, StreamingContext context) : base(info, context) { } #endif }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Exceptions/StringException.cs000066400000000000000000000014241470750352700273340ustar00rootroot00000000000000using System; using System.Runtime.Serialization; namespace Light.GuardClauses.Exceptions; /// /// This exception indicates that a string is in an invalid state. /// [Serializable] public class StringException : ArgumentException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public StringException(string? parameterName = null, string? message = null) : base(message, parameterName) { } #if !NET8_0 /// protected StringException(SerializationInfo info, StreamingContext context) : base(info, context) { } #endif }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Exceptions/StringLengthException.cs000066400000000000000000000014511470750352700304760ustar00rootroot00000000000000using System; using System.Runtime.Serialization; namespace Light.GuardClauses.Exceptions; /// /// This exception indicates that a string has an invalid length. /// [Serializable] public class StringLengthException : StringException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public StringLengthException(string? parameterName = null, string? message = null) : base(parameterName, message) { } #if !NET8_0 /// protected StringLengthException(SerializationInfo info, StreamingContext context) : base(info, context) { } #endif }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Exceptions/SubstringException.cs000066400000000000000000000014361470750352700300510ustar00rootroot00000000000000using System; using System.Runtime.Serialization; namespace Light.GuardClauses.Exceptions; /// /// This exception indicates that a string is in an invalid state. /// [Serializable] public class SubstringException : StringException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public SubstringException(string? parameterName = null, string? message = null) : base(parameterName, message) { } #if !NET8_0 /// protected SubstringException(SerializationInfo info, StreamingContext context) : base(info, context) { } #endif }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Exceptions/Throw.cs000066400000000000000000001376701470750352700253270ustar00rootroot00000000000000using System; using System.Collections; using System.Collections.Generic; using System.Diagnostics.CodeAnalysis; using System.Runtime.CompilerServices; using System.Text; using System.Text.RegularExpressions; using JetBrains.Annotations; using Light.GuardClauses.FrameworkExtensions; namespace Light.GuardClauses.Exceptions; /// /// Provides static factory methods that throw default exceptions. /// public static class Throw { /// /// Throws the default , using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void ArgumentNull(string? parameterName = null, string? message = null) => throw new ArgumentNullException(parameterName, message ?? $"{parameterName ?? "The value"} must not be null."); /// /// Throws the default indicating that a value is the default value of its type, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void ArgumentDefault(string? parameterName = null, string? message = null) => throw new ArgumentDefaultException(parameterName, message ?? $"{parameterName ?? "The value"} must not be the default value."); /// /// Throws the default indicating that a reference cannot be downcast, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void InvalidTypeCast(object? parameter, Type targetType, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new TypeCastException(parameterName, message ?? $"{parameterName ?? "The value"} {parameter.ToStringOrNull()} cannot be cast to \"{targetType}\"."); /// /// Throws the default indicating that a value is not one of the constants defined in an enum, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void EnumValueNotDefined(T parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : Enum => throw new EnumValueNotDefinedException(parameterName, message ?? $"{parameterName ?? "The value"} \"{parameter}\" must be one of the defined constants of enum \"{parameter.GetType()}\", but it actually is not."); /// /// Throws the default indicating that a GUID is empty, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void EmptyGuid(string? parameterName = null, string? message = null) => throw new EmptyGuidException(parameterName, message ?? $"{parameterName ?? "The value"} must be a valid GUID, but it actually is an empty one."); /// /// Throws an using the optional message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void InvalidOperation(string? message = null) => throw new InvalidOperationException(message); /// /// Throws an using the optional message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void InvalidState(string? message = null) => throw new InvalidStateException(message); /// /// Throws an using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void Argument(string? parameterName = null, string? message = null) => throw new ArgumentException(message ?? $"{parameterName ?? "The value"} is invalid.", parameterName); /// /// Throws an using the optional message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void InvalidEmailAddress(string parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidEmailAddressException(parameterName, message ?? $"{parameterName ?? "The string"} must be a valid email address, but it actually is \"{parameter}\"."); /// /// Throws the default indicating that a has no value, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void NullableHasNoValue(string? parameterName = null, string? message = null) => throw new NullableHasNoValueException(parameterName, message ?? $"{parameterName ?? "The nullable"} must have a value, but it actually is null."); /// /// Throws the default indicating that a comparable value must not be less than the given boundary value, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void MustNotBeLessThan(T parameter, T boundary, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable => throw new ArgumentOutOfRangeException(parameterName, message ?? $"{parameterName ?? "The value"} must not be less than {boundary}, but it actually is {parameter}."); /// /// Throws the default indicating that a comparable value must be less than the given boundary value, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void MustBeLessThan(T parameter, T boundary, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable => throw new ArgumentOutOfRangeException(parameterName, message ?? $"{parameterName ?? "The value"} must be less than {boundary}, but it actually is {parameter}."); /// /// Throws the default indicating that a comparable value must not be less than or equal to the given boundary value, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void MustNotBeLessThanOrEqualTo(T parameter, T boundary, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable => throw new ArgumentOutOfRangeException(parameterName, message ?? $"{parameterName ?? "The value"} must not be less than or equal to {boundary}, but it actually is {parameter}."); /// /// Throws the default indicating that a comparable value must not be greater than or equal to the given boundary value, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void MustNotBeGreaterThanOrEqualTo(T parameter, T boundary, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable => throw new ArgumentOutOfRangeException(parameterName, message ?? $"{parameterName ?? "The value"} must not be greater than or equal to {boundary}, but it actually is {parameter}."); /// /// Throws the default indicating that a comparable value must be greater than or equal to the given boundary value, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void MustBeGreaterThanOrEqualTo(T parameter, T boundary, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable => throw new ArgumentOutOfRangeException(parameterName, message ?? $"{parameterName ?? "The value"} must be greater than or equal to {boundary}, but it actually is {parameter}."); /// /// Throws the default indicating that a comparable value must be greater than the given boundary value, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void MustBeGreaterThan(T parameter, T boundary, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable => throw new ArgumentOutOfRangeException(parameterName, message ?? $"{parameterName ?? "The value"} must be greater than {boundary}, but it actually is {parameter}."); /// /// Throws the default indicating that a comparable value must not be greater than the given boundary value, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void MustNotBeGreaterThan(T parameter, T boundary, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable => throw new ArgumentOutOfRangeException(parameterName, message ?? $"{parameterName ?? "The value"} must not be greater than {boundary}, but it actually is {parameter}."); /// /// Throws the default indicating that a comparable value must be less than or equal to the given boundary value, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void MustBeLessThanOrEqualTo(T parameter, T boundary, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable => throw new ArgumentOutOfRangeException(parameterName, message ?? $"{parameterName ?? "The value"} must be less than or equal to {boundary}, but it actually is {parameter}."); /// /// Throws the default indicating that a value is not within a specified range, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void MustBeInRange(T parameter, Range range, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable => throw new ArgumentOutOfRangeException(parameterName, message ?? $"{parameterName ?? "The value"} must be between {range.CreateRangeDescriptionText("and")}, but it actually is {parameter}."); /// /// Throws the default indicating that a value is within a specified range, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void MustNotBeInRange(T parameter, Range range, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable => throw new ArgumentOutOfRangeException(parameterName, message ?? $"{parameterName ?? "The value"} must not be between {range.CreateRangeDescriptionText("and")}, but it actually is {parameter}."); /// /// Throws the default indicating that two references point to the same object, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void SameObjectReference(T? parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : class => throw new SameObjectReferenceException(parameterName, message ?? $"{parameterName ?? "The reference"} must not point to object \"{parameter}\", but it actually does."); /// /// Throws the default indicating that a string is empty, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void EmptyString(string? parameterName = null, string? message = null) => throw new EmptyStringException(parameterName, message ?? $"{parameterName ?? "The string"} must not be an empty string, but it actually is."); /// /// Throws the default indicating that a string contains only white space, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void WhiteSpaceString(string parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new WhiteSpaceStringException(parameterName, message ?? $"{parameterName ?? "The string"} must not contain only white space, but it actually is \"{parameter}\"."); /// /// Throws the default indicating that a string does not match a regular expression, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void StringDoesNotMatch(string parameter, Regex regex, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new StringDoesNotMatchException(parameterName, message ?? $"{parameterName ?? "The string"} must match the regular expression \"{regex}\", but it actually is \"{parameter}\"."); /// /// Throws the default indicating that a string does not contain another string as a substring, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void StringDoesNotContain(string parameter, string substring, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new SubstringException(parameterName, message ?? $"{parameterName ?? "The string"} must contain {substring.ToStringOrNull()}, but it actually is {parameter.ToStringOrNull()}."); /// /// Throws the default indicating that a string does not contain another string as a substring, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void StringDoesNotContain(string parameter, string substring, StringComparison comparisonType, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new SubstringException(parameterName, message ?? $"{parameterName ?? "The string"} must contain {substring.ToStringOrNull()} ({comparisonType}), but it actually is {parameter.ToStringOrNull()}."); /// /// Throws the default indicating that a string does contain another string as a substring, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void StringContains(string parameter, string substring, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new SubstringException(parameterName, message ?? $"{parameterName ?? "The string"} must not contain {substring.ToStringOrNull()} as a substring, but it actually is {parameter.ToStringOrNull()}."); /// /// Throws the default indicating that a string does contain another string as a substring, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void StringContains(string parameter, string substring, StringComparison comparisonType, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new SubstringException(parameterName, message ?? $"{parameterName ?? "The string"} must not contain {substring.ToStringOrNull()} as a substring ({comparisonType}), but it actually is {parameter.ToStringOrNull()}."); /// /// Throws the default indicating that a string is not a substring of another one, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void NotSubstring(string parameter, string other, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new SubstringException(parameterName, message ?? $"{parameterName ?? "The string"} must be a substring of \"{other}\", but it actually is {parameter.ToStringOrNull()}."); /// /// Throws the default indicating that a string is not a substring of another one, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void NotSubstring(string parameter, string other, StringComparison comparisonType, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new SubstringException(parameterName, message ?? $"{parameterName ?? "The string"} must be a substring of \"{other}\" ({comparisonType}), but it actually is {parameter.ToStringOrNull()}."); /// /// Throws the default indicating that a string is a substring of another one, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void Substring(string parameter, string other, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new SubstringException(parameterName, message ?? $"{parameterName ?? "The string"} must not be a substring of \"{other}\", but it actually is {parameter.ToStringOrNull()}."); /// /// Throws the default indicating that a string is a substring of another one, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void Substring(string parameter, string other, StringComparison comparisonType, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new SubstringException(parameterName, message ?? $"{parameterName ?? "The string"} must not be a substring of \"{other}\" ({comparisonType}), but it actually is {parameter.ToStringOrNull()}."); /// /// Throws the default indicating that a string does not start with another one, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void StringDoesNotStartWith(string parameter, string other, StringComparison comparisonType, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new SubstringException(parameterName, message ?? $"{parameterName ?? "The string"} must start with \"{other}\" ({comparisonType}), but it actually is {parameter.ToStringOrNull()}."); /// /// Throws the default indicating that a string does start with another one, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void StringStartsWith(string parameter, string other, StringComparison comparisonType, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new SubstringException(parameterName, message ?? $"{parameterName ?? "The string"} must not start with \"{other}\" ({comparisonType}), but it actually is {parameter.ToStringOrNull()}."); /// /// Throws the default indicating that a string does not end with another one, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void StringDoesNotEndWith(string parameter, string other, StringComparison comparisonType, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new SubstringException(parameterName, message ?? $"{parameterName ?? "The string"} must end with \"{other}\" ({comparisonType}), but it actually is {parameter.ToStringOrNull()}."); /// /// Throws the default indicating that a string ends with another one, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void StringEndsWith(string parameter, string other, StringComparison comparisonType, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new SubstringException(parameterName, message ?? $"{parameterName ?? "The string"} must not end with \"{other}\" ({comparisonType}), but it actually is {parameter.ToStringOrNull()}."); /// /// Throws the default indicating that a string is not shorter than the given length, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void StringNotShorterThan(string parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new StringLengthException(parameterName, message ?? $"{parameterName ?? "The string"} must be shorter than {length}, but it actually has length {parameter.Length}."); /// /// Throws the default indicating that a string is not shorter or equal to the given length, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void StringNotShorterThanOrEqualTo(string parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new StringLengthException(parameterName, message ?? $"{parameterName ?? "The string"} must be shorter or equal to {length}, but it actually has length {parameter.Length}."); /// /// Throws the default indicating that a string has a different length than the specified one, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void StringLengthNotEqualTo(string parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new StringLengthException(parameterName, message ?? $"{parameterName ?? "The string"} must have length {length}, but it actually has length {parameter.Length}."); /// /// Throws the default indicating that a string is not longer than the given length, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void StringNotLongerThan(string parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new StringLengthException(parameterName, message ?? $"{parameterName ?? "The string"} must be longer than {length}, but it actually has length {parameter.Length}."); /// /// Throws the default indicating that a string is not longer or equal to the given length, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void StringNotLongerThanOrEqualTo(string parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new StringLengthException(parameterName, message ?? $"{parameterName ?? "The string"} must be longer than or equal to {length}, but it actually has length {parameter.Length}."); /// /// Throws the default indicating that a string's length is not in between the given range, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void StringLengthNotInRange(string parameter, Range range, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new StringLengthException(parameterName, message ?? $"{parameterName ?? "The string"} must have its length in between {range.CreateRangeDescriptionText("and")}, but it actually has length {parameter.Length}."); /// /// Throws the default indicating that a string is not equal to "\n" or "\r\n". /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void NotNewLine(string? parameter, string? parameterName, string? message) => throw new StringException(parameterName, message ?? $"{parameterName ?? "The string"} must be either \"\\n\" or \"\\r\\n\", but it actually is {parameter.ToStringOrNull()}."); /// /// Throws the default indicating that a string is not trimmed. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void NotTrimmed(string? parameter, string? parameterName, string? message) => throw new StringException(parameterName, message ?? $"{parameterName ?? "The string"} must be trimmed, but it actually is {parameter.ToStringOrNull()}."); /// /// Throws the default indicating that a string is not trimmed at the start. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void NotTrimmedAtStart(string? parameter, string? parameterName, string? message) => throw new StringException(parameterName, message ?? $"{parameterName ?? "The string"} must be trimmed at the start, but it actually is {parameter.ToStringOrNull()}."); /// /// Throws the default indicating that a string is not trimmed at the end. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void NotTrimmedAtEnd(string? parameter, string? parameterName, string? message) => throw new StringException(parameterName, message ?? $"{parameterName ?? "The string"} must be trimmed at the end, but it actually is {parameter.ToStringOrNull()}."); /// /// Throws the default indicating that two values are not equal, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void ValuesNotEqual(T parameter, T other, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new ValuesNotEqualException(parameterName, message ?? $"{parameterName ?? "The value"} must be equal to {other.ToStringOrNull()}, but it actually is {parameter.ToStringOrNull()}."); /// /// Throws the default indicating that two values are equal, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void ValuesEqual(T parameter, T other, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new ValuesEqualException(parameterName, message ?? $"{parameterName ?? "The value"} must not be equal to {other.ToStringOrNull()}, but it actually is {parameter.ToStringOrNull()}."); /// /// Throws the default indicating that a collection has an invalid number of items, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void InvalidCollectionCount(IEnumerable parameter, int count, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidCollectionCountException(parameterName, message ?? $"{parameterName ?? "The collection"} must have count {count}, but it actually has count {parameter.Count()}."); /// /// Throws the default indicating that a span has an invalid length, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void InvalidSpanLength(in Span parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidCollectionCountException(parameterName, message ?? $"{parameterName ?? "The span"} must have length {length}, but it actually has length {parameter.Length}."); /// /// Throws the default indicating that a span has an invalid length, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void InvalidSpanLength(in ReadOnlySpan parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidCollectionCountException(parameterName, message ?? $"{parameterName ?? "The read-only span"} must have length {length}, but it actually has length {parameter.Length}."); /// /// Throws the default indicating that a collection has less than a minimum number of items, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void InvalidMinimumCollectionCount(IEnumerable parameter, int count, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidCollectionCountException(parameterName, message ?? $"{parameterName ?? "The collection"} must have at least count {count}, but it actually has count {parameter.Count()}."); /// /// Throws the default indicating that a span is not longer than the specified length. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void SpanMustBeLongerThan(in Span parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidCollectionCountException(parameterName, message ?? $"{parameterName ?? "The span"} must be longer than {length}, but it actually has length {parameter.Length}."); /// /// Throws the default indicating that a span is not longer than the specified length. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void SpanMustBeLongerThan(in ReadOnlySpan parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidCollectionCountException(parameterName, message ?? $"{parameterName ?? "The span"} must be longer than {length}, but it actually has length {parameter.Length}."); /// /// Throws the default indicating that a span is not longer than and not equal to the specified length. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void SpanMustBeLongerThanOrEqualTo(in Span parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidCollectionCountException(parameterName, message ?? $"{parameterName ?? "The span"} must be longer than or equal to {length}, but it actually has length {parameter.Length}."); /// /// Throws the default indicating that a span is not longer than and not equal to the specified length. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void SpanMustBeLongerThanOrEqualTo(in ReadOnlySpan parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidCollectionCountException(parameterName, message ?? $"{parameterName ?? "The span"} must be longer than or equal to {length}, but it actually has length {parameter.Length}."); /// /// Throws the default indicating that a span is not shorter than the specified length. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void SpanMustBeShorterThan(in Span parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidCollectionCountException(parameterName, message ?? $"{parameterName ?? "The span"} must be shorter than {length}, but it actually has length {parameter.Length}."); /// /// Throws the default indicating that a span is not shorter than the specified length. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void SpanMustBeShorterThanOrEqualTo(in Span parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidCollectionCountException(parameterName, message ?? $"{parameterName ?? "The span"} must be shorter than or equal to {length}, but it actually has length {parameter.Length}."); /// /// Throws the default indicating that a span is not shorter than the specified length. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void SpanMustBeShorterThanOrEqualTo(in ReadOnlySpan parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidCollectionCountException(parameterName, message ?? $"{parameterName ?? "The span"} must be shorter than or equal to {length}, but it actually has length {parameter.Length}."); /// /// Throws the default indicating that a span is not shorter than the specified length. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void SpanMustBeShorterThan(in ReadOnlySpan parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidCollectionCountException(parameterName, message ?? $"{parameterName ?? "The span"} must be shorter than {length}, but it actually has length {parameter.Length}."); /// /// Throws the default indicating that a collection has more than a maximum number of items, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void InvalidMaximumCollectionCount(IEnumerable parameter, int count, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidCollectionCountException(parameterName, message ?? $"{parameterName ?? "The collection"} must have at most count {count}, but it actually has count {parameter.Count()}."); /// /// Throws the default indicating that a collection has no items, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void EmptyCollection(string? parameterName = null, string? message = null) => throw new EmptyCollectionException(parameterName, message ?? $"{parameterName ?? "The collection"} must not be an empty collection, but it actually is."); /// /// Throws the default indicating that a collection is not containing the specified item, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void MissingItem(IEnumerable parameter, TItem item, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new MissingItemException(parameterName, message ?? new StringBuilder().AppendLine($"{parameterName ?? "The collection"} must contain {item.ToStringOrNull()}, but it actually does not.") .AppendCollectionContent(parameter) .ToString()); /// /// Throws the default indicating that a collection contains the specified item that should not be part of it, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void ExistingItem(IEnumerable parameter, TItem item, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new ExistingItemException(parameterName, message ?? new StringBuilder().AppendLine($"{parameterName ?? "The collection"} must not contain {item.ToStringOrNull()}, but it actually does.") .AppendCollectionContent(parameter) .ToString()); /// /// Throws the default indicating that a value is not one of a specified collection of items, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void ValueNotOneOf(TItem parameter, IEnumerable items, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new ValueIsNotOneOfException(parameterName, message ?? new StringBuilder().AppendLine($"{parameterName ?? "The value"} must be one of the following items") .AppendItemsWithNewLine(items) .AppendLine($"but it actually is {parameter.ToStringOrNull()}.") .ToString()); /// /// Throws the default indicating that a value is one of a specified collection of items, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void ValueIsOneOf(TItem parameter, IEnumerable items, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new ValueIsOneOfException(parameterName, message ?? new StringBuilder().AppendLine($"{parameterName ?? "The value"} must not be one of the following items") .AppendItemsWithNewLine(items) .AppendLine($"but it actually is {parameter.ToStringOrNull()}.") .ToString()); /// /// Throws the default indicating that a URI is relative instead of absolute, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void MustBeAbsoluteUri(Uri parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new RelativeUriException(parameterName, message ?? $"{parameterName ?? "The URI"} must be an absolute URI, but it actually is \"{parameter}\"."); /// /// Throws the default indicating that a URI is absolute instead of relative, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void MustBeRelativeUri(Uri parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new AbsoluteUriException(parameterName, message ?? $"{parameterName ?? "The URI"} must be a relative URI, but it actually is \"{parameter}\"."); /// /// Throws the default indicating that a URI has an unexpected scheme, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void UriMustHaveScheme(Uri parameter, string scheme, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidUriSchemeException(parameterName, message ?? $"{parameterName ?? "The URI"} must use the scheme \"{scheme}\", but it actually is \"{parameter}\"."); /// /// Throws the default indicating that a URI does not use one of a set of expected schemes, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void UriMustHaveOneSchemeOf(Uri parameter, IEnumerable schemes, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidUriSchemeException(parameterName, message ?? new StringBuilder().AppendLine($"{parameterName ?? "The URI"} must use one of the following schemes") .AppendItemsWithNewLine(schemes) .AppendLine($"but it actually is \"{parameter}\".") .ToString()); /// /// Throws the default indicating that a date time is not using , using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void MustBeUtcDateTime(DateTime parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidDateTimeException(parameterName, message ?? $"{parameterName ?? "The date time"} must use kind \"{DateTimeKind.Utc}\", but it actually uses \"{parameter.Kind}\" and is \"{parameter:O}\"."); /// /// Throws the default indicating that a date time is not using , using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void MustBeLocalDateTime(DateTime parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidDateTimeException(parameterName, message ?? $"{parameterName ?? "The date time"} must use kind \"{DateTimeKind.Local}\", but it actually uses \"{parameter.Kind}\" and is \"{parameter:O}\"."); /// /// Throws the default indicating that a date time is not using , using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void MustBeUnspecifiedDateTime(DateTime parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidDateTimeException(parameterName, message ?? $"{parameterName ?? "The date time"} must use kind \"{DateTimeKind.Unspecified}\", but it actually uses \"{parameter.Kind}\" and is \"{parameter:O}\"."); /// /// Throws the exception that is returned by . /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void CustomException(Func exceptionFactory) => throw exceptionFactory.MustNotBeNull(nameof(exceptionFactory))(); /// /// Throws the exception that is returned by . is passed to . /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void CustomException(Func exceptionFactory, T parameter) => throw exceptionFactory.MustNotBeNull(nameof(exceptionFactory))(parameter); /// /// Throws the exception that is returned by . and are passed to . /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void CustomException(Func exceptionFactory, T1 first, T2 second) => throw exceptionFactory.MustNotBeNull(nameof(exceptionFactory))(first, second); /// /// Throws the exception that is returned by . , , and are passed to . /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void CustomException(Func exceptionFactory, T1 first, T2 second, T3 third) => throw exceptionFactory.MustNotBeNull(nameof(exceptionFactory))(first, second, third); /// /// Throws the exception that is returned by . and are passed to . /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void CustomSpanException(SpanExceptionFactory exceptionFactory, in Span span, T value) => throw exceptionFactory.MustNotBeNull(nameof(exceptionFactory))(span, value); /// /// Throws the exception that is returned by . and are passed to . /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void CustomSpanException(ReadOnlySpanExceptionFactory exceptionFactory, in ReadOnlySpan span, T value) => throw exceptionFactory.MustNotBeNull(nameof(exceptionFactory))(span, value); }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Exceptions/TypeCastException.cs000066400000000000000000000014431470750352700276230ustar00rootroot00000000000000using System; using System.Runtime.Serialization; namespace Light.GuardClauses.Exceptions; /// /// This exception indicates that a value cannot be cast to another type. /// [Serializable] public class TypeCastException : ArgumentException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public TypeCastException(string? parameterName = null, string? message = null) : base(message, parameterName) { } #if !NET8_0 /// protected TypeCastException(SerializationInfo info, StreamingContext context) : base(info, context) { } #endif }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Exceptions/UriException.cs000066400000000000000000000013721470750352700266270ustar00rootroot00000000000000using System; using System.Runtime.Serialization; namespace Light.GuardClauses.Exceptions; /// /// This exception indicates that an URI is invalid. /// [Serializable] public class UriException : ArgumentException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public UriException(string? parameterName = null, string? message = null) : base(message, parameterName) { } #if !NET8_0 /// protected UriException(SerializationInfo info, StreamingContext context) : base(info, context) { } #endif }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Exceptions/ValueIsNotOneOfException.cs000066400000000000000000000014671470750352700310550ustar00rootroot00000000000000using System; using System.Runtime.Serialization; namespace Light.GuardClauses.Exceptions; /// /// This exception indicates that an item is not part of a collection. /// [Serializable] public class ValueIsNotOneOfException : ArgumentException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public ValueIsNotOneOfException(string? parameterName = null, string? message = null) : base(message, parameterName) { } #if !NET8_0 /// protected ValueIsNotOneOfException(SerializationInfo info, StreamingContext context) : base(info, context) { } #endif }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Exceptions/ValueIsOneOfException.cs000066400000000000000000000014541470750352700303700ustar00rootroot00000000000000using System; using System.Runtime.Serialization; namespace Light.GuardClauses.Exceptions; /// /// This exception indicates that an item is part of a collection. /// [Serializable] public class ValueIsOneOfException : ArgumentException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public ValueIsOneOfException(string? parameterName = null, string? message = null) : base(message, parameterName) { } #if !NET8_0 /// protected ValueIsOneOfException(SerializationInfo info, StreamingContext context) : base(info, context) { } #endif }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Exceptions/ValuesEqualException.cs000066400000000000000000000014351470750352700303170ustar00rootroot00000000000000using System; using System.Runtime.Serialization; namespace Light.GuardClauses.Exceptions; /// /// This exception indicates that two values are equal. /// [Serializable] public class ValuesEqualException : ArgumentException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public ValuesEqualException(string? parameterName = null, string? message = null) : base(message, parameterName) { } #if !NET8_0 /// protected ValuesEqualException(SerializationInfo info, StreamingContext context) : base(info, context) { } #endif }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Exceptions/ValuesNotEqualException.cs000066400000000000000000000014551470750352700310020ustar00rootroot00000000000000using System; using System.Runtime.Serialization; namespace Light.GuardClauses.Exceptions; /// /// This exception indicates that two values are not equal. /// [Serializable] public class ValuesNotEqualException : ArgumentException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public ValuesNotEqualException(string? parameterName = null, string? message = null) : base(message, parameterName) { } #if !NET8_0 /// protected ValuesNotEqualException(SerializationInfo info, StreamingContext context) : base(info, context) { } #endif }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Exceptions/WhiteSpaceStringException.cs000066400000000000000000000014751470750352700313170ustar00rootroot00000000000000using System; using System.Runtime.Serialization; namespace Light.GuardClauses.Exceptions; /// /// This exception indicates that a string contains only white space. /// [Serializable] public class WhiteSpaceStringException : StringException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public WhiteSpaceStringException(string? parameterName = null, string? message = null) : base(parameterName, message) { } #if !NET8_0 /// protected WhiteSpaceStringException(SerializationInfo info, StreamingContext context) : base(info, context) { } #endif }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/FrameworkExtensions/000077500000000000000000000000001470750352700255535ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Code/Light.GuardClauses/FrameworkExtensions/EnumerableExtensions.cs000066400000000000000000000333621470750352700322500ustar00rootroot00000000000000using System; using System.Collections; using System.Collections.Generic; using System.Linq; using JetBrains.Annotations; using System.Runtime.CompilerServices; using Light.GuardClauses.Exceptions; using NotNullAttribute = System.Diagnostics.CodeAnalysis.NotNullAttribute; namespace Light.GuardClauses.FrameworkExtensions; /// /// Provides extension methods for the interface. /// public static class EnumerableExtensions { /// /// Tries to cast the specified enumerable to an , or /// creates a new containing the enumerable items. /// /// The item type of the enumerable. /// The enumerable to be transformed. /// The list containing the items of the enumerable. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("source:null => halt; source:notnull => notnull")] // ReSharper disable once RedundantNullableFlowAttribute -- NotNull has an effect, see Issue72NotNullAttributeTests public static IList AsList([NotNull, ValidatedNotNull] this IEnumerable source) => source as IList ?? source.ToList(); /// /// Tries to cast the specified enumerable to an , or /// creates a new collection containing the enumerable items by calling the specified delegate. /// /// The item type of the collection. /// The enumerable that will be converted to . /// The delegate that creates the collection containing the specified items. /// The cast enumerable, or a new collection containing the enumerable items. /// Thrown when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("source:null => halt; source:notnull => notnull; createCollection:null => halt")] // ReSharper disable once RedundantNullableFlowAttribute -- NotNull has an effect, see Issue72NotNullAttributeTests public static IList AsList([NotNull, ValidatedNotNull] this IEnumerable source, Func, IList> createCollection) => source as IList ?? createCollection.MustNotBeNull(nameof(createCollection))(source.MustNotBeNull(nameof(source))); /// /// Tries to downcast the specified enumerable to an array, or creates a new array with the specified items. /// /// The item type of the collection. /// The enumerable that will be converted to an array. /// The cast array, or a new array containing the enumerable items. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("source:null => halt; source:notnull => notnull")] // ReSharper disable once RedundantNullableFlowAttribute -- NotNull has an effect, see Issue72NotNullAttributeTests public static T[] AsArray([NotNull, ValidatedNotNull] this IEnumerable source) => source as T[] ?? source.ToArray(); /// /// Performs the action on each item of the specified enumerable. If the enumerable contains items that are null, this /// method can either throw an exception or ignore the value (your delegate will not be called in this case). /// /// The item type of the enumerable. /// The collection containing the items that will be passed to the action. /// The action that executes for each item of the collection. /// The value indicating whether this method should throw a when any of the items is null (optional). Defaults to true. /// Thrown when or is null. /// Thrown when contains a value that is null and is set to true. // ReSharper disable once RedundantNullableFlowAttribute -- NotNull has an effect, see Issue72NotNullAttributeTests public static IEnumerable ForEach([NotNull, ValidatedNotNull] this IEnumerable enumerable, Action action, bool throwWhenItemIsNull = true) { // ReSharper disable PossibleMultipleEnumeration action.MustNotBeNull(nameof(action)); var i = 0; if (enumerable is IList list) { for (; i < list.Count; i++) { var item = list[i]; if (item is null) { if (throwWhenItemIsNull) throw new CollectionException(nameof(enumerable), $"The collection contains null at index {i}."); continue; } action(item); } } else { foreach (var item in enumerable.MustNotBeNull(nameof(enumerable))) { if (item is null) { if (throwWhenItemIsNull) throw new CollectionException(nameof(enumerable), $"The collection contains null at index {i}."); ++i; continue; } action(item); ++i; } } return enumerable; // ReSharper restore PossibleMultipleEnumeration } /// /// Tries to cast the specified enumerable as an , or /// creates a new containing the enumerable items. /// /// The item type of the enumerable. /// The enumerable to be transformed. /// The list containing the items of the enumerable. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("source:null => halt; source:notnull => notnull")] // ReSharper disable once RedundantNullableFlowAttribute -- NotNull has an effect, see Issue72NotNullAttributeTests public static IReadOnlyList AsReadOnlyList([NotNull, ValidatedNotNull] this IEnumerable source) => source as IReadOnlyList ?? source.ToList(); /// /// Tries to cast the specified enumerable as an , or /// creates a new collection containing the enumerable items by calling the specified delegate. /// /// The item type of the collection. /// The enumerable that will be converted to . /// The delegate that creates the collection containing the specified items. /// The cast enumerable, or a new collection containing the enumerable items. /// Thrown when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("source:null => halt; source:notnull => notnull; createCollection:null => halt")] // ReSharper disable RedundantNullableFlowAttribute -- NotNull has an effect, see Issue72NotNullAttributeTests public static IReadOnlyList AsReadOnlyList([NotNull, ValidatedNotNull] this IEnumerable source, [NotNull, ValidatedNotNull] Func, IReadOnlyList> createCollection) => source as IReadOnlyList ?? createCollection.MustNotBeNull(nameof(createCollection))(source.MustNotBeNull(nameof(source))); // ReSharper restore RedundantNullableFlowAttribute /// /// Gets the count of the specified enumerable. /// /// The enumerable whose count should be determined. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("enumerable:null => halt")] // ReSharper disable once RedundantNullableFlowAttribute -- NotNull has an effect, see Issue72NotNullAttributeTests public static int Count([NotNull, ValidatedNotNull] this IEnumerable enumerable) { if (enumerable is ICollection collection) return collection.Count; if (enumerable is string @string) return @string.Length; return DetermineCountViaEnumerating(enumerable); } /// /// Gets the count of the specified enumerable. /// /// The enumerable whose count should be determined. /// The name of the parameter that is passed to the (optional). /// The message that is passed to the (optional). /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("enumerable:null => halt")] public static int Count([NotNull, ValidatedNotNull] this IEnumerable? enumerable, string? parameterName, string? message) { if (enumerable is ICollection collection) return collection.Count; if (enumerable is string @string) return @string.Length; return DetermineCountViaEnumerating(enumerable, parameterName, message); } /// /// Gets the count of the specified enumerable. /// /// The enumerable whose count should be determined. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("enumerable:null => halt")] // ReSharper disable RedundantNullableFlowAttribute -- NotNull has an effect, see Issue72NotNullAttributeTests public static int GetCount([NotNull, ValidatedNotNull] this IEnumerable enumerable) { if (enumerable is ICollection collection) return collection.Count; if (enumerable is string @string) return @string.Length; if (TryGetCollectionOfTCount(enumerable, out var count)) return count; return DetermineCountViaEnumerating(enumerable); } /// /// Gets the count of the specified enumerable. /// /// The enumerable whose count should be determined. /// The name of the parameter that is passed to the (optional). /// The message that is passed to the (optional). /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("enumerable:null => halt")] public static int GetCount([NotNull, ValidatedNotNull] this IEnumerable enumerable, string? parameterName, string? message = null) { if (enumerable is ICollection collection) return collection.Count; if (enumerable is string @string) return @string.Length; if (TryGetCollectionOfTCount(enumerable, out var count)) return count; return DetermineCountViaEnumerating(enumerable, parameterName, message); } private static bool TryGetCollectionOfTCount([NoEnumeration] this IEnumerable enumerable, out int count) { if (enumerable is ICollection collectionOfT) { count = collectionOfT.Count; return true; } if (enumerable is IReadOnlyCollection readOnlyCollection) { count = readOnlyCollection.Count; return true; } count = 0; return false; } private static int DetermineCountViaEnumerating(IEnumerable? enumerable) { var count = 0; var enumerator = enumerable.MustNotBeNull(nameof(enumerable)).GetEnumerator(); while (enumerator.MoveNext()) count++; if (enumerator is IDisposable disposable) { disposable.Dispose(); } return count; } private static int DetermineCountViaEnumerating([NotNull] IEnumerable? enumerable, string? parameterName, string? message) { var count = 0; var enumerator = enumerable.MustNotBeNull(parameterName, message).GetEnumerator(); while (enumerator.MoveNext()) count++; if (enumerator is IDisposable disposable) { disposable.Dispose(); } return count; } internal static bool ContainsViaForeach(this IEnumerable items, TItem item) { var equalityComparer = EqualityComparer.Default; foreach (var i in items) { if (equalityComparer.Equals(i, item)) return true; } return false; } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/FrameworkExtensions/ExpressionExtensions.cs000066400000000000000000000055461470750352700323330ustar00rootroot00000000000000using System; using System.Diagnostics.CodeAnalysis; using System.Linq.Expressions; using System.Reflection; namespace Light.GuardClauses.FrameworkExtensions; /// /// Provides extension methods for instances. /// public static class ExpressionExtensions { /// /// Extracts the from an expression of the shape "object => object.Property". /// /// The object type. /// The type of the property. /// The expression where the property info will be extracted from. /// Thrown when is null. /// /// Throw when the is not of the shape "object => object.Property". /// // ReSharper disable once RedundantNullableFlowAttribute - NotNull is not redundant, see Issue72NotNullAttributeTests public static PropertyInfo ExtractProperty([NotNull, ValidatedNotNull] this Expression> expression) { expression.MustNotBeNull(nameof(expression)); var memberExpression = expression.Body as MemberExpression; if (!(memberExpression?.Member is PropertyInfo propertyInfo)) throw new ArgumentException("The specified expression is not valid. Please use an expression like the following one: o => o.Property", nameof(expression)); return propertyInfo; } /// /// Extracts the from an expression of the shape "object => object.Field". /// /// The object type. /// The type of the field. /// The expression where the field info will be extracted from. /// Thrown when is null. /// /// Throw when the is not of the shape "object => object.Field". /// // ReSharper disable once RedundantNullableFlowAttribute - NotNull is not redundant, see Issue72NotNullAttributeTests public static FieldInfo ExtractField([NotNull, ValidatedNotNull] this Expression> expression) { expression.MustNotBeNull(nameof(expression)); var memberExpression = expression.Body as MemberExpression; if (!(memberExpression?.Member is FieldInfo fieldInfo)) throw new ArgumentException("The specified expression is not valid. Please use an expression like the following one: o => o.Field", nameof(expression)); return fieldInfo; } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/FrameworkExtensions/MultiplyAddHash.cs000066400000000000000000000325211470750352700311410ustar00rootroot00000000000000using System.Runtime.CompilerServices; namespace Light.GuardClauses.FrameworkExtensions; /// /// The class represents a simple non-cryptographic hash function that uses a prime number /// as seed and then manipulates this value by constantly performing hash = unchecked(hash * SecondPrime + value?.GetHashCode() ?? 0); /// for each given value. It is implemented according to the guidelines of Jon Skeet as stated in this Stack Overflow /// answer: http://stackoverflow.com/a/263416/1560623. IMPORTANT: do not persist any hash codes and rely on them /// to stay the same. Hash codes should only be used in memory within a single process session, usually for the use /// in dictionaries (hash tables) and sets. This algorithm, especially the prime numbers can change even during minor /// releases of Light.GuardClauses. /// public static class MultiplyAddHash { /// /// This prime number is used as an initial (seed) value when calculating hash codes. Its value is 1322837333. /// public const int FirstPrime = 1322837333; /// /// The second prime number (397) used for hash code generation. It is applied using the following statement: /// hash = unchecked(hash * SecondPrime + value?.GetHashCode() ?? 0);. /// It is the same value that ReSharper (2018.1) uses for hash code generation. /// public const int SecondPrime = 397; /// /// Creates a hash code from the two specified values. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CreateHashCode(T1 value1, T2 value2) { var hash = FirstPrime; CombineIntoHash(ref hash, value1); CombineIntoHash(ref hash, value2); return hash; } /// /// Creates a hash code from the three specified values. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CreateHashCode(T1 value1, T2 value2, T3 value3) { var hash = FirstPrime; CombineIntoHash(ref hash, value1); CombineIntoHash(ref hash, value2); CombineIntoHash(ref hash, value3); return hash; } /// /// Creates a hash code from the four specified values. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CreateHashCode(T1 value1, T2 value2, T3 value3, T4 value4) { var hash = FirstPrime; CombineIntoHash(ref hash, value1); CombineIntoHash(ref hash, value2); CombineIntoHash(ref hash, value3); CombineIntoHash(ref hash, value4); return hash; } /// /// Creates a hash code from the five specified values. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CreateHashCode(T1 value1, T2 value2, T3 value3, T4 value4, T5 value5) { var hash = FirstPrime; CombineIntoHash(ref hash, value1); CombineIntoHash(ref hash, value2); CombineIntoHash(ref hash, value3); CombineIntoHash(ref hash, value4); CombineIntoHash(ref hash, value5); return hash; } /// /// Creates a hash code from the six specified values. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CreateHashCode(T1 value1, T2 value2, T3 value3, T4 value4, T5 value5, T6 value6) { var hash = FirstPrime; CombineIntoHash(ref hash, value1); CombineIntoHash(ref hash, value2); CombineIntoHash(ref hash, value3); CombineIntoHash(ref hash, value4); CombineIntoHash(ref hash, value5); CombineIntoHash(ref hash, value6); return hash; } /// /// Creates a hash code from the seven specified values. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CreateHashCode(T1 value1, T2 value2, T3 value3, T4 value4, T5 value5, T6 value6, T7 value7) { var hash = FirstPrime; CombineIntoHash(ref hash, value1); CombineIntoHash(ref hash, value2); CombineIntoHash(ref hash, value3); CombineIntoHash(ref hash, value4); CombineIntoHash(ref hash, value5); CombineIntoHash(ref hash, value6); CombineIntoHash(ref hash, value7); return hash; } /// /// Creates a hash code from the eight specified values. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CreateHashCode(T1 value1, T2 value2, T3 value3, T4 value4, T5 value5, T6 value6, T7 value7, T8 value8) { var hash = FirstPrime; CombineIntoHash(ref hash, value1); CombineIntoHash(ref hash, value2); CombineIntoHash(ref hash, value3); CombineIntoHash(ref hash, value4); CombineIntoHash(ref hash, value5); CombineIntoHash(ref hash, value6); CombineIntoHash(ref hash, value7); CombineIntoHash(ref hash, value8); return hash; } /// /// Creates a hash code from the nine specified values. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CreateHashCode(T1 value1, T2 value2, T3 value3, T4 value4, T5 value5, T6 value6, T7 value7, T8 value8, T9 value9) { var hash = FirstPrime; CombineIntoHash(ref hash, value1); CombineIntoHash(ref hash, value2); CombineIntoHash(ref hash, value3); CombineIntoHash(ref hash, value4); CombineIntoHash(ref hash, value5); CombineIntoHash(ref hash, value6); CombineIntoHash(ref hash, value7); CombineIntoHash(ref hash, value8); CombineIntoHash(ref hash, value9); return hash; } /// /// Creates a hash code from the ten specified values. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CreateHashCode(T1 value1, T2 value2, T3 value3, T4 value4, T5 value5, T6 value6, T7 value7, T8 value8, T9 value9, T10 value10) { var hash = FirstPrime; CombineIntoHash(ref hash, value1); CombineIntoHash(ref hash, value2); CombineIntoHash(ref hash, value3); CombineIntoHash(ref hash, value4); CombineIntoHash(ref hash, value5); CombineIntoHash(ref hash, value6); CombineIntoHash(ref hash, value7); CombineIntoHash(ref hash, value8); CombineIntoHash(ref hash, value9); CombineIntoHash(ref hash, value10); return hash; } /// /// Creates a hash code from the eleven specified values. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CreateHashCode(T1 value1, T2 value2, T3 value3, T4 value4, T5 value5, T6 value6, T7 value7, T8 value8, T9 value9, T10 value10, T11 value11) { var hash = FirstPrime; CombineIntoHash(ref hash, value1); CombineIntoHash(ref hash, value2); CombineIntoHash(ref hash, value3); CombineIntoHash(ref hash, value4); CombineIntoHash(ref hash, value5); CombineIntoHash(ref hash, value6); CombineIntoHash(ref hash, value7); CombineIntoHash(ref hash, value8); CombineIntoHash(ref hash, value9); CombineIntoHash(ref hash, value10); CombineIntoHash(ref hash, value11); return hash; } /// /// Creates a hash code from the eleven specified values. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CreateHashCode(T1 value1, T2 value2, T3 value3, T4 value4, T5 value5, T6 value6, T7 value7, T8 value8, T9 value9, T10 value10, T11 value11, T12 value12) { var hash = FirstPrime; CombineIntoHash(ref hash, value1); CombineIntoHash(ref hash, value2); CombineIntoHash(ref hash, value3); CombineIntoHash(ref hash, value4); CombineIntoHash(ref hash, value5); CombineIntoHash(ref hash, value6); CombineIntoHash(ref hash, value7); CombineIntoHash(ref hash, value8); CombineIntoHash(ref hash, value9); CombineIntoHash(ref hash, value10); CombineIntoHash(ref hash, value11); CombineIntoHash(ref hash, value12); return hash; } /// /// Creates a hash code from the thirteen specified values. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CreateHashCode(T1 value1, T2 value2, T3 value3, T4 value4, T5 value5, T6 value6, T7 value7, T8 value8, T9 value9, T10 value10, T11 value11, T12 value12, T13 value13) { var hash = FirstPrime; CombineIntoHash(ref hash, value1); CombineIntoHash(ref hash, value2); CombineIntoHash(ref hash, value3); CombineIntoHash(ref hash, value4); CombineIntoHash(ref hash, value5); CombineIntoHash(ref hash, value6); CombineIntoHash(ref hash, value7); CombineIntoHash(ref hash, value8); CombineIntoHash(ref hash, value9); CombineIntoHash(ref hash, value10); CombineIntoHash(ref hash, value11); CombineIntoHash(ref hash, value12); CombineIntoHash(ref hash, value13); return hash; } /// /// Creates a hash code from the fourteen specified values. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CreateHashCode(T1 value1, T2 value2, T3 value3, T4 value4, T5 value5, T6 value6, T7 value7, T8 value8, T9 value9, T10 value10, T11 value11, T12 value12, T13 value13, T14 value14) { var hash = FirstPrime; CombineIntoHash(ref hash, value1); CombineIntoHash(ref hash, value2); CombineIntoHash(ref hash, value3); CombineIntoHash(ref hash, value4); CombineIntoHash(ref hash, value5); CombineIntoHash(ref hash, value6); CombineIntoHash(ref hash, value7); CombineIntoHash(ref hash, value8); CombineIntoHash(ref hash, value9); CombineIntoHash(ref hash, value10); CombineIntoHash(ref hash, value11); CombineIntoHash(ref hash, value12); CombineIntoHash(ref hash, value13); CombineIntoHash(ref hash, value14); return hash; } /// /// Creates a hash code from the fifteen specified values. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CreateHashCode(T1 value1, T2 value2, T3 value3, T4 value4, T5 value5, T6 value6, T7 value7, T8 value8, T9 value9, T10 value10, T11 value11, T12 value12, T13 value13, T14 value14, T15 value15) { var hash = FirstPrime; CombineIntoHash(ref hash, value1); CombineIntoHash(ref hash, value2); CombineIntoHash(ref hash, value3); CombineIntoHash(ref hash, value4); CombineIntoHash(ref hash, value5); CombineIntoHash(ref hash, value6); CombineIntoHash(ref hash, value7); CombineIntoHash(ref hash, value8); CombineIntoHash(ref hash, value9); CombineIntoHash(ref hash, value10); CombineIntoHash(ref hash, value11); CombineIntoHash(ref hash, value12); CombineIntoHash(ref hash, value13); CombineIntoHash(ref hash, value14); CombineIntoHash(ref hash, value15); return hash; } /// /// Creates a hash code from the sixteen specified values. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CreateHashCode(T1 value1, T2 value2, T3 value3, T4 value4, T5 value5, T6 value6, T7 value7, T8 value8, T9 value9, T10 value10, T11 value11, T12 value12, T13 value13, T14 value14, T15 value15, T16 value16) { var hash = FirstPrime; CombineIntoHash(ref hash, value1); CombineIntoHash(ref hash, value2); CombineIntoHash(ref hash, value3); CombineIntoHash(ref hash, value4); CombineIntoHash(ref hash, value5); CombineIntoHash(ref hash, value6); CombineIntoHash(ref hash, value7); CombineIntoHash(ref hash, value8); CombineIntoHash(ref hash, value9); CombineIntoHash(ref hash, value10); CombineIntoHash(ref hash, value11); CombineIntoHash(ref hash, value12); CombineIntoHash(ref hash, value13); CombineIntoHash(ref hash, value14); CombineIntoHash(ref hash, value15); CombineIntoHash(ref hash, value16); return hash; } /// /// Mutates the given hash with the specified value using the following statement: /// hash = unchecked(hash * SecondPrime + value?.GetHashCode() ?? 0);. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static void CombineIntoHash(ref int hash, T value) => hash = unchecked(hash * SecondPrime + value?.GetHashCode() ?? 0); }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/FrameworkExtensions/MultiplyAddHashBuilder.cs000066400000000000000000000031161470750352700324460ustar00rootroot00000000000000using System.Runtime.CompilerServices; namespace Light.GuardClauses.FrameworkExtensions; /// /// Represents a builder for the algorithm that does not allocate. /// Should only be used in cases where the overload for sixteen values is not enough or a dedicated /// initial hash must be provided (e.g. for test reasons). /// Instantiate the builder with the method. You have to instantiate a new builder /// for each hash code that you want to calculate. /// public struct MultiplyAddHashBuilder { private int _hash; [MethodImpl(MethodImplOptions.AggressiveInlining)] private MultiplyAddHashBuilder(int initialHash) => _hash = initialHash; /// /// Combines the given value into the hash using the method. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public MultiplyAddHashBuilder CombineIntoHash(T value) { MultiplyAddHash.CombineIntoHash(ref _hash, value); return this; } /// /// Returns the calculated hash code. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public int BuildHash() => _hash; /// /// Initializes a new instance of with the specified initial hash. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static MultiplyAddHashBuilder Create(int initialHash = MultiplyAddHash.FirstPrime) => new MultiplyAddHashBuilder(initialHash); }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/FrameworkExtensions/TextExtensions.cs000066400000000000000000000367601470750352700311220ustar00rootroot00000000000000using System; using System.Collections.Generic; using System.Collections.ObjectModel; using System.Runtime.CompilerServices; using System.Text; using JetBrains.Annotations; using NotNullAttribute = System.Diagnostics.CodeAnalysis.NotNullAttribute; namespace Light.GuardClauses.FrameworkExtensions; /// /// Provides extension methods for and to easily assembly error messages. /// public static class TextExtensions { /// /// Gets the default NewLineSeparator. This value is $",{Environment.NewLine}". /// public static readonly string DefaultNewLineSeparator = ',' + Environment.NewLine; /// /// Gets the list of types that will not be surrounded by quotation marks in error messages. /// public static readonly ReadOnlyCollection UnquotedTypes = new ( [ typeof(int), typeof(long), typeof(short), typeof(sbyte), typeof(uint), typeof(ulong), typeof(ushort), typeof(byte), typeof(bool), typeof(double), typeof(decimal), typeof(float) ] ); private static bool IsUnquotedType() { if (typeof(T) == typeof(int)) return true; if (typeof(T) == typeof(long)) return true; if (typeof(T) == typeof(short)) return true; if (typeof(T) == typeof(sbyte)) return true; if (typeof(T) == typeof(uint)) return true; if (typeof(T) == typeof(ulong)) return true; if (typeof(T) == typeof(ushort)) return true; if (typeof(T) == typeof(byte)) return true; if (typeof(T) == typeof(bool)) return true; if (typeof(T) == typeof(double)) return true; if (typeof(T) == typeof(decimal)) return true; if (typeof(T) == typeof(float)) return true; return false; } /// /// Returns the string representation of , or if is null. /// If the type of is not one of , then quotation marks will be put around the string representation. /// /// The item whose string representation should be returned. /// The text that is returned when is null (defaults to "null"). [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("=> notnull")] public static string ToStringOrNull(this T value, string nullText = "null") => value?.ToStringRepresentation() ?? nullText; /// /// Returns the string representation of . This is done by calling . If the type of /// is not one of , then the resulting string will be wrapped in quotation marks. /// /// The value whose string representation is requested. [ContractAnnotation("value:null => halt; value:notnull => notnull")] public static string? ToStringRepresentation([NotNull, ValidatedNotNull] this T value) { value.MustNotBeNullReference(nameof(value)); var content = value.ToString(); if (IsUnquotedType() || content.IsNullOrEmpty()) return content; // ReSharper disable UseIndexFromEndExpression -- not possible in netstandard2.0 if (content.Length <= 126) { Span span = stackalloc char[content.Length + 2]; span[0] = span[span.Length - 1] = '"'; content.AsSpan().CopyTo(span.Slice(1, content.Length)); return span.ToString(); } var contentWithQuotationMarks = new char[content.Length + 2]; contentWithQuotationMarks[0] = contentWithQuotationMarks[contentWithQuotationMarks.Length - 1] = '"'; // ReSharper restore UseIndexFromEndExpression content.CopyTo(0, contentWithQuotationMarks, 1, content.Length); return new string(contentWithQuotationMarks); } /// /// Appends the content of the collection with the specified header line to the string builder. /// Each item is on a new line. /// /// The item type of the collection. /// The string builder that the content is appended to. /// The collection whose items will be appended to the string builder. /// The string that will be placed before the actual items as a header. /// The value indicating if a new line is added after the last item. This value defaults to true. /// Thrown when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("stringBuilder:null => halt; items:null => halt; stringBuilder:notnull => notnull")] // ReSharper disable RedundantNullableFlowAttribute public static StringBuilder AppendCollectionContent([NotNull, ValidatedNotNull] this StringBuilder stringBuilder, [NotNull, ValidatedNotNull] IEnumerable items, string headerLine = "Content of the collection:", bool finishWithNewLine = true) => stringBuilder.MustNotBeNull(nameof(stringBuilder)) .AppendLine(headerLine) .AppendItemsWithNewLine(items, finishWithNewLine: finishWithNewLine); // ReSharper restore RedundantNullableFlowAttribute /// /// Appends the string representations of the specified items to the string builder. /// /// The string builder where the items will be appended to. /// The items to be appended. /// The characters used to separate the items. Defaults to ", " and is not appended after the last item. /// The text that is appended to the string builder when is empty. Defaults to "empty collection". /// Thrown when or is null. [ContractAnnotation("stringBuilder:null => halt; items:null => halt; stringBuilder:notnull => notnull")] // ReSharper disable RedundantNullableFlowAttribute public static StringBuilder AppendItems([NotNull, ValidatedNotNull] this StringBuilder stringBuilder, [NotNull, ValidatedNotNull] IEnumerable items, string itemSeparator = ", ", string emptyCollectionText = "empty collection") // ReSharper restore RedundantNullableFlowAttribute { stringBuilder.MustNotBeNull(nameof(stringBuilder)); var list = items.MustNotBeNull(nameof(items)).AsList(); var currentIndex = 0; var itemsCount = list.Count; if (itemsCount == 0) return stringBuilder.Append(emptyCollectionText); while (true) { stringBuilder.Append(list[currentIndex].ToStringOrNull()); if (currentIndex < itemsCount - 1) stringBuilder.Append(itemSeparator); else return stringBuilder; ++currentIndex; } } /// /// Appends the string representations of the specified items to the string builder. Each item is on its own line. /// /// The string builder where the items will be appended to. /// The items to be appended. /// The text that is appended to the string builder when is empty. Defaults to "empty collection". /// The value indicating if a new line is added after the last item. This value defaults to true. /// Thrown when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("stringBuilder:null => halt; items:null => halt; stringBuilder:notnull => notnull")] // ReSharper disable RedundantNullableFlowAttribute public static StringBuilder AppendItemsWithNewLine([NotNull, ValidatedNotNull] this StringBuilder stringBuilder, [NotNull, ValidatedNotNull] IEnumerable items, string emptyCollectionText = "empty collection", bool finishWithNewLine = true) => stringBuilder.AppendItems(items, DefaultNewLineSeparator, emptyCollectionText) .AppendLineIf(finishWithNewLine); // ReSharper restore RedundantNullableFlowAttribute /// /// Appends the value to the specified string builder if the condition is true. /// /// The string builder where will be appended to. /// The boolean value indicating whether the append operation will be performed or not. /// The value to be appended to the string builder. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("stringBuilder:null => halt; stringBuilder:notnull => notnull")] // ReSharper disable once RedundantNullableFlowAttribute public static StringBuilder AppendIf([NotNull, ValidatedNotNull] this StringBuilder stringBuilder, bool condition, string value) { if (condition) stringBuilder.MustNotBeNull(nameof(stringBuilder)).Append(value); return stringBuilder; } /// /// Appends the value followed by a new line separator to the specified string builder if the condition is true. /// /// The string builder where will be appended to. /// The boolean value indicating whether the append operation will be performed or not. /// The value to be appended to the string builder (optional). This value defaults to an empty string. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("stringBuilder:null => halt; stringBuilder:notnull => notnull")] // ReSharper disable once RedundantNullableFlowAttribute public static StringBuilder AppendLineIf([NotNull, ValidatedNotNull] this StringBuilder stringBuilder, bool condition, string value = "") { if (condition) stringBuilder.MustNotBeNull(nameof(stringBuilder)).AppendLine(value); return stringBuilder; } /// /// Appends the messages of the and its nested exceptions to the /// specified . /// /// Thrown when any parameter is null. // ReSharper disable RedundantNullableFlowAttribute public static StringBuilder AppendExceptionMessages([NotNull, ValidatedNotNull] this StringBuilder stringBuilder, [NotNull, ValidatedNotNull] Exception exception) // ReSharper restore RedundantNullableFlowAttribute { stringBuilder.MustNotBeNull(nameof(stringBuilder)); exception.MustNotBeNull(nameof(exception)); while (true) { // ReSharper disable once PossibleNullReferenceException stringBuilder.AppendLine(exception.Message); if (exception.InnerException is null) return stringBuilder; stringBuilder.AppendLine(); exception = exception.InnerException; } } /// /// Formats all messages of the and its nested exceptions into /// a single string. /// /// Thrown when is null. // ReSharper disable once RedundantNullableFlowAttribute public static string GetAllExceptionMessages([NotNull, ValidatedNotNull] this Exception exception) => new StringBuilder().AppendExceptionMessages(exception).ToString(); /// /// Checks if the two strings are equal using ordinal sorting rules as well as ignoring the white space /// of the provided strings. /// public static bool EqualsOrdinalIgnoreWhiteSpace(this string? x, string? y) { if (ReferenceEquals(x, y)) return true; if (x is null || y is null) return false; if (x.Length == 0) return y.Length == 0; var indexX = 0; var indexY = 0; bool wasXSuccessful; bool wasYSuccessful; // This condition of the while loop actually has to use the single '&' operator because // y.TryAdvanceToNextNonWhiteSpaceCharacter must be called even though it already returned // false on x. Otherwise, the 'wasXSuccessful == wasYSuccessful' comparison would not return // the desired result. while ((wasXSuccessful = x.TryAdvanceToNextNonWhiteSpaceCharacter(ref indexX)) & (wasYSuccessful = y.TryAdvanceToNextNonWhiteSpaceCharacter(ref indexY))) { if (x[indexX++] != y[indexY++]) return false; } return wasXSuccessful == wasYSuccessful; } /// /// Checks if the two strings are equal using ordinal sorting rules, ignoring the case of the letters /// as well as ignoring the white space of the provided strings. /// public static bool EqualsOrdinalIgnoreCaseIgnoreWhiteSpace(this string? x, string? y) { if (ReferenceEquals(x, y)) return true; if (x is null || y is null) return false; if (x.Length == 0) return y.Length == 0; var indexX = 0; var indexY = 0; bool wasXSuccessful; bool wasYSuccessful; // This condition of the while loop actually has to use the single '&' operator because // y.TryAdvanceToNextNonWhiteSpaceCharacter must be called even though it already returned // false on x. Otherwise, the 'wasXSuccessful == wasYSuccessful' comparison would not return // the desired result. while ((wasXSuccessful = x.TryAdvanceToNextNonWhiteSpaceCharacter(ref indexX)) & (wasYSuccessful = y.TryAdvanceToNextNonWhiteSpaceCharacter(ref indexY))) { if (char.ToLowerInvariant(x[indexX++]) != char.ToLowerInvariant(y[indexY++])) return false; } return wasXSuccessful == wasYSuccessful; } private static bool TryAdvanceToNextNonWhiteSpaceCharacter(this string @string, ref int currentIndex) { while (currentIndex < @string.Length) { if (!char.IsWhiteSpace(@string[currentIndex])) return true; ++currentIndex; } return false; } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Light.GuardClauses.csproj000066400000000000000000000056521470750352700264200ustar00rootroot00000000000000 netstandard2.0;netstandard2.1;net8.0 A lightweight .NET library for expressive Guard Clauses. Kenny Pflug Kenny Pflug enable true Copyright © Kenny Pflug 2016, 2024 12 true true MIT light-logo.png https://github.com/feO2x/Light.GuardClauses https://github.com/feO2x/Light.GuardClauses.git git true true snupkg true Assertions;Preconditions;GuardClauses;DesignByContract;DbC true README.md Light.GuardClauses 12.0.0 -------------------------------- - Added support for NotNullAttribute - Added Range.InclusiveBetween and Range.ExclusiveBetween to create Range instances even more easily - breaking: String assertions that use a StringComparison parameter now throw an ArgumentException instead of forwarding an invalid value to the exception factory Light.GuardClauses-12.0.0/Code/Light.GuardClauses/OrdinalIgnoreCaseIgnoreWhiteSpaceComparer.cs000066400000000000000000000031301470750352700322240ustar00rootroot00000000000000using System; using System.Collections.Generic; using Light.GuardClauses.FrameworkExtensions; namespace Light.GuardClauses; /// /// Represents an that compares strings using the /// ordinal sort rules, ignoring the case and the white space characters. /// public sealed class OrdinalIgnoreCaseIgnoreWhiteSpaceComparer : IEqualityComparer { /// /// Checks if the two strings are equal using ordinal sorting rules as well as ignoring the case and /// the white space of the provided strings. /// /// Thrown when or are null. public bool Equals(string? x, string? y) { x.MustNotBeNull(nameof(x)); y.MustNotBeNull(nameof(y)); return x.EqualsOrdinalIgnoreCaseIgnoreWhiteSpace(y); } /// /// Gets the hash code for the specified string. The hash code is created only from the non-white space characters /// which are interpreted as case-insensitive. /// /// Thrown when is null. public int GetHashCode(string @string) { @string.MustNotBeNull(nameof(@string)); var hashBuilder = MultiplyAddHashBuilder.Create(); foreach (var character in @string) { if (!character.IsWhiteSpace()) hashBuilder.CombineIntoHash(char.ToLowerInvariant(character)); } return hashBuilder.BuildHash(); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/OrdinalIgnoreWhiteSpaceComparer.cs000066400000000000000000000027571470750352700303020ustar00rootroot00000000000000using System; using System.Collections.Generic; using Light.GuardClauses.FrameworkExtensions; namespace Light.GuardClauses; /// /// Represents an that compares strings using the /// ordinal sort rules and ignoring the white space characters. /// public sealed class OrdinalIgnoreWhiteSpaceComparer : IEqualityComparer { /// /// Checks if the two strings are equal using ordinal sorting rules as well as ignoring the white space /// of the provided strings. /// /// Thrown when or are null. public bool Equals(string? x, string? y) { x.MustNotBeNull(nameof(x)); y.MustNotBeNull(nameof(y)); return x.EqualsOrdinalIgnoreWhiteSpace(y); } /// /// Gets the hash code for the specified string. The hash code is created only from the non-white space characters. /// /// Thrown when is null. public int GetHashCode(string @string) { @string.MustNotBeNull(nameof(@string)); var hashCodeBuilder = MultiplyAddHashBuilder.Create(); foreach (var character in @string) { if (!character.IsWhiteSpace()) hashCodeBuilder.CombineIntoHash(character); } return hashCodeBuilder.BuildHash(); } }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Public.Light.GuardClauses.snk000066400000000000000000000002401470750352700271140ustar00rootroot00000000000000$ $RSA1C/ D$ט暃\>e`J{ӭ0mowF3鹁'9*SH2kvyʷ{X|o;Pc!J}YJ LX,_þLight.GuardClauses-12.0.0/Code/Light.GuardClauses/Range.cs000066400000000000000000000341261470750352700231270ustar00rootroot00000000000000using System; using System.Collections; using System.Collections.Generic; using Light.GuardClauses.FrameworkExtensions; using System.Runtime.CompilerServices; namespace Light.GuardClauses; /// /// Defines a range that can be used to check if a specified is in between it or not. /// /// The type that the range should be applied to. public readonly struct Range : IEquatable> where T : IComparable { /// /// Gets the lower boundary of the range. /// public readonly T From; /// /// Gets the upper boundary of the range. /// public readonly T To; /// /// Gets the value indicating whether the From value is included in the range. /// public readonly bool IsFromInclusive; /// /// Gets the value indicating whether the To value is included in the range. /// public readonly bool IsToInclusive; private readonly int _expectedLowerBoundaryResult; private readonly int _expectedUpperBoundaryResult; /// /// Creates a new instance of . /// /// The lower boundary of the range. /// The upper boundary of the range. /// The value indicating whether is part of the range. /// The value indicating whether is part of the range. /// Thrown when is less than . [MethodImpl(MethodImplOptions.AggressiveInlining)] public Range(T from, T to, bool isFromInclusive = true, bool isToInclusive = true) { From = from.MustNotBeNullReference(nameof(from)); To = to.MustNotBeLessThan(from, nameof(to)); IsFromInclusive = isFromInclusive; IsToInclusive = isToInclusive; _expectedLowerBoundaryResult = isFromInclusive ? 0 : 1; _expectedUpperBoundaryResult = isToInclusive ? 0 : -1; } /// /// Checks if the specified is within range. /// /// The value to be checked. /// True if value is within range, otherwise false. [MethodImpl(MethodImplOptions.AggressiveInlining)] public bool IsValueWithinRange(T value) => value.MustNotBeNullReference(nameof(value)).CompareTo(From) >= _expectedLowerBoundaryResult && value.CompareTo(To) <= _expectedUpperBoundaryResult; /// /// Use this method to create a range in a fluent style using method chaining. /// Defines the lower boundary as an inclusive value. /// /// The value that indicates the inclusive lower boundary of the resulting range. /// A value you can use to fluently define the upper boundary of a new range. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static RangeFromInfo FromInclusive(T value) => new RangeFromInfo(value, true); /// /// Use this method to create a range in a fluent style using method chaining. /// Defines the lower boundary as an exclusive value. /// /// The value that indicates the exclusive lower boundary of the resulting range. /// A value you can use to fluently define the upper boundary of a new range. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static RangeFromInfo FromExclusive(T value) => new RangeFromInfo(value, false); /// /// The nested can be used to fluently create a . /// public readonly struct RangeFromInfo { private readonly T _from; private readonly bool _isFromInclusive; /// /// Creates a new RangeFromInfo. /// /// The lower boundary of the range. /// The value indicating whether is part of the range. [MethodImpl(MethodImplOptions.AggressiveInlining)] public RangeFromInfo(T from, bool isFromInclusive) { _from = from; _isFromInclusive = isFromInclusive; } /// /// Use this method to create a range in a fluent style using method chaining. /// Defines the upper boundary as an exclusive value. /// /// The value that indicates the exclusive upper boundary of the resulting range. /// A new range with the specified upper and lower boundaries. /// /// Thrown when is less than the lower boundary value. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public Range ToExclusive(T value) => new Range(_from, value, _isFromInclusive, false); /// /// Use this method to create a range in a fluent style using method chaining. /// Defines the upper boundary as an inclusive value. /// /// The value that indicates the inclusive upper boundary of the resulting range. /// A new range with the specified upper and lower boundaries. /// /// Thrown when is less than the lower boundary value. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public Range ToInclusive(T value) => new Range(_from, value, _isFromInclusive); } /// public override string ToString() => $"Range from {CreateRangeDescriptionText()}"; /// /// Returns either "inclusive" or "exclusive", depending on whether is true or false. /// public string LowerBoundaryText { [MethodImpl(MethodImplOptions.AggressiveInlining)] get => GetBoundaryText(IsFromInclusive); } /// /// Returns either "inclusive" or "exclusive", depending on whether is true or false. /// public string UpperBoundaryText { [MethodImpl(MethodImplOptions.AggressiveInlining)] get => GetBoundaryText(IsToInclusive); } /// /// Returns a text description of this range with the following pattern: From (inclusive | exclusive) to To (inclusive | exclusive). /// public string CreateRangeDescriptionText(string fromToConnectionWord = "to") => From + " (" + LowerBoundaryText + ") " + fromToConnectionWord + ' ' + To + " (" + UpperBoundaryText + ")"; [MethodImpl(MethodImplOptions.AggressiveInlining)] private static string GetBoundaryText(bool isInclusive) => isInclusive ? "inclusive" : "exclusive"; /// public bool Equals(Range other) { if (IsFromInclusive != other.IsFromInclusive || IsToInclusive != other.IsToInclusive) return false; var comparer = EqualityComparer.Default; return comparer.Equals(From, other.From) && comparer.Equals(To, other.To); } /// public override bool Equals(object? other) { if (other is null) return false; return other is Range range && Equals(range); } /// public override int GetHashCode() => MultiplyAddHash.CreateHashCode(From, To, IsFromInclusive, IsToInclusive); /// /// Checks if two ranges are equal. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool operator ==(Range first, Range second) => first.Equals(second); /// /// Checks if two ranges are not equal. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool operator !=(Range first, Range second) => first.Equals(second) == false; } /// /// Provides methods to simplify the creation of instances. /// public static class Range { /// /// Use this method to create a range in a fluent style using method chaining. /// Defines the lower boundary as an inclusive value. /// /// The value that indicates the inclusive lower boundary of the resulting range. /// A value you can use to fluently define the upper boundary of a new range. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Range.RangeFromInfo FromInclusive(T value) where T : IComparable => new (value, true); /// /// Use this method to create a range in a fluent style using method chaining. /// Defines the lower boundary as an exclusive value. /// /// The value that indicates the exclusive lower boundary of the resulting range. /// A value you can use to fluently define the upper boundary of a new range. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Range.RangeFromInfo FromExclusive(T value) where T : IComparable => new (value, false); /// /// Creates a range with both boundaries inclusive. /// /// The lower boundary of the range. /// The upper boundary of the range. /// A new range with both boundaries inclusive. /// Thrown when is less than . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Range InclusiveBetween(T from, T to) where T : IComparable => new (from, to); /// /// Creates a range with both boundaries exclusive. /// /// The lower boundary of the range. /// The upper boundary of the range. /// A new range with both boundaries exclusive. /// Thrown when is less than . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Range ExclusiveBetween(T from, T to) where T : IComparable => new (from, to, false, false); /// /// Creates a range for the specified enumerable that encompasses all valid indexes. /// /// /// The count of this enumerable will be used to create the index range. Please ensure that this enumerable /// is actually a collection, not a lazy enumerable. /// /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Range For(IEnumerable enumerable) => new (0, enumerable.Count(), isFromInclusive: true, isToInclusive: false); /// /// Creates a range for the specified enumerable that encompasses all valid indexes. /// /// /// The count of this enumerable will be used to create the index range. Please ensure that this enumerable /// is actually a collection, not a lazy enumerable. /// /// Thrown when is null. public static Range For(IEnumerable enumerable) => new (0, enumerable.GetCount(), isFromInclusive: true, isToInclusive: false); /// /// Creates a range for the specified span that encompasses all valid indexes. /// /// /// The length of the span is used to create a valid index range. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Range For(ReadOnlySpan span) => new (0, span.Length, isFromInclusive: true, isToInclusive: false); /// /// Creates a range for the specified span that encompasses all valid indexes. /// /// /// The length of the span is used to create a valid index range. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Range For(Span span) => new (0 , span.Length, isFromInclusive: true, isToInclusive: false); /// /// Creates a range for the specified memory that encompasses all valid indexes. /// /// /// The length of the memory is used to create a valid index range. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Range For(Memory memory) => new (0, memory.Length, isFromInclusive: true, isToInclusive: false); /// /// Creates a range for the specified memory that encompasses all valid indexes. /// /// /// The length of the memory is used to create a valid index range. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Range For(ReadOnlyMemory memory) => new (0, memory.Length, isFromInclusive: true, isToInclusive: false); /// /// Creates a range for the specified memory that encompasses all valid indexes. /// /// /// The count of the segment is used to create a valid index range. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Range For(ArraySegment segment) => new (0, segment.Count, isFromInclusive: true, isToInclusive: false); } Light.GuardClauses-12.0.0/Code/Light.GuardClauses/ReSharperAnnotations.cs000066400000000000000000000122241470750352700261770ustar00rootroot00000000000000/* MIT License Copyright (c) 2016 JetBrains http://www.jetbrains.com Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ #nullable disable using System; // ReSharper disable CheckNamespace // ReSharper disable UnusedMember.Global // ReSharper disable MemberCanBePrivate.Global // ReSharper disable UnusedAutoPropertyAccessor.Global // ReSharper disable IntroduceOptionalParameters.Global // ReSharper disable MemberCanBeProtected.Global // ReSharper disable InconsistentNaming namespace JetBrains.Annotations; /// /// Indicates that the value of the marked element can never be null. /// /// /// [NotNull] object Foo() { /// return null; // Warning: Possible 'null' assignment /// } /// [AttributeUsage( AttributeTargets.Method | AttributeTargets.Parameter | AttributeTargets.Property | AttributeTargets.Delegate | AttributeTargets.Field | AttributeTargets.Event | AttributeTargets.Class | AttributeTargets.Interface | AttributeTargets.GenericParameter)] internal sealed class NotNullAttribute : Attribute { } /// /// Describes dependence between method input and output. /// /// ///

Function Definition Table syntax:

/// /// FDT ::= FDTRow [;FDTRow]* /// FDTRow ::= Input => Output | Output <= Input /// Input ::= ParameterName: Value [, Input]* /// Output ::= [ParameterName: Value]* {halt|stop|void|nothing|Value} /// Value ::= true | false | null | notnull | canbenull /// /// If the method has a single input parameter, its name could be omitted.
/// Using halt (or void/nothing, which is the same) for the method output /// means that the method doesn't return normally (throws or terminates the process).
/// Value canbenull is only applicable for output parameters.
/// You can use multiple [ContractAnnotation] for each FDT row, or use single attribute /// with rows separated by the semicolon. There is no notion of order rows, all rows are checked /// for applicability and applied per each program state tracked by the analysis engine.
/// /// /// /// [ContractAnnotation("=> halt")] /// public void TerminationMethod() /// /// /// [ContractAnnotation("null <= param:null")] // reverse condition syntax /// public string GetName(string surname) /// /// /// [ContractAnnotation("s:null => true")] /// public bool IsNullOrEmpty(string s) // string.IsNullOrEmpty() /// /// /// // A method that returns null if the parameter is null, /// // and not null if the parameter is not null /// [ContractAnnotation("null => null; notnull => notnull")] /// public object Transform(object data) /// /// /// [ContractAnnotation("=> true, result: notnull; => false, result: null")] /// public bool TryParse(string s, out Person result) /// /// [AttributeUsage(AttributeTargets.Method, AllowMultiple = true)] internal sealed class ContractAnnotationAttribute : Attribute { public ContractAnnotationAttribute([NotNull] string contract) : this(contract, false) { } public ContractAnnotationAttribute([NotNull] string contract, bool forceFullStates) { Contract = contract; ForceFullStates = forceFullStates; } [NotNull] public string Contract { get; } public bool ForceFullStates { get; } } /// /// Indicates that IEnumerable passed as a parameter is not enumerated. /// Use this annotation to suppress the 'Possible multiple enumeration of IEnumerable' inspection. /// /// /// static void ThrowIfNull<T>([NoEnumeration] T v, string n) where T : class /// { /// // custom check for null but no enumeration /// } /// /// void Foo(IEnumerable<string> values) /// { /// ThrowIfNull(values, nameof(values)); /// var x = values.ToList(); // No warnings about multiple enumeration /// } /// [AttributeUsage(AttributeTargets.Parameter)] internal sealed class NoEnumerationAttribute : Attribute { } Light.GuardClauses-12.0.0/Code/Light.GuardClauses/RegularExpressions.cs000066400000000000000000000014441470750352700257340ustar00rootroot00000000000000using System.Text.RegularExpressions; namespace Light.GuardClauses; /// /// Provides regular expressions that are used in string assertions. /// public static class RegularExpressions { /// /// Gets the default regular expression for email validation. /// This pattern is based on https://www.rhyous.com/2010/06/15/csharp-email-regular-expression/ and /// was modified to satisfy all tests of https://blogs.msdn.microsoft.com/testing123/2009/02/06/email-address-test-cases/. /// public static readonly Regex EmailRegex = new Regex( @"^[\w!#$%&'*+\-/=?\^_`{|}~]+(\.[\w!#$%&'*+\-/=?\^_`{|}~]+)*@((((\w+\-?)+\.)+[a-zA-Z]{2,4})|(([0-9]{1,3}\.){3}[0-9]{1,3}))$", RegexOptions.CultureInvariant | RegexOptions.ECMAScript); }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/SpanDelegates.cs000066400000000000000000000010071470750352700246020ustar00rootroot00000000000000using System; namespace Light.GuardClauses; /// /// Represents a delegate that receives a span and a value as parameters and that produces an exception. /// public delegate Exception SpanExceptionFactory(Span span, T value); /// /// Represents a delegate that receives a read-only span and a value as parameters and that produces an exception. /// public delegate Exception ReadOnlySpanExceptionFactory(ReadOnlySpan span, T value);Light.GuardClauses-12.0.0/Code/Light.GuardClauses/StringComparisonType.cs000066400000000000000000000035701470750352700262350ustar00rootroot00000000000000namespace Light.GuardClauses; /// /// Specifies the culture, case , and sort rules when comparing strings. /// /// /// This enum is en extension of , adding /// capabilities to ignore white space when making string equality comparisons. /// See the when /// you want to compare in such a way. /// public enum StringComparisonType { /// /// Compare strings using culture-sensitive sort rules and the current culture. /// CurrentCulture = 0, /// /// Compare strings using culture-sensitive sort rules, the current culture, and /// ignoring the case of the strings being compared. /// CurrentCultureIgnoreCase = 1, /// /// Compare strings using culture-sensitive sort rules and the invariant culture. /// InvariantCulture = 2, /// /// Compare strings using culture-sensitive sort rules, the invariant culture, and /// ignoring the case of the strings being compared. /// InvariantCultureIgnoreCase = 3, /// /// Compare strings using ordinal sort rules. /// Ordinal = 4, /// /// Compare strings using ordinal sort rules and ignoring the case of the strings /// being compared. /// OrdinalIgnoreCase = 5, /// /// Compare strings using ordinal sort rules and ignoring the white space characters /// of the strings being compared. /// OrdinalIgnoreWhiteSpace = 6, /// /// Compare strings using ordinal sort rules, ignoring the case and ignoring the /// white space characters of the strings being compared. /// OrdinalIgnoreCaseIgnoreWhiteSpace = 7 }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/Types.cs000066400000000000000000000005551470750352700231760ustar00rootroot00000000000000using System; namespace Light.GuardClauses; /// /// This class caches instances to avoid use of the typeof operator. /// public abstract class Types { /// /// Gets the type. /// public static readonly Type FlagsAttributeType = typeof(FlagsAttribute); }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/ValidatedNotNullAttribute.cs000066400000000000000000000002351470750352700271620ustar00rootroot00000000000000using System; namespace Light.GuardClauses; [AttributeUsage(AttributeTargets.Parameter)] internal sealed class ValidatedNotNullAttribute : Attribute { }Light.GuardClauses-12.0.0/Code/Light.GuardClauses/light-logo.png000066400000000000000000000103641470750352700243150ustar00rootroot00000000000000PNG  IHDRL\ pHYsodIDATx] x罗&l$(&*BY+RbmUnXZAPXPE}W$o7[ϝ"yyܙ|{3;gsν תU+Q"+ gd3"Ѯh{YTfIA+TdW\ tPUz3_@`ޥsV>,ֹ|vibiӇ圮"V#UWɁqmn Rkf+˦ ,YtQV/LCx`~jwa6:QudbM^dtxq59K^VYb @>8:i O}׼'mY,n[N9C>X1$^9 SppC`Ҷ% 0!38rd'pҐWY6nIxmT5A~{ ,$ =EO؈ҋȿ\xpCS Eo-ܛ_&0Iy[t4cdOOgh'&K5^~ WZ~pf9p?a*jR6[(+@B  &VcQ9|/4ckօ. ˀ$6pp}a?B @>t)CySFW# /ow@V~[c{ &^ rT0 Ѽ 5ۑjM.ٺ#@ƆNTѩ7 /!uz.Z((sa3Pd6 [TXG8v#!`Q̖Ve$ɉ(fI'`(CRw_DӐ|"6!'J;^{?]?_}0%yAUA*!th 4@Q/ oC[^@'lV]qOEG};ZApBUpd/W_c.@⽆ݥV wp@nWFoW9gџ IpR5OL ]\FnNB$@s5yI>D}R*l|Ѧr*~r\/: ;Cw,+w6dY+qiB2/ٔFq7u=@g>TɀHtġyVada& 34yLL X&nN ~_T; t?}@SD=FZ SMdn1I/I{1z,HY~VKn?ss5vK>=> v(0Rf$ -1ϲ0A]I%V F.X[y[V0~Ӿ];7,h.Lq56`q^lO,x<~z9\HdyPY ݍ?7Hn"g6 :[5v0iSf>ܕd嶉^*=գ ؗ4}͂·xqo/8 kZLNMG)J@v*uxMq@TҤ j\|œI&dx!vՃϦf092x$r>zS"&PC2X⶙0Jv 6iܤ/l'phof2:bqUM͝Bͫua:ƛw-8oٴ= դ%KDqv Ȏ=47ЀwaFcs&,`7 [c(i8 <7$C[%|ne)xf%BMbuCo l9vIg_ "c_H˙l  '5o|oU+g!u[?!)pkin6irz2vcIa-[-mꯚ=7ͩjFlOs `~^ @ڬ,ySǤ5w1+FI"5);f RxtU,Entw垓g$|QޖC-9`tL5 }[KR**)N="[cYk?;}X}9$mn6[qћ~.4)((oUyƿˑZd! еcҗe׿/nuAK488@59ȴ WGs/q75RKd<c܌AUO?~(ft$K?d(fgP3oC+xj`:.o;CZ gsn~b-.x%t}{#)g޽#)u|v|,"mZdծٮ,}G0[_'I@Pq-*+ p5VEc*6~4_WX\*BG!5|+|X30%*{8ktCjq ˙km !)#+!"`=?2$`ghs"$0nV17+;}b , Em3i2jeV6ES-~>I؁^Za8F-Kv v0sT+c-`HQǦ9}3v=֝βeo8ZDvP` BY䶗n&.ḿ`]z '(/!b%!2)XWABpkaլM=&aKgd G0yVZA>#+ gd3W1]IENDB`Light.GuardClauses-12.0.0/Code/Version.props000066400000000000000000000001421470750352700206150ustar00rootroot00000000000000 12.0.0 Light.GuardClauses-12.0.0/Images/000077500000000000000000000000001470750352700164415ustar00rootroot00000000000000Light.GuardClauses-12.0.0/Images/Eiffel-pre-and-postconditions.png000066400000000000000000002301041470750352700247420ustar00rootroot00000000000000PNG  IHDRZsRGBgAMA a pHYsSIDATx^xٶIl'|;K+t1{&@zwuVGYIG HՔ33/ V - Db/᷁>=#?-{axd%bD [(ĸ:HQ.UQW%2 @e;A2c<ϯwxf{1Ts2Qw Y%uB^1B*(rZ!Jj,<5ǿ a]e7yX?qW7 >zOJ52Km yC(`!3Tay8"O 4F\nyaV - Ԧ> Kcg$%J 'uEC ) 7yspsr}Fz2ݱ{4<2f̛ >aV -h] .% l}GhEדqѬ@TmPH_c+ ͜ޤRyQ .B$T)U,c 7@\{@>w=6bpw[!,S*p#+ G")x")i+iArl~ױr^ ~~V)Bc}NA8!z)Xz^v dЗ}b9yH @c(8mg@8Ö21X {[~j fb)r+ _=[CB+fD]ɔvHr ~39 8lp/CDV2ų(MdquJYcXr9,ZZ޻_[""q pzXLf*+lqn6?F\nbM᪷Vڈ/R".+:HVn!=0ဘxyyx[{=PJ(eq ȣ' ,|ƞz;+;!=|8)ėya}B>Ld#e0?HL P>\3:!-xYT8|25׾Uwj[Dy4I#wUky9搉e8`Mu Uj}oXrlrhb>c9]s`Q?Qk'虛M*Ub~4 B~lTIKH/U +!u\ˤz0.u,5B;b#( EfW SS]z4_W"[C^J=Đmi>=V܏C i }kdYt7j@υQfHRCWDaM}׶'tG+ V -`҂G+ [ˬ#@Tݗ6«{Tk?k[F/OCri>Z FL%H9vMr ο}Nۄm[j]_wl0B/6: yE_7q"d%pu.\~>X,da Tbj,۽i3vzT%@췅!-`V -`P*@e  0 [gCO`Dˡ29EׄNk>g&EL5qcE]1>gx@YC:WkOnZ{Rspʻ]>y5@My9!_ B}Tunwz mފR\ \]e+'h2d}wZ*EPh7'rf5WjXX3*ge1u:0PrDc8dWmFL,6+0cbU²|љmMNºG$ "_! Fu\]ѲrlD݇Y 1H!/ɜjPMg6+!'/(%Wwo!> } +N)}Ԧ/Uyyݷ~7Kxvyhaws8|?r8|vjVδ'nH]ZZ2 2e=;7s:f1cF0B@NzDD W^"`B: ǷRH=NY~t0rm䟹a8:>=z:ҿY ZInE`t:x*3"Zwl+^yt6D4 4@"7\ Ƨ!4  4 ` úTKȄ|ˈBT%_LvettjAb8*C ײַUDv ~WZbOC E0xX=b31ĘSA޼6ЯZNfm3C c􍟰y/]_-b.%Wި5ݹ9(j x(C)BΫ;ga1L-eB/EH!| }}={Rzzw ?S/VB+6ܦ߳%TWp*zIѰ)*'Gx Cr%jP0m9^%3'DRq U?'H{HkB/D~/y剕ÂT^Gvsu#}p0 @/ȊtrҾ5<ѡf6?4bgJGmY rֳFX~j⠖Ul~mL ;A!L:G@*E57B:mGޯPWU-sqFM\ =u ^Fsq틕Ji2a0/pn6 &+o!;yޓ<:GwkF3&Cŏ3³{?C{T'ui>k98 ɩÉlLD"Aӫ}xj@i1݊ sF4s#Ĉ:|w{?, +fs_& +2@3p"- ۗ-&Yqx"XІ"4t :eW|{!4a=FVju= XԡjJ9'U =h#^=ӧ`*!Wg*}!L-O-fo=T&-x`NX }aIS0x7/F.OF0` sF4sbz4}g#O>;eBZ3.Ycj9F`q&0WX~0` sF0`#;GQ1F؈+`lszیeױ$""Tt 2p!}" ٤3wR_ FÔ&9mœ&rr1|j*4SD"u?8?z}'(Y)$ּcqȋ83摝#vNBAւGa0ko(GCGm.M37^bN{}h5|X^F -q IgOMb3:cZ3:9Sc 4`ݞgV!]V& ^{X=J k>kg/<3Xn[YRp9RQW?kw7kM؞/׫w0`XXxo9Z*dPsT?i1jQUU gm~u J 5oj$E *=NgJG]FYaQ*WܛO`pn谻œ&;Xw&aN@/5|@nP'L9BL!%R^(:9Olpt; 9͡' ;2+,!& RfI;sMZ1{t{Cݬ, a@ 瓅چPWBHAKjAԏ̩EP!ҭ}x`E+`EbGI`][gKcޜi8cj\1 C6ts"H:ìBgUḡ}Q_2F@X(,#s]nA^³3}{aCR$Zʄ4?AC~8zaĂ|>LWC U6.;19Uί'4qB*WCkl!C#0I [ˉH0H!+!Io[+HP?J:Ɠs˕*l" Jٓct4Nw56c᳆AE%X?t}_{02^)ZbkթWQYwQRN _  bǣ%LFϫNؾoq7Os>< Cۅeؖ|{³8$Je-P};+9 {h߃'4RKƝQXI<^]ta^xzayWCCtTB3:+y:qn[lB$H5p[̙V,HlsP5Wzt.i"ʋ+'|ktG71vÜC?K.s.w%K.kGf6_,@?jDψg28W)1ЋRac6B4y}; Ɉ dU᎛\XPPݸ*;<\c!VP/K}v/`nO\ މGg'4v g<Ef^'W}Q)b~4t0b<"̈́9-K t,;`l5wʕ[lqZm#7#;1;J$3 4BG4=Ү70`OagބNvj[)}-?r'X;q<+ *\ɧݿ>0F_JE[o}%g~[ gPe 1/ۆ.U6k>19 G+;U[ؘø4@*ũqq%Θqmrإ/*D_NRL\ԔVʡC~ L)g=(؛!#YRrrN[+Ou5qz=Cym.^|F<DžeMoJ>6[|.2 HEp/-NpeI%$BFצ1Bа8oӎ:nx}1"q0A1x/1G9Ő8#e[ztXCQz\VkZgtQzZJB% e$2Ԉ1l *TUq87bFȎCWV=!HvK? aUd)<Qaж滣Wc5g0E UA]YJ#:M?Le)8xn@ݚf^ɎĴ۞)BQV2b#C\1G\9FCn%*eWW3yu F9C#1as F#>nş?&8ᬝ'N*qw ?lh.IcDߠ3jF7ig?ur<5Xu6g`t;:1;gtS:L1-5rF1y&Q]F 흾#3oFCI'a48F?Y]3jtsN} g c_5MB{NX_7<-糖BxR?0~iӣVO_LǞqgNcЎONQә4G"4a-[49V`otHꑕ~S~e03$?܃5($u[bFuNs?LvL%"!2{<zMs*,6{RPQ˘ ;F+CFJUg(c<%}T.٨Kj-Jsʑ['_=[ywl1·W^r5=:кOzReGL!R|UL;u1\h=csPJꥷ Ͼ9);Fw9C#1pn21F6JUgI%Vry0i4q>~Α|=y7 0ÞKjp8#;ƪetډE98,_HH޺K8ol&qod b^7+H31MB?´^aB+hskg֖IQ\F{tO*rˮCl9%r.!8LTHY!̋W.nAV<8FJbq9Hܙ: cf^aZ#4?<ͬ\:F{,&Vc~WH yž{Lj̩ev]:|+gLqgn <)L*uG0ɫέƻ#&a#6>ddgkf3 r2DX.nB9rعstoNϓ!\Q~(!ΘG= ~*RDSԸ VmBT0ك[{a!ҸMn=Bsc5ib~ElRXY73ܻH2$p"bsg+2"0۶_֍!nn,R9a9ϡe)#.%c5Ov.843Kgǹ`ʺ;礰|]n>Ӟ[ )\IQ_L$e+nG*|[LIo1bHB* c s!HΏ?vù|UM;`,9tW>׺cd";YG[eu}&ĎP tJ faBv?+%1Oݘq ss F:1\P(S_&W5\ hז'㳋GjD=(:ܵ!TL;/W.meL-6iyǘ${V0 ZaJ.+`Y&ܸ."4V||&PDbrJqGЩ0˼0l%h/NJpMOrK)}}tM.Cs &kB.o#iB9C06j?AdQ:' _0;ar ]ށi2W1 leX2| @5u}-N smPv'CZ~o8;z5zKC18rtbz|s8U7 . _s\gsR*?qbŤC#< Rfl%gx «8xq,WQ']Xg^&}#ź m 5>%Kމ 9Ĕ($T.$$M!9;4fm:Fy! +P[[:\' )ϣyps쉻YӦ^z2jM8Ɠ`r1s\nUCbK'H^lt.Sgpm mkP _kkK8FLR:ˢ9DX^Ֆ=M˕5Ƶ3a̞1k0j~8XňهKvmZ'r8fH |.`M>t_-2Mwa*սqY\I"q)B[sHGtyM?} C 2q8}~l2g"Xڸ,jiUXbSjJk_Xsj\?,=W蝋MY;jy-Zf :5nG9Crq=KULjdDgb~/ ט#3+M|f(r;Ȉdtl~`$ްR:\<B=Lla`E*%I@{gOQ11.PE0|yULzg.^E;\ ܖ}`L0}hhO;4InN|; Qpe!P:P!|[}q)^r. xVk?5eRT)ThRprj]LjkGFrxnzB.6;m?;/l;NBbhvoq/%$+#a?nu1Ǥ8lwރ?omc{kp(< A/].`6* ïw¯\\ ry繝^q1έ 3"X|ClV_i!1Vםje=7cQ 0ݭ0+^nrn–H XVbV5Paaf!溃*F]$4>@:r)lr{aTGZ; !Nu  c<:F8!~k xait xUR'fn% 0`h9C#1as Fc04` & ]@-~%[ D<:mBU ',.Iwi $CS"6Y?U. 0$33iѵ\Өgإ+$oI҈w2` ""? >Ǵ`Whgq[X4tjDŇBCѵa4 Fxj{GO@PVoTOb\4Z; t>KwSĘf▽,A-[1&TFv8/ZaۄX>ٟTg\ʪk3VNSe0 O0{ܡ~GQgb HNJFѭi7rW_%"a!Y^lw@ Ip񨊁yE5@A,柛!xJ ؐ<} [/dy+H||Y avR4ЫD!c/x0?IM$8~ D] *898r9 UgToz1*`+R3_p1Ru/{&[|\X BнeP؆h$ |צ!‘~3\y 9qخ:G,&~Y;b Jqb,?yB0 k#]@aȢ6r!1FnjAgёe{@+o`kw8 ƿ_DUĜ^r|ƴG@ ʈ IFWo ]0Wx1(ap{+~E6xEBC2B'BQ |J= }LQND` y Kch8TqE!YD]b;0&3i0`thĐ!q]AN"Zb2y(LKO =f۪IRsj|hʋBɈ)Y>[-%8; dKB4DaM$Μc&L` & ]0`0킉hL4 FhS42c>3uK_! J*:iHҦ,jNy ^z-y i%)@?,g50G_yRг'? ֊Cv[-|ӀeӁ+6ߐcx4ʡMy#N~y@m6d_*Ǽn+ :O BXä[ hif}S IҞ^.Y֏SxD}#Dd\`KWUg X~ Y8ġ>#SSP*Ok/Rh3{GbšbQq3hg4L`0: ` & ]0`0킉hL4 Fr{ڑ^z Hu '1 ,N&@Ib8LRIig s~S2ྗ7] r+~_P#]hEc˯1Bv泾FJWB )Gr@^94S-~,E#W\餥h|[`ֆhԥ#Sa],F$m@WB?<^92![쭍{BUQ0{eRx֓L9|3Z'+$nth[>Gۤ:Aj>2uZW%C ۥ\؁%q֧eES\G khJbK`0s%:2N@fFIQ  79t,thX9'#?L4Yy 5K'g @%D#'UI ~F[\ ' ^N@.'Bó~Еh O Fmp& FD#q4}& u3g {`~IH:lrpJnEt&nreG 5SOxgv-%+pv 8%iV CϴT:MA4SZF`uӈp3L4݊Z=f& ]tmѨ㐔4$'%NSRG|N.\B^En7Yth懿㗷G 9z&Gϯ0=bE7-HXw7 X `|bZ ,|)х)?g\ab<thSZ4X|3뜐^mtw>Z,k6ᢱv TⷳT4r%"aTT#]FMu ’ìeX"qsk ِrX[~"%/!$CTQy 9Ddq!b$2nX+K H͑/8ArH,!%˄eq,!BXt}9DG=ya!y5Iu?[FBƓu~\HĂ9l$BC#t<ɾ>a;ُ&`Q,,EeL4:ͨj~ rGhiD|*B_\Ӽ`az3f5&LhdVi1jDyZS.y~g)ƏFbLrbK/BHNǮ9%koU7s^--,see7/aY!׸I IkPht2%QlJ@L eT Wd@*M,ЉTy#Ūٿ8咏h}KHǽE([ 9zM*r[r$x\Ǧ{i?g \Rͱ,ez >TL)d[fG0EkƮEJ VYg_O!D4{fL&?U ?cɩc;$>km kvXDM∨rrC+h\y$iN0q)9c Z{`޳Sɹ\=)yӹвYce0X/8muM,_ߟ_B~4xDC ajXހN6*ژc2r|<ohUM?5XaAX>HhsXo7q/11>3%ODo{,N.8yz,)OΟSv􊎶 hc6~Qy"JXz,Tr/㜰/$k$ց_9ygq4NaxŸQETKr冩[^Sc߄s𪱺BG46OM@zV,┈ ,L&#>Fc dát'zģǿXЄ2ߝ[z0$yu>X-,zO{5ODhhq_}\EbeD1q̘u .! =BC2d͐7AT)H<|:HO-$)$LJ&LN$ib|\؞'5K!i(,B*q:VPoG>ʹ.%U)9|ޟC!Ż8pCxP;_p%C? (~QC/o8N6&0ǵd%i淫,D,5N!5jO" aw`pq#(n`.VJ8,'<3/%܊b$ 'E42H6fjx:fJ],'D'nK$? ]J4"s9$qH!ƋB<JhQIGIȧۑlfh#Q'&yR2'sLABCVt$}7x!K~ӧӧM37R ,GaVʋ { RI[|t91cՌ ˮ]L?Oa0Zr܊?eX̭ÖK4ѣ'mk8認#bw`RS_FOglPgh^ KMuZXgwEBJh[D|~ %虋Zr:#]  i[@s6 ađji-lp>v~Hiqmt^!As'B' VN"%j//;lZ a,-EL@LzG#dosdBRD%sAtA=B էgE\^5/$™IVBxq+R-]+ [R-K VEi~_CShFtE+,2ҶI;52)C=符9w/N w61=|9p,,+mYvH|s >e(s~/>8zQı#l{! Gb$MU۳Eϛi|>x"<)ŗC‹e3VL~ Ӵe}c/>?ADn~;{"cKŨ)1`oPVJ8U? NFDEDșUᣁ.DsD(r2a2: 3Ym :R8@xFgU`_0,5z L9p"3NrXd  BxQ-bd%Ȓ5MSC0g46Z6+ W[ xP֕ GeYB~vf,!>DOJsB4jʡM*$Yyp%5k&DaF|߅23vFjr¡jkeH BSVȈF &YY:/pIMё^x,,,ٹ5fм\݂"iX+㈆m&`.})J1O/܄HL*,CnVͅ㚁DXϭӷ$:alaZ)ވCF\HMA4%wSBTC5D4޸bbT6Rl=aj z0_E1i Ҽn5 WjeDh~ ?& NƛZ4RC!!3fe/*]N4/oe44r=h`<[h0  .h0vD` & ]0`0ECR!^ٙBsQ8&a=t$UяlzSodHFmH<^ip̦o±e l}pLvbpL! KKነ z0).B'7y #kó0lc3bϙ ,>yc`||J98{!; %(Tr)lI9C"+1E^@+jrye()';T1pKF6E'Y_tY5JKM=5$-ol ݤܜQF놀+ }=qMZSAuDq$Y6\eH &jb]S-;9OkG~o۵&rq`T!FR:jV]+BK뇏.C3$Ug\ɹ*.b]E cL2B:4(Ƒ@!ݒŠr;""?:xy|eV{@W7:0oDpT-L,"Qy?#2LޞȾ&aWUqQڙLn8FhMB!(:ܑFn`Apl_utR+}eBh &ܝkIB:\ρH ƄB dөMg}x=bҝ ajdd_x| 3KHe;'ycj2𞙕4,\p;$[]%Q|'g%^չ*SYl^ڣ0lI}[AV0 u :B6)0rZ.Bc=SV#قhl.Sg)\Y:}ټŃ4Nt{t.F$9_'6t<.by6 Ӄh-׀1V DZS #0Ju 'M]hn35z7ˀD+ !!'Dx`4 F``0 .h0vD` & ]0`0킉hL4 F``0 .4H"_}Xb$& Fh$@÷hq.W4]PND_O ؐпА DXR䏁p𡣱1.ƚ:46eCӟo0*&$A_F_~J"uhb" SrN& h`0>EcYh,[Kȟj8'/X`BY b 2hҨl Nj\dF`A J4t7Ç@!I^B$v ~%mb , ׉'([&#Ba2u5 5® F7@cMY8s ̷qѵTѨ!53.L~<Pb cQ(M-I8>j?t~ gy?/,+=:woe„OIw\٤A:_M%S_Z@q-?Gq1?a+q~b΋IFu&08qpr'a#q0:`0րi P.ްMۤV9_-0'YNy\$@a D>JM$7@!9F3r[ ,3\64тܛ`kEZqQ= 50^aPT#)e=ReEtؚlG\DKPʐ}B2/ B] 2)PU! do=::,H# ݏĬJp!?~ZqFo!43Y]CA~˓א"lAUS;Hc=iNGe2a_uU58g9orl+\ilH&:d=q XV:Tȏ-CH.6oBy~0oaq~3' =N}{}9O <*QKBe 0 Wx"&EkѼn!i_3&Xx8Y' r 1Ϣ5Oݴ UE"WUqv 7`cHR璘ɺ!Q6uȰ[Tf'!A!R4+kEv!T)a3sKʤjYze(EFdy !:w8׫z3 u[ q@ CN a+Ti0Hh_Hx^8p}g=>Zc@Qсx!kL|m 7Pysl mPh,D}d! %9`"{^XDAP w{J`yR5 I[Z# d>nZDT㹹 7iD`Y!}N}uΒ뒯i~SClOe9DE9ohk "*j+Jaҫhȹ2V4"w\[zRioJr,š%ɝ h\DE#i$9RF.zF4& >kj6] R[QZN,'\Rrnݖ+u:+Y w qEHΥOP6jR~88#6'aNѻ}]_KA!\Yk/mN&'w(ȣOXN+Fc7Q/Iu3{p۟~w B~8}e_CKEcO 5J:;ti<%\#/kr_L1]n%;Niv4V`0:-*,5Q>0c,OUlC钢`0.^4 &P'z [4P{Q-Nu.~Qx P%#VUY-$oxi.ECw0/¾[B2\BHSqer"$QBBkG apѯ\LQ4@ƖQ<<8?Q~{*ܮȗ)Q[&*jKq5qT!s9ڞ$^#0߈? PVS9*3pǴ-wqc}KEECwmh]!rUVa_LjZTa¤ Z 5 O?PӨ/ġ:RbU$rBZBgڭ;(5RQot<& PHم$_B| G\BBl7uИBs,KK Wq$B( FzN/;amL%74OLÖ Kf d2݅'^7G=Q R>nMGh0ck< 6n>ӖR`L@p |-RyÇ1hZמB{a9Wfr}?:$Y n8'* .DBJ]1M) ]8&6DeʫyJw<ѳ@g8yR4)™'bx12`0L4 F``0 .h0vD` & ]0`0킉hL4 F(5R 1?xK/A7B᤮%+2N~( *ȩGQW Xlߎ8J SAhQ,aD8=Ng==^o1ƞ*@k b.KDu/C3h )`o%L{ _oUvx$!Qb (ekwdjCx'W;ҡw6Խha-^4Rt(q}r~5`0:5&" DIk ^Gh ktI޹ iAA1O?(P |9Y NN 6AQDA4x# &x,> (3~+FD%5WɓRIMbAmRXAă0Ɵ$ϰF 44u\켰)1=n nv k kJ'f0FѸ6dDqD XO.%54"WfQLuex6\YAn3 }sJӴwC2a&4TE7DQaDnb4FLT\4zo\__0؄?S iD`tmh0vD` & ]0`0킉hL4 F``0 .h0vѭE#;%,*D RHkkQbfB7~ͥ:5dBHX _f*P-?>9º ҵD0 8GIUUqp @fOG:< XaJ2P-Ŕ& ýb"LQ>c0X w`ı8klw 4>ZOxd=DZo%C'@^_?_?q#YQ{rQAD4f- j1~VD ҤC=ds"E ,rHb#+;)2]x,vhky 7~B%f i{mD",ͼ$TF5ioO}hFPi!aySeMêXb.- CECoWq;y.-vBrkotڻH%ץΌ! Q4n-Deh%!hHң Wo!Q_t*>TyGhüP`8a}:F1Ν= H~>ϜIr'(ĥqB.⋆@y:y@vΧ.[10Q#24$]hėa8;%~U,6 ;b8% nLZ8$Ų>sܿRZ~U:/ +|4B{&W_H򫯑[ŏj>hP >☞Գ7 ̽7C5|3_M$\_:xkƌA"4cNH!d/< xc/:'b ۯDos>*iX-\A -3ujB!ݒW&둿׾(T]ÛS肚$|s(cKĦ-}=֝۾/1C1,Yn~m$z03`1j&a'߁JQצXy_>c ƃyg<5*K/I@| S$HH W;~^r"S/#&"%% KUu $d2͏ S%L3@I<*. HΡ'H Ij0TTIϪ;UA~1nGaK_wGhH\d@B\ Ssѱ o&)K4d/d0 JXfN/xEIAy) 3xC\yB&☟_hn)@J*W Xt^Ȩak)]Ґ֒0Q 75𭄖)m2eß{h,ҡ*91tV /8 0Ww,߮S[2^ BR!#Ql1b,3L@@so&`q m %66d[Q4M:z9W Kn%Zx~6,r| ZF!XJ=R "HxtdR 0m!j FgѥD# !<h!Y>PJj`5 Sr͓aCV@wcуx iBw r`t 9r5TP@ <'*1HyײΛCH)y$]?C(iO s%ybzyt[ݰ?fk:mht-ш/98p-& r8N'Sat"D\nr!(pp=rOc nqX<,'jd= 6&NhDJ1" vqpEͤfA"$6~׿?1{Tc騋KM?ν6aO|VbMFd~_S%s;H#hL#(6MbIe$Nï̘טht: Fڊ-7DE41 54q.ii|` [3c>c騋ysNռoL4:3fkL4:.!ٲ׼mYT^-[F.6ZҘht:OK4%ɰ,ָyYcB˨pfaY- 8Kp3OG ށhX gIegL4:>ow%I][1f%=kL!ܳ% w%' ͊Ȇ〮5˅tdȶ4<+/\UrqB>ؠ6]6뮭WH{tSXޙ8{vVָ[06ơ(SWٔCw6\p9]8 /)`r[BS8 "tu8>GΣ#9r{^\ dA"adbn=х*$dDek:rMxe' "±s w>uB3nbD3'`=wSi9nr)Ra+Dws88PH*9!ln^m,6%=&Rk6o5#[4+6ou/?]ŕ}aouXz'jpjj%+pN{e7o^ kgjL4:iTѵ v꒻b$<~&?")zY)Z1|M Le[\gwKaw c#C*ôSDֻSm{KDcꃂhYxQ?z1-߆ad`3z1ӵ0e\+fע/idr!kBTV& uz=sUFS'OR܆?Uv" 8>~#X98]BӋɂ%h4,?j`_x+F\K mJ&/B~*ߟÅ`kŘ9v kmK&ID)K0qq!^b^mgkL4:i( )#2hq•g ֎$~|~5"Is%~0>I UbH<ƿeʧ"XMMzr1iSP/WXcn8oXU$^GGd[ϫƑ9?M"-ѹ5tĴnMbI.Bz#/&ɹ(!5B*Zr%5/ $)!eI?Rb)V݃2c4nr܈z2?yrc4q( ;ۢ*ar z>Zz 0\-$%⺼yHyVF. Kcy#4+O|Bq. ˟EV-414[$ $YvAA M ˞UшcљGf!3̘ui- VHDCD2)QY@er,Җ#q>͌Y2Ok'"%DGIo(vRTBę1*׎U/].#38`T ƳK0`0킉hL4 FxEC!w,S& >ղ9OFY)*Ÿ&㭛641 ' ԓ7Ņ 1Y_]lԓ"_!gwP+ۢ]_⌅֋P"%ké0 mÛ,ff׻h ZePC;qnH(;Yp(lQHyuҚ Khb%*$$ߥ@!';9%SW¡< Z T\ٯCNp%&5B,‰.8끋N[\b]SKK3o`ۘn#Src Wa?+EX$)i%XLަEnB4W)L'GDoңVa[l,jg Qc¢0 I:8-;ۅ勯Eo"].\CxJ*H*},1&ƹ|!Xoa_쭸Xlg uKtbSr > Sȡ+ Ooʑ’QGל4@VTb.±d!ޚzL:>TLkY}8bX:5]SQx "{$6_aL D`9Ű,%+ઢqf"s.IdVF ǡ#@r 7pQd7#M_S/!:܊Ѓa%Z,\;,{raUZp7:ysn s5k Śrq_[ȷp[ޗ\t4? 3rB%V](. F^.$% sJ0KcȕHeB~+N"1k=B=ONjz߷[<8:[hEhHΉ9"̠ԛ,)$Kht /pM#=چ(_Qv֘|e82c6K_7~C%uyKF!tr=P9wCtiNt| m$Ǫt7Q4..xUUv'鯅RQz#0Ė Z/`-77.|+y:WWn$t52#|usyn<8;V(1NKrl?!JO5$đt.WF[74kG†PmW{?'A&[y'jBh X`/ƣZP R_bӤVgC3O΀,W'Yx2^^=|nQb)ih&&mPW[Z EiUӄ% .#!cƬ[XDd/]B4?_hF%1)3f]*+"%DCIT'K Ex&qR"i_0b$/|ȯ'SHMuI(1CX;Ni;rؒq.{e ^yכ0$&m3?DqG7Fv[&p=NQZ9!,̘==h*ś0әvRWcGHWm#/'9 6m?+ 9p"Aq!p |R:Qy28|ރZ̘=54'ɨ%>ߑM KJD ;+o%@RMvZ,d4K ,BQ"y%XFwLil̽^oFXF/~ 2KHaa`УZ5`)`6.p'5R8@#8FOpf DLQ!qY1$CW03fOl't2P( ``"^.!ZjdTTR fTnj ,C/<q+ r褨CR th EEig.%|{1Cr iNDp„?ᤩOdMeD XIB~8 ~(qϦ' U%ka J4Bx#A`jJDClqW 2#3N4"5>ɨ(Xu-MHÁ v~ٵD gXcXE#[ ݊q.G3)&m3&- sȀwy},ܳq>K!{ICœ2}eU(ʑ/϶7h=ie%B5|x h0cn;{,:EHFeːR$y^mBX|ҌL$fy2TаLCMϗ?ea`)vy1?M#evB 5/B Yde6"pgg6Qjydp3lauyfg*7Qx-pRVL%,Ͻ33{%}F,ًb9"lNRP1پվCS`h[n{ ^ԗ'􂫤Qazo۩rћ][F5,olk;FA s:57\oͶ%"3"HxrMv:LēuG}>AX@lR lq6/@rFAB|a+Sao.IHs4Y 'N +OLrŚ&9E;]֏܈FlJ:>dhy TX \1=Lp-N>E}oނsNQ0&;jGdn-biM$wq I!> EqNoF9h~1j}y%}kKk[mAL{,'KηGxXV8aɂ\<"ֺ…5{)Q\UgfÈ.w=ZF?MD {t nVn <àVwۊOOûNB F9+ fZ@\I)&1E\.MKBT* &w"(iYa+_`"Xr3GD扭C=YCCEC &#@Q!6" wp% s$XR8LB_:9$5n_RP{qXi8"oIcAP8,s f'bO Atp* n'Ak&GLq7a2WǧgAnWbʝD4䘶 z&"B~E v_ pҍKsxFf^=8C? 4|.0'@|5W|1xH,n~NIJ2GŇӮX} fE<_3?`q'h;c F'W&]0e5b4@|bg # jr/U-[Fi0[' nR_]\4lob>";N9bZRMƓF&OϾ4iCr_̎wgggԉ47 a&׏l/Nj6 &]2Osa{:gulm$H J aof _/\V-UWiz<,>ZyO- %onط*~q {Vv{3jTd*V6nU)jKCl3?X ѫqz WSU~zWCUec^w *EQaEGU$+^Y&f EZGo~Mx"_Z֟WP 5S^k`ǓZa`Е3ԠMBba{4JōUciQtkw;8sJd@G1}TT(5H$(J! 76ځ,~owal~ҐH~U!H?ҐH$4$=!+ DrOJC"ҐH$4$=!+ DrOJC"ҐH$4$=!+ DrO4J#+?F鱊۵^F=1ϭ2LFXk)T?%@ lKp=prfgB?Iܕ*>zʸxxf%۟2|[Th/4,+M#AWkg~Fj-VvjZ+~'$̣\() $rET`{]};I̶` XEYRf<%7h[˙YnL>Eniq)䨉XRBea8%%XFYgV90RsLoIJ(d? ꘺e8EX#I-+&?Ӗؒ  <&^謟 2"{+).77G= )fԖ:2 Sކf-L!ʂ2c87n,<&\R"EyeaLRT\b,6v[۷RYoK" y.*)8F_j8Im#wkR\@LnoFbyYi"Y+>F=6߫=EJ9S Ja^8vUu E\"ܬ\K 4̣Ye%|aȫ(I8dI,#oIܪ*؜tkBKfFjQYDS8#gWջ7^Ws?\"|(S:6źP|bHF:6W-QEM~='=zP流\6>.!s=gWMdg_{0 s VUhrsQtW{9=I_[2Ywiae* Jؙ/pWܴ,O1+ eou__[NJxCJJ#.z-{%=d~&VaK2V*=9q_7 Ϭj#˞"ͣi JC9mhbe`$^?rś&¯$W/+̕F) ɶ\oOI, /|ժC( lfGbNg\o ܰ㏒dsE& tQ޶~Ϝ8eIsQh{QwIuy1mO]Q._R̗.غdW&,>>m0>9֝6D)Vl}3.ݳOC"UPI""DV ovYHYiH${BVɕƣH$*X#0na{vQzư|JlbؖH$U#vNO/7цe0vѯ %EJC߼ekuh @$+JC"/Mid LJ=m؞bf| u! 6|O#wܰ_{W`@ ,64. ]DX5_mgDOmv5K$D"ߨwpd4/DAI&?\QqP~xC7{49Bz΅eKaYBT$4(GY_oѽ&Cq.\s EznWK]\rBqU(2öD"H$ 8 F'͆% K0l},!&~gfaߺ4Νa.§=iT}s`.H+1:8+5˅Y#`M"H$]FQ&Xll;z @};N!". n\=W8Bpo&GmrF)_Z] @K!gUHB*!p|A$l.l#,_ 1,jhHYFFFp4yQ#K$D"ߩ9k-B!xbn1H$DD"H$G D"H$ oJhhav_01~u(a!V/t%¼_?tN#bntk d^~p1'np~Ac5 W\³nng=Kۼo'F[?ArIοx~;aiϝd!,i('uS?џRp+þ6{22qNƼ~(OvVҕ>8Ӿǃ}4g^~sCEڻ(1~S \;H/kK͡N|vBxdQrFhv}OBmja V4ƒ awPY0֨Jxi)/ @ E-J_`qPV8#;S+`%!Dޞ yc"u|H""~\oEu" N~yz 8CՄ/ۊby'HKp tTX2J$#&5e#ͰH,p'Zs3  ;Z/ (DŽ)O/c/)Oǭ,}qV> [H`H¡,?d#fWӅ:-bD;D;,{v]MF Ӊ8GY78 UcUf.#g%kTYG`߿ĊD=FQ"ҜͦʪdɃY'XxEq=9Ժ~YD fMɬ俞=]Q6?IJGP^nI'Xx/JM*V>"{Uw#0GMqVk6KS8kj~BҶ.Zxn0KDE_beo`(e'6{O8͘őKS/XGd;SO,vTC3ָ(Zװ3~Hq I&o!.ckJ,γ ' KߛFxDY3GX;Eޖ,t5鿼֓4dIM0+0:d@ rE4c_`/ɢqCc31%Xɉg>5V7p6xV5؍˥>ܓm ~?ޏZp#$YROayP$:AP&9cvƲ^竓$;=͚>u"|-}NENi-?|µ 0K7NOceVa`N8ݪ,Odʚƺz=]V|el֬c}9YgQneMrt/>)y{]_Tc3>?%_Fn w|ƺwr&;l$&YSثuO"g:I2ۆXJWmތ؝ Vznl=DDZFkq^W',էmZȡif 8_q >Y "jk_.šdkg/]o5͖?<q\ffseW Z_W/yw aѹ;al1'S[F>+{=<|up('k.8Q ?/kNHhB ڡOe)eϞ&]n/+UD" RhH$D"i0АH$D`BC Na>8|h4s\T•x.s1(2e>F{J$DswQ)2 Zw` 8h&Bh+B(I"ܤ)}'_^a8/Jt#1x;@oOn8D)&J`?O[A86~fP^BpX>2ԕ<8Y]Atցqcx5XF b3)"~l3 "Є^aRWiz&ېBC"H$ ,!ftu#BC!$A0-s29^0aa!29}GDpHDIbXu m.^D[IUcvJ2sSftkZ\I{ffUVu 2h{]CߜK!H$9wűXwԞ 6D+#~L&sބ& !xY?}üS'Dxq \`i ~vgU'괤8xzQAlbڳx ьJg91A ;j:&2:}-"V9CfOD"S1 åp2qɏ3 = ,,\}| mE8%TR}S/q-"wpj揩bұJ.Z쓋(%(:Yi\؊}r vddb/DᝒCx'. [R,sJ_er-&{xuRdw ;L!D"H+?`Pɽ#߲wxOkYNN깗_㼯D"H$ )4$D"4RhH$D"i0АH$D`H!H$BC"H$I!D"H$C D"H$ D"H )4$D"4RhH$D"i0Ih$º)0Eb-Vpxu2bJP- CpN/j6%97XF+ l.yG?j :-E\K&R]e(z05 B:)dwNoEw?͸ H$I#B#}GS? hN -qѭcN*ugA[&z%rC]"'Y++zeVnmӵTfG{]VIf| =rDls}o]tѫ曆\V"H$FFEh1$|uP>FΆmZ_n4\K2D+7æmkh>_=v9]ࡷ`W8jf iB 0E&li]'h`@kx L\* J Kg;Bl- ¦QJ 7糍N*BhδqwRD:B, {&Whv5ppPv'q-בSSh`jgÇGtŝqf LY|K6mW2:I$DXwG7px )ȇ_AS͗𘈵~z "' # 1skgIs dt Yn:o,hVIt0C?Yg"__ -Trg*) ڡl>Q@/4\HXE3K  p\krL.Zf8'4E~2sLz4.khp"8UCmi#H$ɯG#@Z%\]|/G MAjA_&Xh3C[Z tixW[B +{E^Qwi"N*UBj!aor(U RO4"\ I #"\v~:)J@[ 5{&a[hq_XLZQ9eFbsK+{L"TS*VweɹEljNh/AQiQ "ae+W gBc!H$GM&laA BetxxmO>H$o )4$D"4RhH~r VQ1 "lEEurV"H$'RhT qtO9I{7_]˞qiƹFg!wWiNj(e>d㸘"NhK8rɄ賑޹rKQH3v~|GyxڰՖ#>_䱁{I)_7I$䗧 ]E 1LfN'2| %d&KrN!eT[Cj~ e$%Ƌ+5S(Ɏ#.Nx5A sHN/񩨎\2S2(5LДٚt3O!?܋FZJ`)[GrP:3'y&f/fYhyƓ)Ǘ0, D7+1z4:t$l^%TO鿍ԪI=jaOj9}{gl#7H8W 01mrdTS~[XFUϟq7,,Q]Y1vv|fOZ~" Y2'@eqʁģ#ߓAa 9|BB^yg@K嵓!{5Bh\6iGh$˧'?BC"Ho`;Qv|8 o4t`yr{-{?BTD"_B R܇,zQ9Av uzyLL,bk /𞝱n%?X6jD"H$)?>& c:d'/I3'4%FD"H~;HQ/E{s~R57/^~29fɊ]6 0H$7D"H )4$D"4RhH$D"i0АH$D`H!H$BC"H$I!D"H$C D"H$ D"H )4$D"4Rh܉2 IejC+ډ^i,첡wIrC=xz]O/ N }.➕ɫrڙ/VS=@SWB|9~Kڝp'zt[[a8r%>7t@ >\XAR}+˖gadSH>lX=w^⫣N 8g"~d3K$o@hٝ;ؽg;]!(W<8wc% ꂰrLq̡DR 28oJn 9qe 7α}|^l9G{A.ҠafӮ?ꭗ-!"ЕNl d"~VvSI 󥻉Sj [" Ql-TLKM2ԇKƕ퓅~ڋ),+H$-496e^l3ۖvbv?udcyǠݮ qi EZU<Ǜŷ\h6'jw5xI6n 64-|2Pyig=Mz>7ٕT /ڞpdOf[{1ʓiY "IUVcn(N]`~Ֆ2[`ci3}.{0)-qկ/H$ImВw)~SMR0E7z,B.>s/dЋEz'ƺjÌ1kH8>:A_Ǯqh- ÝF#^88- g790z4,#Pnȏ{U%]T,6K=Zz4F_^ƍ꫓{UYD"Ӹ{4*4WA ӃnC:Vx1- <_6ϲ4)FwNc}|{ޅЈ`G3\$Ó-Ѡ~q>:>݇01XՖQ^̰sz6ͦLȚ`O:^?h t4 ŧH}֕ɵFA gGcڣDRA d$Dz%mM'hݙ ESKqȅ6̴dMǢ $ߓg9]\~AL>S6ZA>'IҼ@L䤿!'ځpZzSNBT;=4%j)sÃAGƥ0}!lj&fNiS9`aX X"H$ oIQ(f3:;0| UM󽠭f/PCv|n,ocBH {6p:t®b"MgLȌ1όd#y4?/#vuT6yZJMG ɋwԆ\tO%˱/KI'[4>V|hj@Ei1g,U CmoR { UvgMYt-=are[DM'_$CVcaeBTOCXe)8{4:oz j"O!ҨZ'|g.v0gxʵyN Y?5V]%f};tcoX)!{2zbҍҦ2`= ނ={%\EhThLu$DLУ1;V,;؜Z)ӕl5gIx14=ya&p㔪ӣaAeP´=5Ƙ1ԕaǮ]N\*БO؊+مY~xB_.4T*Etp/l ?D"iBCG~=Gz|#%Zǟ3#5^ ] .K||٧4iښ:QKڂ3>m2e|hw/1l=7xS(6ޝ2ͭhߖn֑HPג=Dt;L(R|BvȊ>¿댿O\QVĆ3DO52|]-iwQ9#=̣Lj5{* wsC~8iuWjJ,cwsACho?8%M8ND"HFF;u1YF{DWYƍ/3%NJJ$D ;%dGGHPPP^ԗ䦒MQ]&%X!E"H$GC"H$I!=àSSD"H_и:XEʴPS@7ˠ`N H$}w@Ӻw{0{ >[o`a|,L7SH$D"ƏC2:U "DH aɺ\ CVATD"Hq'Rh"l. ~]gb_"H$)4$D"4RhH$D"i0АH$D`H!C8hn[XMR 7\ׯU#H$?'Rh4Jtdf諏F^1};uɜ) ̷0wp~C]u$7<_~!FG!:6il &w3{5EpIlѡ7yF_2&+j8m BD"H(ё|߾D{Kz%&%'Y75Zȝ\(0ȱŨС۶asF7#8 *Kq;ȸ-ש(Lvct&В{9^vMAl4%C[ǁ!Uk7txO'CWr%=:өSG:vNy(̤͌iݮ=me:WcHq]=s v>% "y;q|kCs_-n=w?]ԉ;ӣRck87#=8S_5XWYݐG_da$yD"thz{^/jҚ^Fo9/aGi+wƋܾj~ [y k#y&po]{ZʔD|,,hV8{~s;PbYP0+C_M'(VETLʵt|7Uݠ'hPE!FĄ!#1I4zǞg,3_դi{)։%^8dV["ո]?O ܢVXYs#4wmvy-?nɘ MaG?3ɸO١ْwUY"Hhz4&6b3s6p${HGk?#7pjUDy kg| Lm> BcUnTd:F~қgШ!4 ^lmBF_6 _=L㙷7eلn^[MI8va?$&ɕ79h B|ܻ [gIb}|B#r[sjv %bkcgx݅Ff>yߕlRts%FD"ߐBQ#3>y)F9=kno'Kteox//>/Ng}rN?<Ͽ›/eÚ.0#I{.hzA9GL_$2Va/u/'Dr wJ$:=?F%n S^ъRӘt*nU]>eE"`^Ǻc/%CX.8y"w҂BJ*t*@bM~gFaDnsBos eCmAy;RRq1ryH!H$ F9V֢9;4AI$⧎Vݵ:ĔKI8z⒙msbs#+{2V!W UP&{-԰l}1a,P9ax#6,{YOpIMdxlo0 ]&][0;菧{FI#RBKFF2&I~H  D"èca ;\FdU7M.0@^@dT!"LBQb,c&܇Ԉo`VP3al ,5h腆mS]IL`+Hf!`_gSUL3zp'ʴeD,5Ö.Bnbc!NXaِ'!WT5+r"$$:x)H!Ob$KLC]L,abDc,oT D%c&\gɡ)̾ȕb4 #9y: Bh(5* >F7Q!u(ʕ\`r!rravQYUBcc t7r9\Nd &h 9p"qNdMjP #'U(7 }UB#8A4!.td$1P §T& gY*qUl!&OzFE B&MQ3իurPuJ(HFJ!̸ *4N qj2!4\f\@ D"i =;cI*!.2DG+2nM*+dYBzQ*F HT݋ί1R&xcؼMTRrj()'ISTV^7ZMOSRZARYCN[^Pϳ|Mb(qUc2JD4"t",vV+ET% Ĉzl"|m"-#D"4D|u"܏H!H$BC"H$I!D"H$C D" TjLK^Qu}!"HTT_boߟ~x'z3M!,~ʋakM"4Ի\Kna9Y%8E)ybjkt>EeH$iB(@22v窣#a1xx(͈%G:SH,#˃"5b *7Vfu,$s+R? !*Z<ݫЕBj0@7~YM"hE_\ARn) |lb8N?#PwH$L#:B0xlᤸkpp$*pYڇ&m'p$(w͏~ 2.zWٶISyN(VQVxm:k=F{ ="#9W褢̀}^ D(ԑVPFpr!aLglyI%/4jp>dSщ,n@SpweAnt_d!1`JLȰ]^ʈʘ+Lu?8uS^u+3h>e$ɏRP\ATf1.Qer5-IWE%b4j|Mu]u.ؕ`n~CX~:7I[pKQ 4 2 Vb zjޜ*O8(#rO_?m7#Fz p ,] s a *\E|9]G‘j%=]Xg3,NysL/RH~uH8#tO("cz.H~_tDec#iuK㘰 ޙF]"4R`ct'ʉ?Cp&ET"i_ok8Nd8mX =2BC"MҨƯAyy1DI&/uQlbOz@Hh( 1D^gXi]셺BJp& B - H)$<,W΋4i?%(.?iCKT &7_Xg##W/"ExjظUÐ} v(§)D)f)\TSUau l _V |+1B fڈ)؝Uh>[Us+_(\"x"OU0jŽ s*7bdCi7UxsH_'&M_nBCԹޕBFnIzzBH\"2WfnF+Y*{! D)! FwSs@#RaD[}Bq+8Rx %ľB#V#BVp@1S£X0<pyqQQ !@D +X`+|Li$Ls"&M_4FfnRhShkX\ѐƺI ^a$^3. Q#Dy 0;) B#@4W_h l6 Ҟ0L!B } 5o"?(; 1_toҤIK+RhShhXZ.o, i HiotBB4 :)s=. P{)Dea]4^BDn"ʧ"wSE]+RhiB#t-Yz (ȓ|f1l4a DfWR]AkDUNX!lxVA6I%ǟ^B@k7߷'/d&S+*Rʈ/r5 LnxVK5HN+R&%B=f0lqW}Ey0v;'q}2rMc( 9RqW%HV `!AqX7u[@<%s;bq>uQnGU_ 30]e \H3=>(C!8U,EKך'cB2 ~Wqž>记Ul)\ JGM80.YŤqP+实P}ԌVzeVu3\=\Oqω{&,CM_qkNS6:mqc2i=,;s)E23vO;å0Q6"ai-3-7Rf]REPA #F(tMg梁3Ha2v}L=NP+f -*{᯦qKLD1Bh fyB|D&p`FMOq/=).b? g 4~:7a!-LeI=[Gobk66,~=W bE~5)4W0Ҹh bҸxd M[y)iDOxBz/`0|k<&=`cmf#Di՜6O5V{4\m۵%t3ͱ|o/1q3Dq+BBë;w3COcf_N 2 ][.cM ("$7[2Hq,vV]ibjRZ,,c k>bxүjlӸxQ5bLИ3PaBdBHm _-PMs!8:F8'm}`'ړnd,VMP+7L;Vs0})ZD6I=]iIp~UBc hHB#Baf!4 {Gm*+ XpUġzl 3-|땺Ҽ̈́ Q7#mKxiĽ+]BŐ%Kk$\N5#$֓98GBᜩ&t\k-vs.!A|: 7SF !4,fOW*¸IpPh;Wű|#j?5ͣysYVOHlCO}iRhܯHahxG&s)9gYy؎7ēxROs3X,+v]kI c;.r(.qưex{:n_ت&l cpٞ~/:KN #زyqSBP)Y_d1/E45Lm9;?JD\LPd4'0Wse[6e ΅&3昅\/Nk ;EOn8|4+aϰ\/($0vp5:k+$㓬 ִ{U&nj ȧo\VDy"/)"LũuhuKH)$K̞g} ʻ L+ &!pQݱwUU'E !F|QX1A`T/j"G]3L~gNezM|űocba8Su/], hM⚻bZ|;q/Tq-1;'͹+Nkt?C b+wgܱUZ?/7W9qvYp7Z؆0/h+^/k~2)4W0(6*Sep~݇-uǾ }Hݦ~rϖҬurr< =4fwz.sYf=?B~E #5uWW<%yG_puE[GUO]~[ڡkT]L[h,as|Bx=a;o7}>B#=;30<ΓB>B h_ZCS\Ina*[9%TSZ.~ ?4iҤIUTO TRVw:C5Pw/2XE5-Jt^@lܲ4iҤIUhv:2 ШگXFԃC0p'}~4[!M4in1?}?7oUI3AabH7lz͆BD"H$1RhM0+0lu(Ym|H1xY "D"H$1Rh܅#a 8F 21ȇp!H$D D"H$ D"H )4$D"4Rht㠿;iFjMl&Oqg9iNpIqƖS0MJy!54CT"%; K0<:V{mg {rj7Kyqe!4rjU!Si};.a\~!u:1bz|Oώ`ȑh~7GrD`56XwhVfִ7]\)Ǽ[\UW\9C󓎳i ̃1q>+"L!(p3yMz_Ŧ-)p3L;1,vk92ۖ}kYaiWFG{aDׂُ.$)cmYΏh^"P{ZdٵL<--].JF cI+\,_`awGWC&[tUekgI,tZ*ٜJ̢I8t}X)=r"}PteŴ-hsm\OoAyXrӯXW- SβeS׷f85(Ea4lkXtu[|UBz0>\ڝɥ<}%i'bڕQSDfΙwyx.J!i\Hh)%=,s|%C6Z5(x`hm6g+IjY_tSnt" /~:9l 7z+^T\]F|gܾI9yrkьVՂ2ueV5}"Fuq$.ec./7CGY˶=h`ذt 4ܲXiy kbjVHg'B霘%]}0aotqؒWNv `EdxLxA Bb#+/{i㖿Cc#?VoHU>>ЌfG9bQjBEҒZp(&f=Č|ƜX_<<L2k(-|7+иNNc˟3$z`5{ѐ4:иQF8^=Ah= BchLZ$i* ő@6EjU8)Fu[ k-LE&.εq[XY*-ِM>?u*)қ sJ\U 76 U,jR27japH:N fcs)ُkk?#f7zI-'[m)&*QT`Ò}/XJ¸xuV0cx(AG6G Y1x0(IDATf76: И"&+KCXIx1oכxE3ʺJ!4&F/h{ǎ%^Z"{fG;٨7롵D)w+2SVwU=tE{+=qBB#{'nĄHE`?]ՃETTdOl!J&EϠMB|m:oUZ1 U)M%h~8;H(e}3^)!$WkP4bs]O&/7qۃؒrcb](Y}d2 =Rbr ̭ 3݇qWEv\MIy$VGh #Y(έGZ]*df*Dvr"ictvj 4huKL5P/|ManBhx+x/L+M4iDOc&+JI̫e[!)4:vZh$ⓨ隆Ps_iQ4 0za5|%ySCmlō$,E5>jߟ X{Fp 5,a/YXEa -j8V?f7 ,DS5XHji|I&MZ1Qy-FFN>em^d MTߒpyY΄0zg0YYk@Fn~)\ w6+(8z)i¥taF-V8_!F(6 Y 7Vaa3O$E&(,feEa G;Zz/\?M! BXy?|HKU8$d'vCaXG6"nՏ4iҤ5_ /42s$2.9vJZ!25z[>TQP^f@ey%yaկzt J*5lVadM/K vQ"l!N5\دfN+D K*)uT}5ɌgvƸJ q]X[h""q,"l?OW0rO(1 E3J!P!@!NXhCݩ0bhBЈfAh ,WH(Q'߄ňNE3@ o1 +Zl8oV! ߍ~BH'Y74iҤ5%F)/s,Rߓ+eH'nѡIOclk}e]Axp&u•y%04,c 'pRC%TV00;jj}mLpS(cVg:,r,Y uG`(} P)MaX.$4FdrCa$Z'9?pFLG'-ٙ,<\~Ge@ # BS5x)I{ SO\B,P$v(d)XVS !V԰_LVpކ!&Fv7pA!d"^!DjݰB*؛) [ ۯENI&W_Jhqf^fb1gӈ'Xh~qO)G7+-mH[#lb{(ic#✥1a q|K)81j~Bc5!q6jNeSŊc MaC:]exFt %Q҉TFB N_=< H%+3c0I )4&41X:oiҤIvoxO+GP+y|\G"2,U^Gd'!KKfy<<-ЇPR̩ӡ-!ЈaرLE72 "B*5Ph\I׷7vl4Ttլ:fgaXFHNaȹ4`os)D$ e!dfpՃl 0"4iҤ5c4$)4H!M4i iLlZمW_RAL))")4T_T2mߔ G}QB@]LPbo?r -IJa,sPnu#R/E(:/19t-%s^ND8)9M*%@4G*^)Ew9W|\oy8F|s]ggn)tc ()Q#(4KˁJ*>"q߈Y9/3 !&<"Cs)qV>ﳊu.YDyŊN vmEL7 ǽfSW'+RhiLB_4,> 7d@ٌWq1&v|?kO:`d3'/eދl?mͤQ}i۸:Ӽ͒ gy|:lH~ݚ g0tqg)=<.bڮsl>i棦)*_Q;\wC6KDԊ90=+[䩦|<*9U Ý- lH{ގ& Q> (= ]hj7g >᝿弞v$U`y|'el9f衽 ה]ظF>Xk<{/_uM<ěy3jNd8/O@F6'7OkXL=oƙbQG fl!S E|8o7|5r;+9|t?֩FFr=kM磎4OkڞYx&@q A~֭1M _t&xxRIW2jLR'q ji"F#4'٘lYJǰT^ɫ+g2J4\޿Q vs4X<Ո't%VI%1s>jч/: ;vWz3ݾP]BC}ZO`ے|QGtW"fk:D%r| >؏&$l4Q3Ħy@vA)x N/#fOM}r,|6gn"DY!*r PX>GEw9/14~ WpvAo>gMx(Gsz|ޑ۪hm;[#X#-Y\_]>'Yu/\Rq"$q7|}`t1W`nLپg)d'a{UFUZÁfι4Uv >/IG2E>m^wzKB}%4r#SkmZOKYL;DR]Swcg+̵䗒bBHO )Xn{{1@"n %C:BkҋWV 1S]4:dB?|b LWsZBjBxݵ b `P$H q!Q{=_4Q8ex]QV it+[q7 ɘ5ZsP aezZ O+\bB}]MSxFΤTsZn111H2сA坥 H'Rnq;b qgb4Kg]|!n i<~ZhqZ͈xWz.9W˥0FS_뤕&1-[/du<_JhT`g("&k9AVbexlRE](΅1L5N_)L^\I9%攑Ttq"6IG59QWaqY%لsJ\_,"`gL?!"Njl bU/0c9[5_؀D&^L"H2d8 F\̥%XX2:q,Z*KEI k8z9E(eT Qڍ1@0]bF($g6YHaP}3qJ5#EVo"Sq MSXLSH:nև7WhX{//QIܚ֭5_5hl|b3 5d]pxQA'. BT= ђJ ugZɌy8ldfهLX;}@U%n|`Q^J=@qiQ t&ΑzNPW,WҸcX(St\BRq:q](&J5b|kJK- U=Xe~7Ӷ Gsn8WϹ<9O%*OkCSpqίk!ϹZx%c/q+״ZӎSڿиƎ Jt: 'NGqd"nsId2iU~ICB.\sEYϳHj$!~4C*ҭLNcD\j64Q?>JIM?#]" !R8hU[OSq֠w*e[&ѣrK8 BC!B B&j R;M3I6x * Jdi*ޥ1(]ΙV%3H( !&4΍ _-jxP;ko۰ro͛f1ASzѿ:+ݭt.L-eK5*;#c$3uɞ4k^p>^~ n>T<.᜷YlIxʕ缞 R:b2b3det{Øeh5ˋJb4:i)4ۅx7oC*:~VWpb u@ ;zZ {ҌFO'p!4: qð90dÞKBhgD"H$и p`4|:{&s_Dž )0l +])Mm5r#`jHۗQD"NBC"H$I!D"H$C D"H$ D"H )4$D"4RhH$D"i0АH$D`H!H$BC"H$I!D"H$C D"H$ %%idfS5:*LpF іJpf(٩hu,I]Fn~$QY\LW[KzY+IJLR Rɯ0:4Z3S9 d5O̎%u"eʼnDӠt%&+IL~䯃Ma"qJ\Bn仱|qʡތ6[Sm;:_}n?/4IW dnصΘ4;0Kf_dꞗAKDzɞj*IK;̨0'KQGr|-W9Ѝ~[q$kQZO1;+QR3brh[5Y&9 ]\;d`%]~"\0okL(4:I~^sQB\6zn{&>ݟցlKˢ,;M^Z8Y&M7ო0"j=>1pVG+62/[>}&;c({k !>:f",ӨL=-O`G.8hO{ι@UY{|:5O3SIͼy Sk17YMA^Q";7@!(MPQ@nԁZYs|<%/b8\,E[$Cj=} vùfO~Xg!bSyniAn!\MXug %:Wќ|q1e]~`/ƺ66h%&DvQ^b?0V5]mKhT.ad1-&$ωp%.͐i۞o(R]UbNS ӎS5 Hї X/^ukr@'l<8IS9ҢzZUhtzԀ;'&/zIsW/l;}qM=i歍)#͘v2?H++8kQtPBb"Tz yl)E9Qo0elłh鮪f"[%qLk,JB03C*6,+"z=oPPhq8~z憻ѡ\W,}㞗GO3LC=0d@B 0Μo4{~heT+F$&b #Ⱦ;Vr[ÑzZn)dg9YΧyNgGn.tAތݍrl?;vˮc%ln?S1vkMxCܮ_13Ɖ~yi6T ?1~vPg5gugi9Ƿi#Y:3\ƣG]|nﱧHtkcyI5YkᮋPUU&`L1Y. o.4i:,;BPI2ekl!8ӕ}b[U`]Š[Wo+0f{Ji3+&d|֤z/ zV4i "G t#86"0up jZo%j!%j k| 'sIEG*]^d~#ۓS_2r3XU肮:i*܅Tgs]{QBX2ΞGW|uQ9c;X].q0<qz_# yU<"Bu23݀Ӽ=J՟Ghhts3o1l[%Ջ"4Bp5awi $3/:;l/gCEZČ!$(H6a?:OU=V%Ϻ)+gv\v_qW|dqY2n![̿X˜f%!::\rg#b8sywQ h Ij{_U<%Eq>kM,>дWpTᇎrZX>-!4tCUeQ%ZđczIڊsڧ_wC}f MP /yV`iIzÕBDMYآEbB-kK_OD"Q Zq8֏ށW3ˊ뺇\B!;·LFRئ=VU ]դhV$+Tl:-5|3(P[cuR:Q.by=OL$M-Mԇ_y'%+h/]/1n{0>OqOiԴT0ψCvWC$~[|cZ_=~I ]A-xqaIm;kqT"@FFzWJĒ/<9BeCy!J9M6VcKZ^j׶z82";>f`8d5ٙ_2/`)>@L~ #]L@ZxYMȎl|T22G0q#cAM7(Z΃֑ߤ8wc$+E`*+f۫X0)oVBØx]fEh<g+QYFD_CKb̌Kֶ瘲#0)ƨ\ӿk"'&s'wo# CU9k{ qV)c+WMFI'DczJ:61G[oM 1T~%>LdӺM]V9-Wy}FR!4 4H);W[J]z/ƗP `Z*mṙbC?atN5'`?| B#Wh\`EHNO{,ҚCO&r ws Ng(mׇ>M b"#qާJEC|:,*zrⶁjIwfط$җ1/NRܦS=筱_{Vt@ww5;1f.W\t^/\BovY)d4e}<BAƪ@өĎ@i/ $lbKz,ְT%}ET.,K>N<6ܮ<ذ.V/I?,=e+Ή~/kuqbE" *H$vPrކ%y=D)4$D" RhH$D"4B6^6 eD"H$?{B!w|]"H$ϑ~F[9l1;[H?]:g%f?o qJ5 ^X0'ð⦓BC"H$= D"H$D"H )4$D" RhH$D"4АH$D2hH!H$dАBC"H$ɠ!D"H$AC D"H$D"H )4$D" RhH$D"4АH$D2hH!H$dIENDB`Light.GuardClauses-12.0.0/Images/TargetFrameworksProps.PNG000066400000000000000000003415561470750352700233400ustar00rootroot00000000000000PNG  IHDRyFsRGBgAMA a pHYseIDATx^ݓ,I}wr8}g"|'s`(A<X ccfe I !^y [BeX`Xv]=g={ߪVeUefefWt_LwUVVVVMg@wv>0l3B^@ !/L ی&mF y6# `B^y`!/f0!5(}7YVA |y-ӟW?Vw ?ONȵq>qy6yʕ+?7fJlv?0ͫp\ݟo]ůG>X,z?Gȼ:u{tr s_fJB]m%縲rSRg>v úCgy_!＞y*]o n޼i>яڧl'R+0rQ#EN~MdCO4߮r-W}_˿ڮ^l_ꐺ* uîm.9Ǖu9ӏ'0~K_2B|4数y%zj[ۿmMrBAyм0?W˭c}R88>gxfݒ=e:YG9?p_{v *y}'r$I}0_yoo6"ØU.~e+~W~0u `9LmO7YO&B{V%v]p7=9~2 J%Z\o6ۿݾ7n:QB* $zHmWC^ !%t2nq"s&lϯ_ꐺ* Bf y \NRPﺂR_E5Muݔr>v6m.y\Q?8~q.+B9yͿ7r'e֩H:u9Ë w d:^ۡH=iԩɵ:w_%ۭO\uSOQ/n}dvp 2uz)`^Ǝo *7)n%}uuOh9,G~:ɴ:6dYn߄OԺUpǓ9h?9~Jq-k揟+B(u.rsڵ^{;} y.E cdzCY0C<4q~}i{{a`&u3a&,w6Hݩ!pC\2m,xSG]_}>{ ZJu?f3Y?_#ԠmN۟S0C^9ɸ]yM.36{0o=2|Quʼ mkY[i}mJ{UڇCJ76O"6lUq-4}r1DV˲9~t.q9ǸaJP{{m}'WӹzվMH%qt 4XG3gڰg ˑ H׀h` 6H^Oԡi&!L+ɴ9A/Xr?VSQp}_"H߻}4\x)k+G!X7ru]?YXiulȲܾ MZ7y>ɸCOC'w<5.7=1Lw> }mOJ:g̽n}(Ӈ%~jsX>궝OBU8%h?9~YZ7/WzL J/| ͫ$ վM xȝ 'A r߰lI&}'6HKB9]H #daHOG?mnIwb宏cn܀R=xq,CJ5ah[rMkSjWʉGۥ'ra Crb,sꘚ/t12%ɟIuw|NtOC*vwu^wPzr>%͡~+P}Pݱ04RbQYp4gj]R-]Nh_-k}-6_ۇX;57Z۷uavτn7Jơ(Fsٯgz_kb^>ܗ'ŎsSRyggͫd_tȫ$0G)TL}}! ܻ%5r!XP 5.VYP8jr[|17)/%}}^>Cc}{?n[)䕓o3| ` u|ibޕEQNgbcضd3u' W4%V99f_/B0ˏ]9.e9Vl_].c^UPr׏K[oS:m}6!.o)m*9p)Vk]q6nlVx10%(G,h%kytO~ͫ} ܰW%udRK~}\dxy)Fl9!SJ6NC9`hS -#T+TwN;RlC],/=>S2xk}-6_ۇ.؝S}}Z7L^ɸLOէBL]E;w6lP2u֙kxQZ+e\ (DN}J ]\ƃO:Zʾ#4MmbDh9J!wIR$zcujpMOBL+F_+F%8~rTumbDh9*v׷|[r)A__'wɗ\dȫ$̑I7- s?Q! B0T5SMo(>%!ojhsM45ڇ"U1UܾMzlMr H/֔O摓vbC# OE(u֙Kk]FIZw@!B}[U%kTl<>[ҺW[߾[*}C:^7[,[6BMPݥ6n[݆S}6n)(OU:g|uνn·Y?Qw+=>`o9ܼ3Mu畺|!U,I I(%w|SBʼ;rAm0 `0/ WPh}u{Nə>w;кh]/irh&BQ R4)ݷzbuX y^0=]?lk= ӽyB'+su֙wS%"w>~+P}.v}cLiݾ P[}[?r>}-t>[U7}7nKƄڇE> 7qk8~֤nҾ:o>[U7}7nKƄn\a[z L JG6HcL#ulS+a7n CB6Oڥa*s˷u;+>nز\E_;D{݄o9>lV ? 77)BuVZgZ2;Yz]834= y}֚?tX]]W~.R_uC [isӡ˓B'W_U '_utIݷ/CǎҾn{d>| L/|۩dyrP>mQ6kRCw]m]juXewm ?JZW7.SG}|hRd,]~#{2! JC`Kzߕ]`M/ˌpP}n;cێ1~㥴Λ^cu#bmے1":P˿4E 0)%2\pa[)UvH=rR/' "Bqu8bSᐬ|˰E[IS?2feƸ#ǒ]OOjBO|Kʾ5UƠk_v~)R]h;宛Cw{2d[kq!qUM^ӱ[wuêdۊPiJa6ZOC?woc`NPwwV/|*ym87m2ۿYJ>v-0,G^`NK0+y}gNhNI]|6>rh[pP}hPا˓BǗ?j6m?7/}-u>^Sɺ᷾-&}MHݟS0 yZ.ZLO})%:E\OmMiC.d>qOصO #ڸ:S_w.Eno3m踙~OĶIwʲDl(i\5y7Ehc뒳o;Vi.)V ?sCyOv !w M/ >̭{l[E*gm3]O]_.Gƈr=F9rR zwƊL+Ldȫ a$44yLˑ[i$I^ D )4e:kEB;[/R_|Y-c8*l3 ]OOx:ʲguYx)k%}_y)n߅S>t.C1olέC]~ "?я'> oFMɐWJ* iH#T:CR.AwZN# rC;!Ð0խWޝ \mZRUG޽A y%skPhc벎jGd91/E͵n*=F")4sܺgC^ED I(E* JC=d/|򓟬5y/&C^lXH:ՏM}TA/P'-A)!/ޝ*w\.;G5w{Y(~ A硭G@!/~tcC^y.\ɗ]^(6#&#KB/gS5ǘG@!/6I+a||3LW ^?@ȋMxj}{/r# `B^y`!/f0l3B^@ OP( BP((|uP( Bٯy`#F ;v!/0B^ay`# yz /^x*p=`{?ni8nqd]㙐vs?sտM\7Oy-B^_ OW&\tq@.'!/F^A/mE\7⸁}BkL|"-\7Oy-B^E,U]rq !E 2H xA/E\7⸁}Bk ~_`N\tq@.'!/v @.rq>!y ]rq !E ]\7Oy-B^E\7⸁}Bkl.  B^k!m2.  쓝 y~zNql.  쓝 y%{?."]B^\7Ov*uU^!/v @.rq>ٙjM?U\ۅ.8nqd'B^_{-y ] ;e~>kԼ>k-um  쓭ycan콩"M''}!~4'ʸq=~|frY((}|zy߶6iufEȻkJ{O3R&MZ={|^M7hQhBޒCEțjp4BKBݶ9LS#\+{Oe..WGȋW™бb%Jfz^1:dX΄v6ʁ>h}-B^Ph7tD1ѻ y R=s!ﮙVP~x|X~W_FD{}Xyk y?~.rK /U:<*!B^cm!ﺊ7UKGjC^݅& yCy9r7mDk^4M\EC^xN4'G,{87M|nVӎ>'q 1 ycN;Wы<_ NWtޱsz_V<Ǯ=|àT#SSmǶD;y/lqk`]gA;L_S`Z<M[0z|c|QFw'E_NB=z ex2ջ׆P{{ҝs/>XǹQW. [sx;y-BTF{?҃@)^mw8ku!oX(wn;u/t.yrBނ>.o;fB^+2|I7nuzCs7MJcDZMޓɋ'̗bф;=)執]5y/.mGțz?"΍,O:=na[#Pqy۱6oxWEx\3_(}7X`m"MhE`rS©Q2#AO?t49o,mxG䞫GqޱsEx)󅦉\f%}J۱ح\# ߐғ=`NrI:O'E2vX7hT jUb#8X׹Q䢳 b󅦉\*mǶd agkk`Ewqw_e} #yS%|^Ɏ7䍟,{">qR!;`#!nss%.ekB6;-Uڎmѐw/{\ǔby-BT)'΁^_[rPyE[{ȫh ع;7ꟷ;nz;H?%}\vl͆V3F1?q7K5<yow_aq1!oċ)TuUKl|=ڬ-}>^y@ɹ=7'_&Sp`Xn=^B$-c[mף8. BBB !o&%*"Ȗ;I" UsBjO4_"mi.R!-eiN{ s9|=7cFk6%}.q.tEb7aqY۱6Ư{:>ycwl8z0T:?d5a0};.Jo?縀B^7Uz|';I;)BFo;E]FrY;>D\kS|K[$ a?E0Fklu_r܈QB0p}Bk]DȻ˸"z^_B^`[q}Bkl.qc!-B^`[q}Bkm24.q#k!/8>!y ]rm!_x1 i-!/8>!y ]rm*o$|".\tq@.'!/v @.rq>!y ]rq !E ]\7Oy-B^E\7⸁}Bkl.  B^`p  8n`Zۅ.8nq".\tq@.'!/v @.rq>!yv!/0B^ay`#F ;v!/0B^ay`#F ;v!/0B^ayح_B^);f#~}dË ~ʃw5̉Ss} %]@9}3L&L 7n@)w7L3i9Zf4نiIv 1B}V]o˧gW~y.$m !T2'B^D@KCtvzjs&3~pdN4Tn 3FkYmHqmB^A #gz1-k_0O못ysl# yώg6e0c_wei>oi0&Ý0ez*az{hP,چ 'Cpzm74nyuw_i980G=tlW3-/h1%v9W] \B}ħxd>yy+\=Y yS/_{w6̩ ym\ڲh~e1voW%eٟ l^xR&s#fֺVJȩ!<@'jC#,Bmuxmt]u s팕?防˩ LO Zy.r izi[n~] m. !>sA5?_٠!o\^ ya^{梡lܳC[~;ڲ#i!]h6b4+'bmnLhESﻁwfBmސ76h#C&?V_nw^>!>soAh~她יךʗu!{+cMesBݵm0ۛ`:ק`#!j69*+lz[)!s׻oujC|{?Mx2u׮OvrM/6BQohc,􇛩}"!"VO_3s.߭ݟ|ܖO>m~ך}.|swTB2PSBaC};;^Oۏ C sD,k*t${9`AUN{I4ۤ ye\xQo i#NJYKE=10B} c~K{_\~[Z>94l iygrfm)[GM45Wlٺn>$&Ih_Pr`:|w|7!/lB}2я&!!U{q͋՗!{T6B^޵yyAD$!BQOJkr4XZ%I yruSKjuD+wyi>C!ozwCȻܻxͺڗ~fX}~|/}g>7֡M@ ) .4OrPb=+=a ;D؉v$hCԪ/^g2fH慼`JgH06ڄ}x&CȻϪx?Z+!5O+m{+CM,x/\B^vUYPa#Ux1^I-{S5r]3$4ЩмVb z59*\vecvڹ]~ܑ]o\wj?'XoB^:L}{lMݝ!/ln߾T&],r!/# d y7zǙǷe 8ace\GGv:y\t(`ɪWFz$ۨ?m[?ix6" y-w_XCgK^vC ~Դ4oOܾo7df}7yy{47m^g^yÿT`k反sއ3_}7z7wy_wUw~M%!>sK?{̍ożnޗU=}CT`kQVAsUw>nxyo3/}W.szd]#`WիGq~zdds,j9WC??yR=W}^}-uwT!O򾿩dNgpq\)f,>Yó%.~!}Ssrdkj91љ|鰞#O=$xEސz=N&f}0dnK~gerzn_qȩ9 td۴r yc xO/_}y}d÷nn#~^ʃk*.f+å]7oK $|.U !I7́s4=?RAUO(:CO;]hZPY;?=iˉInÈkmMj{n']m+m?!/3B}V+!gyl/S_}yko4}7l^[͋~)lB;.e_pQ˪)NwH:A(0`c$IrgN=dWhosWn5MSk/6xwAJIl`mj`Z?;A'}FȻϪW/|N{}Ȇ_m}díǼ]M%s"Ԝ?304Ak4t< ӂ.nݍ'LZNfۆON©>+68B^Q~cG yxߖOsr \oIiYo3۹4-,yvp~ao`c|FB8MD9Lfhnfkd[c}{]}zy<_ yʗ;Jw'oe@^,K-_lN[.Pv|mkx_.Uk~^;-] y۠[ %Xnmuj|g`q@i8 w4w a(`J]=C{Sֶt2 6d<"$9Si]۸6y{:r/sۨVw^˹]nkFF'_6z;DM;:3.ޟN>Y V啐깼wh.' cS δS Yh6 d[4vY,w+mi^am-zG ̮K B!K4DXR4% NIA?* 7 ;ygJxLbvzSvC OᨶmXo~ț>z yEY(@&KobکCmZ]Ov$hCX!~vB^ !q./6m [wUw~WBG?jWڐW^WzK{uTNSώPYu9Ay|080ڳn6NOhy:׮h 5]V JU ~!bB`ﾳ|.[U XȮ9Tmh^+1Նp;6sLb}vM.?~H$u'ڱv?O剱2֛!>xm}[~<mw'ob/۷o7BC^[ .P3v[Wli};]sqh]]yβyfN RS6^^YȫEIX/c|4s;$}4-AM0}o8emva +#eU^GBAgsI8;0{;6.6ب;nd,Tg$/yC^+kǘ} {KB'|ܼys y 'NU`5gd TXTw9;6i0ec]+5a<>lh}z_ * y+܀.Un:tDs[%Ĉ| .iU_[WlLY[ИWcyGcyͷUy6G6~ךJl3B}vM?C*ScnQo5/|m#enUlzd.cr\Y`WիGq~zdds,j9WC??yR=W}^}-uwT!O򾿩d^+抄4ʹ!9\ ,/W@~!}Ssrdkj91љ|鰞#O=$xEސz=N&f}P?'u6Hm_Q`jpkR6GM.0FȻϪ yt<7gyG6|>5WV,M5.KZ~MΎ;k;2 `$s`2$ eV -llkg V/B!xvȫ 䅼q;5ϫΫqSY^i90/yy+\=Y yS/_{w6̫4.k\Z@ 0QµznG߅gKmuvhP2[fkCSwn)Ag3ӮU@ywCnipf}–~.4=Զ+:-uUQ^RްMÉH!o4L P&Cޔ2D{mdUmȹ+6`7?Ͼi[Y>z3>C^w_>(_c!yVA;.zap7MQ##wqͰXo-@Ȼܻx;ugG6h[=WBwi; n}0t<qn(MqxkG(2\Lo<ݺX텲k>mu'~% ׵aHscdn w ׿Ð;؎3'k[^F]h7 64H,m ;cJ@t NIA?*UEN~ _lMeie[c yq6^㒶C [Yֻ]ofւww?4?\_}}ksy׺=敇y鱦y^(;4 ;mۆh2wxM~8״iWE:M`Y>t!ǣ7J ,{:6BqR^6P`wɝm0DB̈́yaSLlk]H`.w7 ZNÏex#w6^,w;Jۅz m}"!a!VO3s.߭ݟ|ܖO>m~ך}.|swTB2PS< .mF_sfz#N!?S@107isס ˖tbZS߅Ӷnj42M^_Wo.|qbyͺ [x|,kCHp'w5!7Y&{ m{L1?X]?e~彯~.o?䭿| y@S<.5H_,UYMbyސ7P_<]Sܵ54g[|<M,7MVTk oz孯ovp5\LyH !C hIi=O{+gӐsh+w\|rBlД}[Xc)\oB^:̽ǿẹ}sMB޿Cާs7/_sClE!] +}oS!onr(a]u6wmoypOylu-%-C]M y44mnxjM孯ok=}|&@ghDB" /3a=G{р5a9,$  t.C!6i!|*~GC!ozwCȻܻxͺڗ~rR̾vvbۤ+ M[Ν kQF`Q?SN Í^jGB޹DžO'6ce ysN4N,{ M [wɗߨۏ|<~5 y^.}h[CXՅYs$['6rammY!VA۬u-BS[wk 4w@tIML;xLQ+5bDBΜ>hf# } s?VH i1./6m M [wUw~WBG?jWڐW^WH ̾xh ȺSiҳM} a2{պBnT!%.+78ԺM:hI{?0cWWY+X_gY)(gVa'ǓzV!HawYe*uLmdm t64hCI9ϴ.y7\_<3^k5⾣1 yvNmzñ2֛!>xm}[~<mw'ob/۷o7fW܅y,A!; Y,pRCCo7w+ΎrkK䍿{StA]4;\-w!ANNkO#}m9!o4 3=;ƣv$4Eq]DkӅy ^k/A8=]^T`-l%u%\sQG%%6>7'n@UY]#ͼ&gF=;;T[3uul_>ݠn[Wp# M [w=W]u `0GɖX !ep sƍ^hj_^!/0B^ay`#F ;v!/0B^ay`#F ;w;S<7g~yMbnkj2/w̳r7o27·y_޿3/VȆZS mFȻϮIGu[jU7y_xoͼ]ydṷ̂ wUlfy効84g+P]j^=ی#sp ˜c?7'U6!g]~ɓټr7r7oCＣ y_{M%۠4-|Wt-unNAXȜ7oWQpe Nx)ΣSۢ 3ߦpqqzmqSsTg?6nWGGM.0FȻϪ yt<7gyG6|>5u[Nᄿoo+)uujnq v~ԑ؆5ײ>v]50- I f;'}FȻϪW/|N{}Ȇ_m}díǼ]M%ۀ >15.:J4OJtjN7}af59G# ц>mX+B^A #gU{|ʘkfl~KB M%ۀ}3j8愼E˞j Lq_GDCf`=XǬ6$S"1B}wb߿<'_< y߽.͢z^Y,ͱ7퇼gLJͳvXwf+K?M&`$')[v,+03[_MXǤ7Q8+?tlؼ}NS#ZL<oWA-/h)vܞOy܌./֊w=.>YO|9zu`Z3.ޟv>g_^_yy|y.|ZǼ1/=T3 w|nKߕK yNazYf-%eXarrG\NUBsS晴Uj %]:6.=˖hZg,ֆ[x]s}0ta_ٗ^k#~UwQ= y~CMe;^J:v@}ZBX[:!\ȹ6xPᲝpY~)m/lOԤk VT5;>8j>Mlecݺ;3(G קn #!o]Kۯwΰޑ\ B} c~K{_\~[Z>UҦ&׆"eAC_f:Eٲ5X wݡucw!W:q$!'Aeݚ>js|lecݒVGclДq*|c5X}i כ!>soG\*ܸܐo*[!/P*D ń:+%N;wneƾWb_̕l&B^k~TI0T eo?Vo.هkEȻܻxͺڗ~ciAl y`k.{G$}'͛7g zr,fyxx殆L^;aptwo'w ţjn2~:4K`gYv\;pu[vN_pRޞĻhs1dΫu&[$||8ؼ7P/J yE^rm]U"37!/lB}_5wA~"w=`̏-z/}4!/!ep sƍy ٖ<xEcSs*g6C],r쾘xy?gVea Kv!/0B^ay`#F ;v!/FnݺU7 Cȋ^zNwޑO{5).! ask淪u |ݢ{Jͫ^/ sWC\-wݾ} ^] sC y.^7ׇEp1y/}ӓo\W\hR\ B=kNU]3y}w AȻ4| y~jyZ>_pqy9!gyz̃͛7lұY^b\Ym]CsּeNի#?\vG@Cʘ`!@vϾӼ51{oElZnWwg, s p,byh{e ysvl]#o=x^cq`cс9.Lrp`/PϛO`(8CL沅gG'y<RlGE197'v'3̴~mUe"mev~rPo-R?5Gv=0o8>A[d,OվQݞnǬd{#l'nOLȋ-0yZw}XNyJuڍB=J{O\!,BZ/8!o~`tIٶW.򦸄6M/T"VO}'z{ 7#+]u~]4tEbGZǮ,w1)h|!,܆«,H[vFc3e;tc;,>8^?=Εu϶c^/փ`XQU{,nSXP˫`u:eߡrRrؾcǦ2xUs[P[Z yՅY{˳c\^_NM$hfvHql Ԇi;s'ywQz?};Bѳm4wT4%rγYmeW%b/keҍ͐o򠮽{As9^㦏mmjg氺Ua}EM `kD/`3œI'%N'pHϩ9 ~d1p^WE|9G# #M4ϸ^vF>!xu Z;|ū]/cBDӖ-=pJ?.{:_#tn9q BȻB!Z y5-(> F] |w''9NѲ'.;=3_~pdN4i ֳum@LD쾂c~:FaB}u:ϊow(i239#{&w['3FȻ2ջU>y/&Xe3s|8xm<3r\YT_~y/L+jV*<.™Ie \Gp.oi~YQNyޭ.Z.y:`ZQc׷ҭS6r'e.@07',[vbc k=dȹu Z{ӆۖ(lB=xbP>/V;D/ =R`5c$|/%g (_W]zۿ^ְK7i{;-ve}ᔶS3CBIitnYz\0Q{*9Bee]XԆUY.mqBz6JNSͣA{7gӮA+R=r ^ӶzPPfV?%KjP;k:VY?g,<%ΣWoR]Lj[鄝zݻM:"aauٶtAkov#gٟ#i_v(B=}!wwOfu&&g n.mo ~ jn5-{a޸ھ%s뭳|"%jgvtN'?g]g΋ /_hs!|Ֆ`5 Q ke[n^7 [5Ċuk[G+ -}m뿓7mp1b=nJ{d_ ;8s+TOgImǐ]fw8-xY5=w~/s{LGEۧmW1z} ezC}-!ón {*ϩewrC楞@Ziڥ!Uf "mYڟvwBvC|u~Ѽ ]ŖU~G>JЅ+|*7ջЦl@kZNUJ_ k[FBw%^9BضEK@oOu 3þQoP ,/0틥9ygisRھ9Bu?O8M'iS|ҡz[ yS!_X[fS<?X_vxs]'u  ^ӕ]_vH#wXUJ2MNۜO. ZouW#9޴!'0/4F}@;DIrX*wOBҲzțE&6ʽVۥ_ܔ~VO}C˝/2oNЉ2/jY3j:={Bq{-!ElԾJm*]եg^t@ٲ?i蔒4#v}5rcGbm&ߕmpq1߻Bc$ܭ\K9l0qX-aU[ܯrj=ƦC<6N-/Kݿqk ys7:mB:Ff y> Pgd)u{‡ U4m姖]NEQB/s>Ui愞;{'3h֓?}ς,JOT]Gt.b`9Iy.hC=ކƈ5ȦcQ+L+ǣrdwc{|Csk׍wOB^9TnS) D̥/p~Il7s=]! 9^ںPӺƈsh>tcE_yȻ0ޗIm J]9L uOUSEm@W]Ǡ`gW?/ei#B5orƋ!!pkѱ؄ְӉnݓnF&o][6R?ڪoζn?V'ჳs"OۺewA= 'ekyi ^c6i/em\v7w|ǀ/;7ӆ3r W xSeɣ&JKGGٿv4u v}5 R>mX7ꗒb1-Sڗism<=A4 bx]z,qrof(7g# cg:; K¢_Uhe-+cM34A/-+؞ZerƋ.'>mmŢnٖ]:]#Mucw:umXe[I6 2of /;70ɔ:r.Mo|ľ/r2l-_~P]E(u)hHBfycl.68~a[|Xn1(Zmh joSqyPP®z:vFJ^~--kp=۸`ˊd=m}j|h}Znk>#<-&{={>!ҼVۖ-Oy0䝫\vmvvv\]N;J"wY`L#m3tDM7Lk:ky54}Vt2Kʶq Y{a˷mwN)!68uw OH6 ;z\|z^?ᖟ֭@!cٍs3 [v$N߅PA{{֜u̖؆^t&Ҷq/'B@&w)^ NopV-C堹VnHI%pKgrr-]8R'vݣ!M;{"[=~OXgC^1g_zTَsuG}2*l9B=%$aw kK=S6!uV{7͛R\4B=&A/-)R/]y`#F ;v!/0B^ay`#F ;#nݪƍI!EK/ r AȻr']iq[=wOI놰9E}c[ny\ B=w}UzUR܆?_ѫ! v݀W AȻn߾]׮]󆹡↼râ{>usϷaɫ[4u^).!5'}y.^ qz S愼O?L5vyȾ9qw,+s2'WϮWh yUScYYϞm[{fZe,wvGF `Ԝ?P99^y<4B=!ޭZ~V1ܔ,n橞.ʢnp@=~a"\_T~WqL^_/Μmoxܾ%cNV^iheHNd?M`\uJM}mj}r.w ՄP90V\\Z/gkd[c}P:bwi?l(jE &{cN8jh^qK!_Nt"mr(k5]-]Ъm*[lE:o#벝_ԫ;\1jKF u6-ܜץl_˗i]pj_Vng>y~ cݞŝy]?Su1SLp}.8ܿ}Sp&ב?4j Ss'k IMm|Bc$uMՓ2<ظ]u SWN-0&4/§@h?5OO. `j҆U%O;ۻ1}w 䚗R{/'[_quA?F0-g uز**_ST>7J^s'=z9[6m87)`mNw5:wE!ĸ>~êPxy/bj-8H$XPion=L/ׯ^;OwK LEizgvquYci`jڜowWޜ~2''iS|ҡz[ ySϡ@樃_h[fSf0X_vxrSuVmQg W>>Ӵ-u+n1W#^.{I ۤdLk| _ݩ}SחvXe9^s>;o4'Qž]^g\+ `'mCީ6 %t݅p۵O!ns.-?i)c }JĖ{'GAݵVcΛsPkM̔kY}|v;n_]Xn{ӆcG}1}-r._sLt>4/ǎ\OyT(--MPIhjBi;k]+ԶzB9kx ZnΚo3MՔU8[fW^? :Q!`}-e%a|Gw}9VU`uiwyd>nk.z P/xwI[y[iPh? VY6rE:k?G6C O} ?d4LoKǩ*W?ΦC<*~ wRsX7=BM(9l!1ٯ?.|zpy6gJIhVHr k4`uJS !X dȫ˒׆9 y]_azP2je]ǾҼ_g=vj. E+l618J6}?e+Sw]Ithu~=G{р5a9 DЙu\x.ԦP0 B>'_u Ʋ3''!Uv՟SHѶK>6}㶳p9v}GJy^>64F|}@y|isk׍wOB^9APnR) mA5/p~Il7s=BVʨ-pL^ӣbA}E1?,?ֆvySu;wFORۤV0@gz_&5(u9iOEup0}Q zP5 wWnN7}qc+,:dfXg4aN#Mm]&~_NmCۖ3OON!~XZ߄f_떗r|۠hXӘ{}Mh__Klj2ǵmL{j+C^KC ,K~:O,4jGۙ~IiD t=zcUWn_*cnj;|Bhh<]Iۤ7ޗ;_Z_5.u{d<(4vXO^+5bjx㐉6>.4D6cFy,S۷GveLe2fy-Q//J9Ld,EŚ8֤G%񿾖Bczb_kW短k@ȻB!oi+ [KslY.4$-K mʹnX*VP[9~BaTmֻ9w6ߋ[|~HsQ׽ncjöN'roeih|^}CmFζ^tq, ]/np&/σ. Pe*ux6 6\y+n6[x)]_LzsU,vS8Ocgv|szi>8ÍGkGSgIq.߬omAp_зcݨ_J5,Mi796 *a_L>cj1/Ӳ=&~_/^ސWC'pBꙣsGȒЦTU2gvʘg4}ӮaX>]WKŊ~m~v7V ymzb-m7~izD]_n;m)nɜ1E0Ɣy Sk_LlSg݆YZֶiBܾsڻ)t%D; UɼZV_dk^L6/l:B^ 9џ&hC~qjƋ{8˩O0oP/ow;NqᎫݧtủ7H=q_/SY^ӯ}M˳S!; KJF3hKhZxZX#3wn߷cLwαgtncq=4On^ݷ|?!SÐwrڵBqjv t+ meI3rܱ֙8GfgfрйVӨxxZFcV y k#s8L_ bV}v118RƄk8}mZ pNgIe];p|g/2BmSgo `Ou'ex vm'/  w{{»Ϸnוsk;K Ky'?m,w/.izp4 ɽ('Xmq՝r G8`1.͝:v{$K$Xir-]8R'vݣw98/}ZW=Q{>sb>cJE^S!ѣ;wp~'8v΀wOI?I{w{ڒr=Tu 熥B=u֭n޹͛7.B^@Ȼ$%E"E!/E 0B^@ `&Ly.!/0B^ay`#F ;v!/0B^ܺu7n$=/7ȝ*.!˽#Wן0w{mkR\ B=% x_ךoU?Ep1y{wWUI_rˏ|uGZ4u^).!}v^v憊]nb!_'=߆r'n` x{Jלg摻x%gwOi>3<,^ zh}) `sB^)tXρ8snNzmxEސz=N&f}P?'u6Hm_vOjy`v5GPwn]ߦ"ľl}$v=f]G۽C-tc"4 yk?}=:fe\B=J{O\!, 7$)M{.2fH }b!C)6 E!/u;.`{b" or/Hz{u / 쉿N,چ$p;V>p׿rfz91im(7 qUS!SBn/kaVL6vP0mV ?N4c?"aIW^g?^R\, ys_ؾcǦ^ת׷{*9COCZe/pmCP&wZ>bmуѝN7: {{^ .c6J@"?qAS++)U/pFVǫisxY~]_];G7>'@V mʃ8hExtڏ>v:3-ݱwpuL8mA:cN9W*2ǬO9Ŧ yUTYeys "!o.+m@ ✚g`O3.ZOǓ.nռΓv&-'BmCI06cbuf+^znUycI|EycO/! sj7ՠ߄U7 lF `;鉶{2&^ L@Y'򾶖U^yȜh3?B}kAțӆ~Ks[b-tFQ±bu:ϊo4}jvȾ%yqNbǥOf7wOmeȫw~6)YFo >3X>qc<7jx6L_PYA{5.:&~,,_ 3}i>i]~}ض+r'e.<| 's`2̹^)_ɶx`!(e;rwubcX&}Y ZGOZ]mOV@}¸қ._boϸ9MlȊmt}#ScgR|0k8+bP[Zy5,xp K\6 ݏz%<-}V,h9fh|WX ɀ" )LmdγV)h3^;UsKުnc40SlKFuxǟ+T;F8~ਾP=aETT~k5:M~N+74Ӫ̧Ww:;s/a3gٟ#i~'d7wOm_Ȼ۝SGww0qHj3rpvYh.7 xEfToyw:}o}R!j/\ N`]^cv^KkcF->9jv M7F58j0.KÛZ{ ;c*ek"lZ;y1-ZE!gjF"t'o?il/һt B*;pb=1'agk׎ V\M=}ڎ!>[oNܖ /gՐd;H3|'f:zQi}#>`V:t ><'bhyT(՟S!0IJK=+ε|OӴKC6 ^xC0 Gý~-o*DI{W.v \aan<ŖU٢ }t`[,S'T9VZ4wjo.eC!o9.c=_{۷c;Q"Ï[rCr潢kNJh[D~k4L7 &җW/UD껁}uB"x뼳FԴ9u)m!:Q}\.=i|ǟ8u'!ސ7'tN¡2z0/q/ xŜ!9>>ꕏN Jmh׿Ku%^.{eOW~+ i޾ˎeWwjϫ, N * x|6~/BǮi&{B>ؿmṰjCީ6 %t]``MV?sc`>=OXPF{jCx4$1`9guBd:ee;o%PfR5=Jm,ܾvXmu Gy?gv]t4U=]fǦ+lZ/}׿>m諯6RցXEw]Ɨ4'@H {6kr4@X%H yg P0 B>'_ux3 - cc?Ǚ֓Ǔ?}ϩPh%SqY]uZ>գa"%

`-r;~1m<u#SWN-smT¡h`䥡Pަ wmr,vj;ڶyzv: &4ZEŊΗ؞+[9]SuܟS_=צdw&B=!c~`R,?'ua3ghXhy!oI iS<:ml<]6YK͓_ol촾Lik\6my(4vXO^+5bjx㐉6>.4D6cFy,S۷GveLe2fy-Q//J9Ld,EŚ8֤G%񿾖kcu_6~yuڷ^{*򖖹B.0e4@ J!OF߲N=ێX]ï~ٚ.g]= r4]\;~m]ǾGY 7u:~+#䍏p_}qh~Gq1Vݟs9s"_g.n?VM_(߲{:[9A4glFLA];o6OhwƁj꺇Ӻ 3/_x.߾mvW mW''cO26rR1>v}{m4rkxGli_lgNn.+ 9=VHd>`v\z\i]-=H[״m[a;Wv !o {E wԕC$QYkpmUmvnHgMNJHxvݓn[edh:gthI52_pj{ v\RklW~G_W'el%J0o O{-rAN?ߙ9# >ֻ߲Q^WB+& "y’Cމ]7nQYf|~aw9S?@;D}$4ޫ;aT p@Q-C堹Vnw_=}xtE|.p}sEc+[=~OXgC^1ge_MG}2*l9B=%$aw kK=S6!uV{7͛R\4B=&A/-)R/]y`#F ;v!/0B^ay`#F ;#nݪƍI!EK/ r AȻr']iq[=wOI놰9E}c[ny\ B=w}UzUR܆?_ѫ! v݀W AȻn߾]׮]󆹡↼râ{>usϷaɫ[4u^).!5'}y.^ qz S愼O?L5gpᮿ,緝!2msۗ_CJ\Z X)Ԝ7{#;];U;ω9snN؋Q=H98Q db' e3p~[aowO`AڞfjXsuvm-MvnObcx?jua;TBۑݞ:&Bc!w-ro-*rW2A.!Z%exi`Vea )k풄Ux !lcȫu pvlv {S\%&ew]]E{!`/x|xEcOޫ hgxa`Omv`6L&!ޱ:𩧏^,^Nw66۪)ᐩWAΗ50vllnvd(6uUҌw^~/Ah{kKq*4W; ;V{l-yz}KȻB!oi3=;;wfyx ΎryB= vF[X}C}wvHq;# Q`p]0l$D~₢dWhosWn5MSb^/6Wލv.n|N-%'6A]{Ǣ]gv<: M;\יۖX}m:& Ỵwxk9GۆwOmm{* |y1m yqpvXҸNi3 U 0'ؑsF.N׻V:O&ڙ ۑۆ )hBs?/~vA]W[*y zCw9zM>9{*ϩeސWñfbn[j[ݾcbc@ h !cEdu"kk)]̉^pMDP߅S!*үܖX mpj%Aγ:73M_fo B^1Z4Cy6{j+C^3`6)YFo >3LJ'S=;]<; OP=b* ybi} }BeSGn8˒l iJ'c B㥯XzP?&WnpN'2&nr=_̨%>I9^U\ A+vL9+C ;X_6ܺ f 1,%>r`@,H}-~:$ڞR*qۥ7_e ]ߞqs"͹Z)]߇ؙ}@\wȫǹ+!S/@(u›6\rRlC Xe5mVm/h[پ6/k#m|Bc$dƠoW}׍}xkغ8B= y2; eRORO g-S4( t!QrPT_@.^:_(8S{0m ,.m]p?T?v角ujܒyR-RMNmSXN#~sh$'P/z=']`ˆB޺s\{څhNw5:wE!ĸ>~ê܋r`m5zn$~k4L7 &җW/UD껁}uB"ܿ4t8:ѱ405mN]J7GȻɦi|ǟ8u'!ސ7't5G›2z2/q/ xEn^m \P啄x%ۥm/L93LJ]QxUG2g\J taߋtHt&VƶqN#*.6Js,_ű+axozx.ڐsŠw C"]w9vSAȪ lx`OcJE0eIQApЯ2qnuw"fG3Tu43emV_m:W#>޴!m_h__K+s'رԶ] ! e71 * o;dJ:p*Z yA^<[v&3M֔N*o_?;A'x ׮R[6Ib#֗]K6}Pj_U.cǀ|EqBBOc3m"Z'V }<ǰ4ۙmǶ˷BֳMnԾlu {9~rD>~p0h)_zF4`MX6tf >"BynWq-;{ Xq$Ow߮s*)3vԦovn|9x֮OQHy{ kj1`u|>Ӷ'zL74DZvyT(՟S˜!o"&xih:49AYܠ0ښ7о)^^A]VZXM%?ۤVN%c۸3/`'}B`|a*L Ur{t7q+s oNm|!XM1¹EaWev:m94tRMhny)˷ /=W@=ބƈXϹj!vk}n[3 y- &0<Ӵ]mg27k0|}%!ovi.>6BH@NVkS:ͿMjz}_olԼWZ_5.u{h<(4vXO^+5bT%C&0 dg@LMlۙV15>zǖ˘!t-#DLw++80mkX':CcZLWtL'am89P[Z y@Ö>|v|hK7T, ot> |˒;l;)i[r3Gܐ/qutCкuK.@[Νu|\l*^y { l]>ԆmKNyL6G`9V=^l rЋ9N|ŭr@aʷ^Oӆ!vƟ+oxm6цoSsb+/K_i]^o޹xj}خssz'iu쌖ӎ<No=߲S8ch7g fGRٺP}Cvlu~).d5՞ݴgVȌ!Zx|pߊPymo+̡UHQRzbIx *v\Q[ee3i0u.Oﾮ0,z|zgv c,rD؆Huki!L,?O|N׾a ܍mfNטyT:6qVRЗkYۦ ys2ۚ̀ˣžLW_B*{P_!h_>);eEKYdc!*nc*ڐ*9>o6OhwƁj꺇Ӻ 3~~=|nq _6hŎ w\x >˨|dNH1Ǯzt^~--k_5؞ m\]eV2ڞA[B:ǓǪxzhLw浪}kB=5 y*׮]!䭝Waoh"!]1/jɝymvn =An5Nx,z]u YG89%!P;<ݺF؟]/4ycc)ocu uNךyTۥSx/&|Fr_ƶY"{[{(^k=}YL{L\vywoe(i+!r{%H|w8r׍`E#tcw0߶_]NE>oxucP58[-u9hձ}xtE|.p}sEc+[=~OXgC^1gs>S!ѣ;wp~'8v΀wOI?I{w{ڒr=Tu AȻnݺ;wyfwI+ jKE lB^ay`#F ;v!/0B^ay`#ȭ[~qFRpqyK/yܩb;r\ {asFȶ2fjgply][y=w;&/`Ss޼u~jNtы^$aĽZ6ю͔Ѝn cf#E;fSk?FU~}6mFJ *4W;z$w Q(XiתyT(--sgzܡz GΎryYB^]7ۗkUPx[oòw;ٽ7v;#mĽk/\1 % ?)Yܕ[MӔp]/6xRË>+6ؔn|N-%'6A]{Ǣ]gv<: M;\יۖX}m:& YMfs9ǬѶ!S[/Ы kr=y> /<<3]2.gy"Ss̰BU v|(z$.n{a%=hgrRlGnF>9:i@*곂m?/~vc|ū]/YA5k`sIEa!mz:8cl SWN-%AޅVj1 Rz^ $ P։uW^?82'LDPZa[f^?ϻŜtFC±bu:ϊo[4}jvȾ%yR1#PŎK;tkCȻ2ջx>y/l"_N5R3>qr,/ M/ AqW縴A 0=^ ̧xic<+ysn3鐮p^6=-$u:1N"|A5m?fXeOʾ"V]w@$waeufh@mLAN (ͺ+'ۡPmۆHz>-vN^O?# ZϧWKξP*_0t櫷a˗3nNv:[y9Vk<;3H;\;\55oׇwOB2G{C m4˥-N4z6KNSͣ{iӮA@+W=2s:kxN}޶v}w2H(ZN0smmش=Svv=ISS6Oٶ %xnmum>qkg_R=~]I By2H+Ctgho+Cjpt\: hpV)XaSzɋS7hb/z+ -}m;ygJxL"Ķ]{;k 5W yk!"glP=z&Cv=Н-]o_8lϪ!{ vodLgZ8*>m|Bc$Ɣ?X $c~2.9΁6wOB^9Inռb<=M48k~SWhx_pyG[mvH+4/ǎ-OyT(--UPI}|aY.2󩿤nc=p!oJE;A'8DtƖ<ַ)ӕk-!ok!M#}t9.?p1Yc4?{cKg/K |>IĜ"%MM6=${$RU3ĔӊiRR%A1u4SJ(13n꾯}Uy·]-/lF~+ FYבXe3kkAWQA\1 FĬp3.b ~nM֓9b|cSNkǒ3Y0aJ総M8o"7[C6y~HmGʖKV/GFD7-xX#@:ˠv/EDl3e u,o4nE"oԏX,8xivcmy6>t.+ԡ$eqIRc^wy7y=+zOU'O|lAfe[E܂zD@X#D}K-纘m:&h,(!< cwr;='{L/?5i?h p 綋gjR險AWe\lQy1]?qVfkK*u {-c{D^ԶyQVr XIQKE<Q{zy"o*^r NŽysM'_Ժ[O/5"8mZLyשR?ķ<#\h-/c}%A냦~1$ɏĿ"u-?{ L7E^djuÒ'%ލx ^ ˻W%;O)ul d3 PցAI?U`iCf#EIѯ?**Ș.7K:'HKM@Qb"om%򎢎ݾ|OC!U|Z]4#Goe6#5q~|[dkU\;;ԧA,8(!Ʀ& /Mg,'"&}ye(-,JM_kA6[(g66WwYnu, ڽEX0!m쳜Q$-$)I;1gx1a>=\tl(?*djSw0p95j-|}ZPbn y-}&+`69"`y\:Ug5?ůPB3"on/ic,1_ۺ\qS cfܗhw6ΆT?%6ej/}3xM )+}ۍj+#~SDK%S{,NlIl=G݆f Vͦ>El.n}#cu 8~ׇe]˛Ah4fƂKo);X(]c4L{:esŵ+ǵu눱Zd 1e/Q^fE^˖Tn?{:p i.?zyrsyo'+ƾ{Nk[죏>rePG^|vyo/r8ͻ}kѣD 6^Pb,^ex^/^8 [9W#J J䙻 n _e_ j.v{qw9 f D{ /Pd4 ͛j9x&yL|ns?j)  ♼^&y,_OZ4 f)v*@b"/k" /^&" oϚzJC=_~g}Vdp>vn߻G4﮻?ԄS"U!7gpތnkфS":jO}~~W2|&Y|Z&y۱o(֘?[?l{ wu|A}'c_QwWD\1vCD?^߿1 E^{7q387&~A̵'yE MPFF<q噼ک޹y@QD|yámxn׽qخljjz")uW$?`z L7L![=%3itOrxQKwCwOSѷɰY|5 }cR+^Ǭoؼ0}Q2S~e Ōi`v,g沛kaz >̿|>3~=\v'\úgXF<8ܳ%bHsku (kD^3D} D8U;0i ow+:bHo3 -^?x gx|PNX+/c7p*[J |i:W(vLJ<1ܗY˸V?hܚp¾9!2 mGqTdt#ϬYKFXq2'VidswNھO(os OS;xFU ;qs>'y )ow8jxYTOPPhYCIY>A'V\:cmk&_sø9J`1T\bN9=N++s#kl#gFsm+PUvDޫC]|1@nÍ@R(,dyVlrɈ IƇcuq޶-[34#c4kE"Imeq" 78Qr-.e~wȜ\O "r"mR/"o6ݮ'?w0{vpX}N E1VNnَ2qew;~t g´ϳ\ئ#/ʘÙƯh?Hd[mT@V\Wi ff}Mx#&^qߴ }@< ƍztG6Շs#m~3~„ ~ bThkkF?Wʭf  ZeyKtx߇tEkV_?fX+\zZ {e (1նyElxkvn7Phiv}A+cҸ<"Q_3׊c}}c)Lބ;8>>.bWYG5+X]zJY*D^coVLukRQhWv&}ځ<|?H#3U֚n7ߎ"a!.HvCQRVvoD40'ɂgѭܔ)^6=jY1f^̸_,ˎXEyrHۆKқ+}ھt͊,%$V(i}i~ Iz әcKğ0Cq+qkSe#ZQ~_estNveDD޵_$YWb>yӔp %)F}&S|DcY&I Zi ݞL"ñē? k=AU~&H#[f (s'1zr# %i X7 1WFK-۸<ɻa1 wſ*l6F}0C^疚iS/'h_R?vy;; lpxܟ"ܵ؍ ;_:9UQS ibc$vT1Tِ4!%K` {D^Զy"V)H/Mvq@-yfK>NƲŅMz:h;|:ފc[zTI2sCUnG؉D-6Ʃvo*Xtr18Q>H,A|l6YnLYLjAցϣei_-fn ǹM947M0H,Lbkk59f֔%[ ,ڲA>ǟ7|KF\Uų^pĮT$dp@ൈ? n.PT}!tg>Kį4]Jb/A;iԌ5,x17F:u3> ~6ٷlHn+ȶ{#-~# z(b3Y TqpLQj6҂Ú>DULx鞞WgȒ"smnc^|G3rscY}iVV@o}}/6FGS kbͤ\Nf~W\SAʉpnxY;?(/|XƵK^CsA=⟺ƈvH$8=[Fsm)Zh\yBa.+\P$.ĸЏ9Ņ;5ә1Z7 ym:e,5Mi'1d!$Ȥm&vw QVtRPtjcL!O bBx7#_TR"Aoa:yk*eS~1d{?Q䘎Q+Ibmz$MN "y[m+w};Ϗ~ b(Ɵjф+,Cx1 a{;=4{zNieL-^L3WN? x9ƺ&si08e5NÃwї81q!+F9igN`"QP8=΀ݧ|n y-}&+&gk69"vyDsfbȳHjBY(pfo >nZDMmd.VS>on?1_k>hLߥ}307Olrco7߮Myf>-݋Ly8}%Mv (Xe6Q~N-bsw>n8ak@6wc"J_"T B13\z_pP׆pNIADJ ӞN\q qm:blYf)ϐqC ugK,!婂Rl$(g@ؘyblGx?93\6݇¢%KaJ2OoOND~釐t5}/7ΌؘZwm2g㿺/ƍ@7aט $^3_fHH޿'7Si7P`}L\zLz))"灊8<7'u̞nݝ 5C'ieNTB+Zi 'y?[GpbڞIL)uR/sS5mZlYqr"!{Z}9=7c߽{-G2 BDل W"_y/Fא>x p 0V҄e!^ 2WJ3pynD^k½*xUp p \^ܵ'x-"/- p \1W "/ p \1W "/ p ‚/>+280?Wܜy@ajO}~~W2|&Y{X7akLޟ~~E My@Qw>>A;+"k "  ߿Wܘ"=r}nDDyf ړ"&n(Z{Z#~]{׊L^T< ("ֈ\,^zŤ<| ("ֈ־OcBwn_|k须dL0v^;7sW~L|_>c"6wu~P6ga҆`]ֿ=/8(a{pyyB{1`c0Gl4F?aa֬r5~=\v'\/LʘeD^ /_Q{Z?̭*q֬{3{yĶy9خ&'"E^Ks#Ϗތ+ሼ N&5̆QM-ܼ 3I5!4%ӧOn&7jzRP [\dnzlM12͒>p1aX'9qŏ%X_{Cfdp&%TËWaXeX;/D%&ږ"uGU|~~{D)"o/VlüCPq.~3z8ll`7épcI|fC1+r]o)U68SC[|TtX_ǩ8>K/vnXZ;ubClˬe\cnM8\aߜUkn؆ëR$wF*-rti (+>* "mԟyꞢ7"`7؉9s$TnWYהyYTOPCK|b0#tkť( skn4cNh=p4WH_cw< (1W~.mE^j[DJDޣ;{çZp#P 2 YF^fuY:Ȇ+Пiyk|HRk[~l˾ c4GkE"Im猏eq" 7GwQP9YD"E^9ۿmɣ9yܳz/sEaz;hz*]S&ucz4bMx_ׇMn&F%cղSmTo r7Yfsj#2GߠooT7VK!&(UW{݌h7ECj ۯύ͜ȔxY spB]hEsW(=VƵ$_}]ۗ,錙q>"ɍ hbm[ukeKyp|yoj[^Tjxmvn7[(iiv}A,cҸ<">"k&Zϻ?bCWb<L%XFLFAKYLښ~J .M66 HėP|³O;0'ctx>ciq3y&*cZS='DݴoEBJF$+PUAbhdVonlܒYo[*庲B.ny|ޢ uǨG-ʋGu-Kқ+}ھt͎}ISt^O) EIO+KO[ y c|m ӎ<-]sIücS6E[6\ Xs0?woqN( ('}@ P)eOJ)ȳ_Ξ[W(>wx+wgOhjED (?l<^+MglS[bqǚvx"k=5>ͫ1(8%807=F=)v6BICFl#nBElz97nq;;nY-B*908N񂟳+>^Yl1g΁5"G @Z|9Aؔ1ǴYIi˄yB2vc/f *㨩g1~`ѯэD^24S@'Fsm/F,/Ms@϶&y16^nn+FX]U' zc/^f{H}bcjvmtr18QM̸~auyQ(ǞmPH_-By-kN@om9"L׫}z? lML-x|4/ZfM5e "1(w5GbmY9A>ǟ7|KF\B*- h:}Z'[^V"o4*vm B|p4]K?ĭEbPNŲG+4F5cuM='!z|f|p*mzomC $7d۽ܦi=1w9W qQθٜp='sXO/҂>O5=_h{:_ş " xjec^|G3rscY}iVV@z,M}Y;ƈ~(;^aB&LZjweD%&zP<"(Z`X'yLeV ;+'A3x ivk'QDy'uQKi,Ԏzϸ/:l5y~SM|J@oxxu{Mi=Cƭv\o8'NE؇}nGisrboqt4+5s"l_:g ׺X$mՈCG ê Kf%F)} ((-(˨v/3D3e uCo"vFNNZo[Qt?3ɣַOQQGnMRIDATKYH\E ly G)he=,c̊Bh~XF__Y嘯2Vk4Ȧse&_܆N>Cm7Vw[4 bi{>+,CK|>~e-c,IYIޭ^<2Btl;4{zƉV΢a|L9t.O0si08e)sÃ)eZKc ~ֺE\ZŐrǴGm>>{qr+IdM~_|n y-}(+Pπ69"y~.}ȳHL[(pAR싲|␬ةN(~, c;v;y^Fi:Om?em`b8S1_k_-c>NpLlSz AoWFْ&z^w[ lә#?>>>E;7^Lyڐ<,+lK8/5 Dc$*јḺ;Ե!SRGCwP5Fô'Sxm1]|\[ǻx)5Oyle+Ȥ?3_bi$=>gHyZ# 8s WȺt33.| (sw+{"o{GJD(+Oy-j]Vtٞ屾 ck FT$gN\.njyz{u"v|t5϶c}O gT=mc8>+}pdƍ@7aטO,f8Ӟ31ԗOnhuoHŞ~3q1yR\S-؞ l;b'G|YKؽNMynN{2Nbݝ 5 6e;Vt'B^Ƭ`qkIu 'ɹdnO9׬~\[kCbq/h"eKVU5~,Γ{8Y1ݻwXb}+>yo/r8ͻ}877zm4lY"/ p \1W "/ p \1W "/ p \1W "/ p \1o ݣuK^Oiif"sw?|5[9y=ṻ'Mx=!֣ [p^x&a/h p~""oW^OiDv~jZB p,L+&&Zo;o\E &"}/ݻ5[O$?vOo~Ϭc_`$o'Pgbt6Uy9]T$3ˣepcwMǛEP>϶)|}~ddD -S.od^ 1@S7 ńv !.kx|PNX+;c7p*_)™̵[k]"K :x׌ ).a uhxO~,zJCg.Z %k ?w^"6{?W8!/c"]ލiy-[ )y}c'nM*I9{Oaٍ} Q{j񳨞JѢև>&_"b{ln֟UT?%2om~n:&"_h) k7is{,t??~~&(uZAЙS P=q\=]%f?ߒӉtcM4$sm7MAV|mE/_{l"\Fmv[hQÌκ8oǖ-I{Hٱqnuv \~ Njr-mc;>+Y(Jhh_?6>$sϋ;ɶ|I3/l#hSPkb;o/z/;24[Dڌ-c\ۯu+P'򖍿%>f .{u֬_"1yE}/_tw7pYqu1}UmyeT_KsRNo/nM!cV!(pԉ:!MT]}#,ɕ7˻1S7%o548y )|cskOǪl%Ɓ>ħ|>}0z85>4n,q3Qa:Jo;I.'X:+UAbhdVon7n6 K҆G8=ҷu`Sܘ/2/dX›_Whϴ yVi-9 zF|bcH_`q"M{_MwӞ)JC}s}?,q_':[|̅%׭ ?7楘Vo*J=sjH'=bgS5M٬(9} HTv}XڞAVbZ7{I <-ܥ6BIڽMS(2MÊ|6ZrmF27#>&,22Dll!e?9= c]A'Y7qEޠ}Jbp5ޯs`Ç,Re{cD~k  w t'~ٟ,m"\)$8ŧs"(Ļ3Dh'O 0+}a4NytqO|?p/MgTC{}b1qM]b{`aj*FZlqE[i N'aTW cpzdD9*4ZOl΍A33Hp޻w3ku>~<]B[c|ZL̍]bcǍ7:vZFZ_#G+qQsJ +R?nZD3k6k b6F:u3> ~w.,mC ҈H ȶ{#-M <)b3Y D1 F;m\-Xq :A|mQ%[(MgOi<G%Lŕy>!>LŢ&Ս?>O"s&Xo&׃e{ck_f>>נ "o #OM'{s"bVbͅ%MpX컖Qkge诘>mؕ12V1(yp͌_ e)7}Ҵ}o_2f5q/q7e_NjM.LoE`(tڽ̦IDh|UR>Hj;J Y현2tk.|V]Y]24c\k/_F?S^pe}i&gV1':WK/m֒8 -}.OXd}x2+if[dcuY %"&ڸڗYQ>}UOEUER',xcE33B]O m>ӔRBdfʛyۻGe|HME^|.NKz-D*%}"ix}Ҵ}Nkg\oZ'٨j-ȧo7Ʃ^T+",)ozzDpX#D}K-纘m:&(H(>.'B[r׈lSb^)g;ۧ:Y}>ַӲWJtI@M~-^@fԗؼ8FƇ8i!hAK̶pDpHǡOS'hcx.D uτᚯlWλDb3֟W#򎟕>Qnp4+X됬?Z֯ư)Qp/x\|ӊ&Z٘የb"1F[ޥR Dx45䋕-mQ+.9ۢ~_h-fCהži 2xgMpstӆ 9]w]d P޾,qYKuF6[(g:qC٤P8ɋAk m,۶w}WYMbp>rL˞cVR~߶ϣ'RDUT}Ʈϴ.]NtOO|ȼش¹/9Kڗ!𯱏3S/׷.{Kzfe<y X!l9 /򢈳`y dͿXT c;,Qg:`0c8qkM/s~ hUg9vO|?z_'CƵ6n Uqwi_Pok[ei s3}5nl3Ϳ]| Z 7gPdK@^w[ lę#?n7ny[澁0?_SVdydƍ[;ya 9{Ԟַ?ȯ|e0L^Fo(֘?[?l{ wu|A}'c_QwWD\1vCD?^߿1 E^{7q387&~A̵'yE MPFF<q噼ک޹y@QD|y}vn;D^NXkwS?Wyy&ݐs螒4^y9wfs(;L|L!qwd,>1}/c7pl^w}(a{pzӲPb`0;3s͵0F?aaa>..aݳ`SDl,#lo[=[b)4{=f]}"F>LfHwpuXmv؉٤4f`e&ٖcnZʙo ̍ͤUB]^'I|zV>,7^cKkIfI?cf1aX'9d}{u*L?wqoY[̧ )*6׍2Y]7jtjiyPW5wFl>7JLmmEt"}sB(oF'#m!vy>+:bHo3 -^?x gx|PNX+ǬoT3AhuЬESg/f>><汏qZ_ƵA;6ք 1\涏s3^{b6qO#|f͊]7 "鹿 =E3oTEo7s !Iaٍ} Q5CϢzJZ<|ESN :ik\3 /UBjMu M׌̏]>G{D^yׂ Phpn5_[j^{S6 "o3:m[ghFh ֊E<+;N JQE ^ [~~ȵԺ!sr=<57mSۻvQ9E>7&^<}~8u&UqU6ibE?,ӽB湏Rִ(S\L;hՂM@p+k6וe}Y_S1H<$m7MPڴ'QNhߦ>#|^oO0ϔxY cpJ:Rc}a\kL5}ΘG#+b_?Zbsk/D56sH (1-hX 8. DGW2m}}l".|^yOM<\f3𧏇Wclho~Qo7ߎ"a!.rV()d7w"FbhdVonJ|p\/IRǞ7ЌH_71L3^^(#;bc/?ʉ#mn/Ko75k5+J2XC;XŧZ%7t&Øg(L;7yücoDn?kk#?] FGlFl7fs4G-X+6._uU6}W܅?cLR(~^gҹF=)ܥ6BICFl#nBElz7Z E>h-l$1s$T؇\[ ym[jƦ%VN-}}lJc獋o$γeᅉs֊wVpb7{+?~1fVGM3># YNmΪ~czC2di-by@Qb"\jGywn#B_ D"Rt<{_k̸[6KB䍋#qAv‰MAR$VE@*7ۣ`D"oTH`blɩD dicØ$}dPϣei_-fn ǹMii`_o`jXUo`S&Ҍ\ښo lg^Y\e|?eo:ԗ "r"o)RKL ŭE^8Z[fc, 7'$?FO |E/u3> ~6ٷ6!i _G;;lV TqpLQj6҂Ú>DULx鞞WgȒ"smnc^|G3rscY}iVV@o}}/6FG`#dEpd7s9{]qFDވycm;[t;{jz]BdgMqZ+ ^Je_(#hd)|%qǬvL©1+܌˵X>?z2ULoqʉ"sXt4+5s"l_ QDޖrktf"؈Gtǐ1DȮ| (:"ot;{jlޅb`ro7h en8{ =)h>Hs]6p4€l #ہ9?ٛgz$M4r"IpnxY;KQtMU֠~I+2]bJ 66FG`#u0vM\ {-c{D^yGGUdc),+Jp7)&kfY6w[.A~=C YQ!MmW+$77RKSFl>g燤$yͮib+N} &gH?ZX_c_ |xco{$"{u>{|]'"ț'/ W+>t;FJJSn+Y 2isbor+lDpn^jb#C|N-1zL‘ 7)ALO&u˘|S@5-BB:yk*eS~1d{?Q䘎Q،̚}$.֦x>AryojW%(B}+S+Eޱ\-Wֽ{||Lo#^dӹō}FolonCqez'o6QAk P bڶ^>Ebp>rLiޟN+MHx鞞SzZSzL92G.g??G?|YA%c ~".-bȈycZyǧl(? 0)dM|n yvNP\!bf_~j0dlۍצe2+3Y\5f8Man_˟dno3Ϳ]| Z-gqdKb9zm64P -g["v}7p>>V׀m>D֕jFcf,.ᠮ ᜒ:zlZOa)cw+]A}>C]_G "k?>n藡T#|3(O>dsk?N+&n(Z{?tU17fkO"\|D|Y0$ < ("ֈ~}Ǟ"W^1)O3875"}SPĝ_|kmxotoͿ=}۽}`Ύ1x ("E^Y3Iկ~݋޽{}CmY{FY#jm&vN3DM|_S(N>_h6%lOpmwoF.^ol`M}p@ĨR!dl޼ϋ.j>XQ1N66yKkx9zF&_Ob\} Ga%c`3cwxX7smBUg2k?T)Ž!fZbl1z1>6׍ v{;Kjiyp!3]?"(1նyy,y\ՐgW2PuGU}~6}G8*pm,%SSlJ"F>z8J#&.*7ŋ1q|fy |i ue3Nc^z>A2k}6?xnM8\aߜUT8$~_T>SuryoDk<.(#P-7"nMn+$)S)rcP8kñ(}dCzpq4 u\3mqzkXƱpYco"yRC=E}1 CwEb0PȦMjfk ">묋1Bh/2E<+;N JQM k;@9YDD^yVz}|ߧ*1QuyqKr*tRse-X13eGPe/ YK;%;^"FjբoEmqdYQ51dا׊>(.Sþ(Oܹ?pT !5d6mzK ff} &l$k6 >u>;ڷ1|A}&!Lg_,Hhϕru*¸~kw;ݟ;!13^%~)6>6FrcgNHͽRu.~E^hXfO "y[l"A^Ƽ 3PJ|KDͱ:i7YL1Cf/){-˗2Q %eU[A1IYt77}1n`-n}`Ȗcbq7ZrmIKc؆T:؇\[ ym[ @Z|9Aؔ1Ǵ[~v5ppxaܟ"ܵI\/f *㨩?DHؔqۅczC2,}:&"yR;kŝMk&MD3$? ŸM>_ k5m]'oRfud ՇpUM8oYI?I>e6B~TN!_-mCJXwzo :[_l:98ڠ>eiD#(y9"o뿵̍}tɞvOӟ E{\[&BM_E\{{wj~U<|5|}>Dļx8jc{נ1Sy3(~ڗ},o[F g)SL흉Mipfx|8 Mr^A;i}VCƇԩʓ[1lRI zb Q!,7^CUp0-dh߾ \ܘg5}֯/EPdkdwo}YKƈ~({`M ˩Ԋ "y["oIH6y#Sda"Ie')J BLDmEH̢} ib%c_-c%fi[{aFӾKhy-! #%ba~ëc=R'Uב)|%q.XlZcۓ~n.2[y0'?O̵cI@0ܥz2W:}ly{e){$NA]y&ʽEvSϹ@Qy酯hթK5וtqTwRQOhT"oM2M漧 ]V42j6SӃgm'ߒ)K-QRKy} eG ׊};5&]8~cF/?5?$dTrpnxY;?(7e jt?]bJ 66FG$Yy?hwb=67JL䕟K"oĥC]zmTOFm;qjCDE,b1>T DtJƤAM]0>3iUD\R(TDt9?Ba`tB2]I~|~>w `}߬p6]-&ʼi[M ~j-/c}MbH+Ǔ{ E#pbgzcZ.Dޕq r"^,)%B\\L!/ykDבt,y >֮Lo=ZOKO}ybdZ3n3Q*Vj$73Ô܆XnB ߁L|Ep?G},B} '"ܐToRG,: D^ߢ5pA_g8/]yMet/Z\⏠䘎Q8EkX^'7JLmsXk3QZO|)?Kt\:,Vhs7c]6=0$<pQd"YOX2ϫonCqe>#yV\ 7 Q 1m[~ )+779H B9wz\iKʘZ30g:ܦ~ruGMk3_Vdo7D_8Pa./ț>.i9>X{6. pϭt>^!s"16ͦ <<ٞc\8.opt{"pԕ,϶=^w8wv$ p>micT c ,O'9Z#\q8^[kM~y+cV=>3eDM쥎1ώ>O٘3Eб7$nҽh),>'[DN6$lޖf 19Es1Սy֯5!*јS߻A7-?ֳfu.bvF :blYf)ϐqC ugK,!婂Rl$lD]YccZ扱IE_sfօDe.ne߿FRt)|Vu'cWO<_L x{)QziP]Ȱ^Z8 Q2[?kGAKl,S)j^+Z[;jxONOڷd[Y"Zj Sf2؛J$kl NN|OMoMLC64DLY?yxOEތiC { $bWQ|-ŋs1pS/]'DkJzaz3Wӑq!2v=!b{uPzkIu 'IDY"\[kCbq/h"eKBd?qtߑy ={<9ڹ7c߽{-G2/"/\"EΞ  zyo/r8ͻ}s{ A,!fЃ{XKj[̖u9Bd,!fЃ W "肋~le= zyAHK_3A+"y⮱PD@"/ p \1W "/ p \1W "/ ?AgD^矫Bn< €=+/~ݏW587D(1x~^74uYǾy@!DpO>qkOJyb387[bI^UpK죏>r)^+3ySs{C %v7]"Iٚ@!DtRɟ70\7ݛ7{/؆~uL'xk须dL0v^;7&Ķ=bQ_W'EQۻ_Z9~v;Sy7i(omG}l=zx;1lP_s^,ۻ!!EeC:tn͔dwbN}~nȳwCa ΂kW+hq~+ۿ7% D^׉lT Mvs> V("F Q[0n@|Q ,P+yL;lMlso@/"&m)aAj/n8 ,q̌˂̡u::͜l;3';D 7]kc6v璱:xgw*N U6;a\/Y2"dyp[r]" q["ִ Zq/'Ww>rZ [W*hS#{D^׊j )iaVNRlJu7y4z_'BQiD/24VmQ僂RoT3 U. EO!6}ehC^WWGS;e Wc|lwo#+7xe#G" ț"ye2џ~Y6 jHn`+OfcdeS1Fi$6Kek#*"/@~ȵTY2'ӂ{CܖțsrӢGz"0kl|; <ϱ5IF^y\¤oEMRSQSmz3:aQ>QW}2vK1D.qc?Sk=!'pd nVk6z9*+r5B$mܷM*27}vt>pRCLC0ϔXOBXcE|חr+?6(y߾?:e豌P.+o(˘ tl.Y4Oؘ7֦c|ۍ2u.=Bd^_Ƌ{KWD&kVyig1w/Mk"T(:+\Oz1'7ClB1\[t=M݈߬fK|IyjnRW9moUiX8%>8mAi#׭dE|313×Lhy1zח ʋbđ6 qs_3/]")#y8gJ{z ʘP)_g7Cy@afC/=Ci ,~~ڴu[C]|`] FG/mIA!^; XSvgڴ(q<[^O8'B<_=&K&'4m0QP3r"!VR*r"\['yc}!5?E5"v8X9r)#$5;+km2<\6tx9Dy "Y;C׊&!bmڲdbuv!%KF@ {Cwcc L ӈXhy3B&>5 ) j=랶Xma)#)WpxFy=9kǍALT}5zUuS94~]|E)d@ tE!kb5Deic&77p.1boE'Ѳ4qDY[ss yH^|dٸh!X?Ո/ɱb>q1"oK[N{E0.A>Ǧ7|Kx "o/`iXy)V.Hȴ>tĜO3Qy׾h=sb-RRlܶ\O/?mimM=9ƠQ jHIϋIo7u"tc识Gct6d|"gyfXZ Eޗ&L,27<ŷ/|4+87H"fb)QS6F =|?x.Emi+i76ZZ~W\:b˜ǝ D{IRCkNJy ߗ,m˘)R_hH\ガ:2W=~9 7bI4!P1LI!#Vʈ1EƇ8n8#ᆼdx:be~L>O)ul d :ùk*ІݗćUPrL][.}N\M|D5 S3y5*.DoEi'hˈuGGxҵm Q52ZLN XMuA1!<7n!nPM硺]}i&V= 8k/LoZ_ 6ohc59H Qo }Ozǀ&ٗiuƮA}x鸚>wYL1^l><?G?|Y͓ Dc.2?w9ಌϦ8&ŭ\h+ihK#k&ֆ|n {lkyv6Gqg]}9٧b"(vwYN(lvb5|\suΝ0cCEWƥsw.eZ0DXGE{ڶYcþRƢ`\>m Riى1,"oy|M=džil%Cbܤ}{qнl27ad°a67W$n+붌[M^pdy[]P ֵEԆmF澁 oa `5!*!ј .8[8u˧;ϦĄL{9-kWPkPoheY3fc K!VJyIf郴}ߛ1#W]bmڸ'.1-ؤ~"93s " qU"o(-aYVsGy"1X'O]N}M;kןp匷1{J2gOɊ]D3z{)gb橍#LomVT^WXvrL>&I]'&rQ8nj/s((DP_one {5u{^=s?7ZZݣ1mSBl.qV)y3 pS#=:]Sݝ ӛҟ lIoΟ;RrJs=:k}=˵ "dn~]ʮ/|0Yf}UZ䵴|Ky `Dyrs=7P.~#{Ch)좐SE.LTe$OpS n}sa"2s?Ǭk TYY?#Ky]؊gspexaʉS;N%T>)$8k(7x`O7K8 D^:n7 _8#Gx p \1W "/ p \1W "/ p } " 687|  DDyn_1D^{E^+nm" "u|*֚/UOON R.DBw}ᇃkmB&ZC8/7__kJ4Do(֚w"c{2|7{[5TG须L{/xy&͐]͑{uwg66ݎJtSݡ,G[!cga}Q+%m}̅r|X8_*^c#ƬC.hh==H,Am'"/\*u+SZunDAVyDu嚘6پ-lBnx}.JeXe5kdV&&눼#Ϗ]#Vܕv}$c!vf?gq`>G C00MlHM;ޘ2D 7,1تv[jt7MӍNc޻b@S'fާ|[7pRD~y?gV ;2{j*\'1o^cmˡ~Eu^kd.k?tD Y"ӻ"k8=Aʐr7MVԂ1_J{[}n9lǂ4)qsTǦk#~sy8m 5IQ-%žo䷪-zxmƺ6:Nf6m| onLC?-0+'.1T ):K]{#X5yOt`"M3m? Rv?ḉ*МZP{E"ye2џ~Yՠ<5yꞢ}xV 9r r_.׉H nw:kyϿ8F5|/=pjy^y^y _yo[k"ܖYͩ"J][?҈zLB;"/gM[y#_{l"\tq?㞥ڇ[Rbմ̵"c.ƓxzW]A䅛b{K\ڈ{#^fOkM^3?35kswnлȫdr7XSɕMm{\@YaYkԈsrGzI ,-%>ayX%o%L1x]ڴ-k9?1ڦ>yØ,mue)ɛ籗>|;-V Ϛ o6mm6ݛ4bӺqKZ Đ)BaLƼ},l񢷻>Bud:^gL: זm]1""BԌùp!E֔:A!{$OôwͷPyGӯIEe.\~֯ua8TzhiW~i yo˿tb}dOONg6Mxm+*"2}ۍRt̔n> DX/;\}^eDB Y \͙Xc?5H?KO.V"y/E|bf6cmmD~cT!1MQ26_24+ZY+}m" _Bw&b5{~fOG6۹?ׄ-E^”& B\x̕7> mI)VM A[c[%!0O`SNִ1B80u͵ӬRΊ(H]lܶ=`hV%yqnu|>_xDB~/ 4RZ!fm)b^̦i8b6p7wƾLHвqA*RwIh#s09>͊`&s2ٲ_p /c,kkփe-a f lcsh>b3|Z?rX%D9yk1zimn"!B\Ӷ&en&>_ٱ:;fW} "׼> ]Xh lz6yđ6̯{b]2ŧssA| q.ǹ."з[7o7GTئ6$]WwT;#i4dlٰq3R9-yLo'/yi:.6|>3s}BDʊ\Oy=͢QM،SDo,EyG"OrFk87?jH? uWDDWks1Vm[l~)4{R_]y뾆oY/>Xʮy3m4`fs>b<ޝ|ֳ8k*nܶ¶ӫؖQuJP}S_7 )IY%C3A4m+N-ݸسNKK?[8/NwUR@ˌ~N"ZF~Nje`mUTΊ/굧Cd%+^/ؘ68im~ҧ⃭#F<8Z P&"oݼ[Tk 7bDS-V8 D}:[&I[xo2yj=iu^Mqԑ~TE&-);Fiq.LLJE'bc'l+7uO)kf6M"7U1ʍ~BɘbO\ l|6se)WSх`EE0ƽ9Aщ2u)-j}Z=c'=VBNuBlHlǺ6^SN6Kf</5)ز"Zvu֜+Vj4e+wuA;(ӱ"6ĺKN6K~<'h+ue:}>WĻUͲ]ߜ ٓ՛-\l9iѦؖZ׶cN_InʋD̼VX#˗\pmP#ekTzHK:a=6CT+,iש|o cs+#/,bEegWu]y/uFЊ0w]x9WCb_K&^ 2R44M^uQ__J5ӈ@٠X}Hl!*ZC k}"Sz_g?Y?lms"XOy~~tb7[dSCWGޘG3UԶ9WZ6j> ^MlrSހƦ7g{ӭu'{ wxSO-i-Qi'VBq NlU}݈?$^g]8Ӊ2r}*?( O%3OJaw?i''낉"EƁP)M v.|mc(](M%u^K>츿g#()yȋ\pc*P"2y+@Nj':@ [|)FG"8! x (k n TJ# >Uީ}<9p~"X" gG2~o,|}O 4f_`,|}O ׃}aݝ5[x~P]/\/O.v{q.r۫yC?\'W "/ p \1W "/ p \1W "/,/]?" >sUDDط?G~+g587xCD׿kg{]$DEN{O>ڏ"⊉ < ?{U̍Y(S+&y@A4;n~ b=+nh"5875"履~屧x+N ""k|WL ""lk{=!q_Z`;oo̿P2&;DEٹ+?k&iկv{ػw?p(~{Fݮ?n`uwO݋\;}Rܜķgh(5> @4>x|Uc 6e%}08%cإNscw:k?V~Y7\c.I Un,cbyojۊ8 {d^ۧߌ-NF"B0 }8Wx.uF+g6Zڽ_2ƥXeM\GKguy=3AhuЬESg/f>><汏qZ_ƵA;ք 1\涏1_׵v={@]I3kV@QN'y*102?)j}hOQ0l33V\:B0LfuqsX ̣ +a{XL]D%&ϥvR79F;ܨ YF^f O.>Q? .ؖ} GAh ֊E<+;JQE ^u}V\KEdzxjyoy}$sx>Memr}ox֓C>crTLM˶LHm*7߉ͫnbezh9GߠooT7VK!&(UW{݌h7ECj ǁϋ͜ȔxY spӐǓZJAUL2_<%v?KwC:cf!~)6>6Frcg6e{X+\zZ y@Qb"oD}B♼1@\E^lcp>wxdgɯoʞ3/zrL>Wǻn,Fhlhokq]iO|; lEIY$۽>>MCS$ EzsSCd|>y}sJlAhd079aE Q3/\+'9Z7W},:SbVh į0ޟy[y8 ߈)zݲ"k{ip d;m=)7Չ"ZB`M+o'@={n~2v̷<} ϖkGwrx=,nI\0807=F=Hm4TG?Bl!r >.b'y7+^H%tF !^sv'5?;9F5h9}bB|S/'h_R?v9;; s|pxܟ"V^n\s3ŬAZe5,6Fb׏Flso2^2Γ:7JL䕟K8"ݮۉ9^SD윞 Zi.(⯞&D dOs4qoZ' z/^f{H}bcjvJ"u 16Tcplu[D̸~auyQFRǞE$8Wu@$}D˚*&&п[[cŦXXO[zS"1d~K֩YciF.mMY{ bkBbmٽCg,MRAQ.^TsxNGϬ"jUEҩȫ]"OdX#܎WH 87gUfIn+ȶ{#-~oZ$DΕBo·9㢜Q0p='sXO/҂>O5=_Ԑ]_rЌCUp0-p>Z<ŷ/|4+871yMkw6hnkheҔއ#_l׏ I쩵Ԭ˞'7JLmmEP$ ߨٿ`L]k{׋;%Β"oI!xԿ 27e__ <}󝿉ϋRFS-$ւzD@X# mc (/hfϝdovƲ>ǙS.,q 綋gNicwkMgcլִ=&a火z##p*B3:\ӖlD%&ϥv{mFqF-x¬eY-ԟ"8[ 3,;-n{ ) 9!TTP t͍)`)RBCiַ 1>-5"8mZLyשR?ķ<#l>.TD,#m~ؐpCĄLNRGn|L>O)ul d3 PցAI/U`iCf)G8ӱ1_?n\MyWWsbyojyGq6mcB[ib4},kYn&Z_2uax,GKeSޣ|.tnqlP\or:Zm^o"LӶ}WYƇ}L!ZXj1g[x6e{vhK=E=szB]`l=,=a&p=RH /S˴!:j8u!#9i9LhP=G&uoFuNV:/^y۹NנNZs?Vp3y{ºtȼ?Kᬟ>ﴮQ^-=Ly8}%Mv ȉAt&Ed|OGQǍ/{6$(0רy煺hswaDW 43"Ww6sJ?Shuʼ-ƿkWPkxc5/f)ϐqC ugK,m )O]bc$1v`35cRn.뱼2OMx?X;ܺy{EޭyC3P`E{qTD٭D^=1+®3+ng/_>?<) ]Y''X;7FqbwT>#W"_y/ʐG)pFyo+xiBmٲ^kCo@]>?b?V/@gG2~o,|}O p! (O>dsk?N+&n(Z{?tU17fkO"\|D|Y0$ < ("ֈ~}Ǟ"W^1)O3875"}SPĝ_|k%7ݛ7{/s=}۽}`Ύ1x ("E^Y3Iկ~݋޽{}Cmu&3\ cSfk1f_v'\úgXF+0Y=>O=Ő&q֬=e{y6ywn7o$>w;)Ppm^"oэߛ, F/H7y4f6QB&٘ywesoB.j>XQ1ND%e5-_(IQÂpU#^( cd cf.uMs@Lpp- >7l&,Qc^2p6?hZXRs0Mσ{I~EQb"om+*D]}JT]T4'|@|scr[9;k#unjt6yI S@l(&-N҈f;npag\8_qgvW —FP7^64vŮc/iC;6ք 1\N/WDIT>f?x<yoy-ەBAdCM\~yH(ٯoE(ʛu"/"dͨ\j"hZj]9GFN7%Ͻ"c'yNN~~N^yL,}fKEp)h x{/vlͦ*߲RcRϚx}>+Y3f'ZsZRl}lcΥׯȻFvW^j{cc86gEz"VѷAК%V>3#fKeZ~]ss gP6ׂ|N ˕zhy7oфJ{ؐW?(75<ὶxu4iײ|)!S@QRVX%S$ EzsS6 K҆a=2F#1 `rݘ 'e4EyrHYG{s帹ﯙXۗYPҔ1DXŧZ%7t&XLg.i~f<0|#"֦uF~&0[?}yp 4߈жȞ7*zJCmDgE=6`.B@ROi*\[M #~~(Bq≈" /DK(-N-.2L]t_C6~1p~_v \&^8g{gw-vWY'G78j?Q1~6dobH e/LY[D%&ϥvvbgwm{=ɥ|c(l҄CIyiMc6)KOTM֙k|>g[>5&3bc\L!]?koWZϐkIhn*ƯЖހ6!%idS؟S۾EaSm-Ab1ldiD#(y9"o뿵̍}tɞvOӟ ENl߼ZMqbIYs[| khyo *LT }yez7e7/fcoyc㐂4 xY7ג z(*g2>NU\ݪa{DMZ|c E Q!,7^CUp0-dh߾ \ܘg5}֯/EPdkdwo}YKƈ~(uc3Xo&rj- weD%&ڶ"o(HB5JsK B>\k%2{s$C8rj3cK5-q6-V^]kg2mJO(Uh^-"E6YaD,oxxuG6:2T4"it)_mGIc8"fqVHwk+|lsÜ<-2׎%yOgKmdct~؄("ozS`5:d3H5,[d%I|_{\kEʩ`6^;E>%rQ{X6T\>W>SEޥ*х)4q2jxe-JG=)Q 5,lӏlSn%#B)ˊRF3=r =OXj Zc8.?JFVܩP53z!!㧂Ӷvxs35YAt)kPcqE⟺ƈvHzaU~ZwZ{lyo+?iD^ϒU+3E[IJէ?ȫ/yʗ!n[iYGe.9dxD-0Ȋ iM_ t%SZ>sf9s??$} '`&}^0~]pt(JS~o5y&x?Gu ~Z4!O~5 y>_Q荭kyȻ su"ADPJ fxwZfX#mmy"))N_JIǦGogCql5)x 0%! G@VPX@&?G},B} '"ܐToRG,: D^ߢ5pA_g8/]yMet/Z\⏠䘎Q8 2 qbmz$% (1N!U(4ʞ KjZk㮼-Ř7}bטvܹqJ"m+M#6.fݏ kH/xeYia9뽯b_Z>+iKym(g1o~á-6k wCLۖ+BM·(s>2?W==i'2 /&szB]. u4ua&p=j/7T/qc0oqiCFc~ Ǵ󜍏Oo,P=a<\`MZ$;<\'s+md!\k,σ ~&5Mj˦uv/_νl7/\T)*x3\ŭkIl_-ki#lϘn1J]d@t }`z)@t/Z ˲ɖ6sS$ ߀u5G~N-bs} g'cuc8~dMyAh4ǔUJEրY3d}/C]F&K;=7>gHy#!v\#G@ Ycczo: 3GלuF[+Ph=?vPۋKb i=YB..S_D‰%XT~8Q{_琢Sgex?e;if}_!Z^}˵I\oV}4$AWVI]Z@N|OMo[3ʴ'')'ߓ)Zݣț1Mxh7P`} ͓q>,R8gù 70{Btǻ; 7s?\؝?I+cw:b{uPzkIu 'IDY"\[kCbq/h"eK6Þ7D^CG!}0;ONvn"bdwީbm}GL"/@D/Nnm_|@ak -fB=6P"/E u \P"/E u \1W "/ p Vן0 0 0 0 0 t;؎ 0 0 0 0 ð!F,0 0 0 0 ðK5Dވ baaaavD^ 0 0 0 0 .y#ȋaaaaaإ"oBy1 0 0 0 0 TCX">K0 0 0 0 ðy#Ȼiiie`aaaaky:iuZ(~t|~~?SD^ 0 0 0 0 "oByG1mov??wgrW+0 0 0 0 ðy#rM"B ?Pw^^0 0 0 0 ðn AVm9+y1 0 0 0 0"oBy׋"gj⮵3z1 0 0 0 0li y"SD^%k%w0 ݆=v?M+著caaӞ_}{]s i y"R__kȫ 4WXWɵ/7V8+]s Ohmm}Nea?C l7bw/|C%`L![)i_6E9/oN|L/Ҿ{kjw1 |fլЇx4Zn;4;~'㋛won27Nak5F ׹8Cn&bH#W'w65Dވ6׊VJ bkM;훲}W jήe"?v?~>6{^C0 ;Yr=t:#?;i~yQM6ζsnnso}3&>|)ȧYc]~0Ԧi߾Q^'fp&h/v< DJmY,&1waz~}0p3˶5.͈}^c25wy#D^+^)D^k;xI9Z&{ϯդ]iO+_!b /,NF"BlM\o bb-^.\oMӸ&.ު|Pl8qcRh{-!l~?/f1~=/}D_b5f{dߘ}g| 7b!E&ZN%ZB&ZC""/aiWkz^!M*XBr1/B׷P'~'gQ=D 1_!hԽ_츖cv("W?y1쌶̙]>G|,"oB^țx-[ix[bmqCvC0 ;ɍvy- xnSWk^V, '#4 >l!-u;儭!|M}!"/6ݫ/ʵTZ w\+bh 6]J൬ykkDޏ?x(G"s{DvݏRx? r{&Ϻzb }SWڣY(VEmLem2쳒⤊^M`"Lo_#lL"җ3of1Y̗sV:kcꏳ`im^ D>)݀g756Mff}Mx#A&^qߊřڴ8l>]a>텈}q eeXzqF|s[ƺfec׭9 bUD~3~ׯOc? [Wֱqc%_h~ 7b!&ZԊSHڔkiyE{CG8H9Z=5yEtO\ fKX 6v2k9g,* f?|i{@kyU*>rߴM.҆ q a)52^~ T|VMbӻ<i,C-'ۆ ش*aM6r=}L6IS164Jʪd7d4'qEWomAi#ֲilɃr–2y%ނ2$ņOb>q97x 4u 04ֆpI~WVi/Ī 6f.7Hc"oe|0l^/Gɽf|uY~![h Vzt)"kuLDYkk?79UcI'Bę(bW< aql)TE|1&튉[M"omqQp .8x[>naTD'*٤hA(e}2s՘OĦџu10 (7̲ؗ1&hMb`#f6=[+Ahɵe9,=ձ0tw濚&eڹ᥃:csy9n^7yz2_- q"VͶ!Xv$L"oC|0lqPեsgiUu F,D^CSBoyNHZݚ km -^kq7nj@ʊކ3KXq˥Meږ2="i`\aTۗwWcj_dc:kHYmvfF0,WcMf{Hۨ,-4 16m~E[ |XLn|eژM㪍&E9$t8"X _d-}3E޳O/ךZvK|3miΖ5.fzfðK3?NkhK `AY[Njޥ!F,E^E57^"Z| k-'ڗigZj1so߻sE'yD҄Ic819A:/£5]<M1w Ssqm0V7?[w=oSmIטlL15^ z~Et8khCslY 0of6F:u3>lpzwr0VFD[e۽rAQ\gLy1k2#f6˱EQ]vikAͤ[̟ s7b!*Z8 ?j"ku9מ}$O̴ZMۿɉFޜrWpiHڬ޴PZ(eļXik`i߷_?1hfJ{17W>B}dsKG41oMџU10 3ks3߄}.Oo J6Mfe_gMN|v)˴_<M-;Na??UIt\isL| Jy6U?7y/%~jb4-5Zɚ/Vy!64mŮ7.Vy[d,F]"ky-V$aWFH>nPJYk1W[)SUU^"xiibD7y#_UFKee~ >LT\LLTk?iVykZݍ5ðnN o7](eV-4S$d,_j͚b-Ɩ<-&x%,9?J6"8-j#ψ,a"/ӴXRFX;)Dު`إ٪߽296s%2j^Dވ\ki ^F裏TaWl.jet2-PițUh5J t"oC2"^Ȼ>N?'ex?]O}*WcZE^#'ޟK N&RkpV݆iga5105pl6[l6s^Ȟm.JEՈն{btM(' eؒ;M-C^+!ajz䫏dzT*k_볭]ݫK2_~=Y{y#r " FUqڹ^kE&Urw;"lVgNDކXeD5Na\Lf> &zGzSb[VH\F=VKA64ǦJcaثMw AQyM|]oa-^`MS_NbRe|\`iŎc[?1K VCh-uv]ښMD^cz{Nv.Vɋd#F,VD5Ԉk^k"2MŻ89}g;| W̥5~?__ضyb0 b1Ѯ-NCyZthBX毈Ë"`L2m:zciQg6M?10 M6MB3z^. \MVw[Xn$eٶ͟,"!^k7Ai+Rwql{r,Salay_$z·$y?K1zZ8"o:_6YJ"oS|0l}x?zxF['jkך.׭\ԟ{v'+xMt/2e[A _hfyuxo DކXk%NFqmZZPQhtmnZX I?Zki4S ð )ʹ&ny4veoʣ7h^f!mjXMƚ `4uXM9okj6Wm4tV Mn}#זK—Xy\RK0K.k ž-|j[نTL5M'GQMW~<%Auf^w4!^Zg?m:uegOn)ZձD^kqieaR(^۷s1M(N%F.Ḳ}ŴceK˾TcW8cOi 0 BlS6ƬxL=f8\<nkC+4WM\zzwe5EL{bV"Y3w֗/~Nss6ŘxY`fN?9 [K)i{qV6tPۅңZ]ݛy 8#yfN1Dވ 򖉼B1W3-5/lK ;EۥaavXڮ4~"% 7b!$۴禉ִT$vrC0 0 JC[i)ʷ1x#f-B^(U3H/M~7EQy=e#Wuxk߽PJ5Eݺy)(VQߎ_Z/ZIȫ_Ʀ{}AQTBzFK\vۄ!/EQEQ*u96m)zE)!/EQEQEQEQEQZREQEQEQEQE)!/EQEQEQEQEQZREQEQEQEQE)!/EQEQEQEQEQZ=JKQEQEQEQEQ%bǏz矓 ry/8XX!ȕK-Lenx6$T֟Kk`%=xO>$6×{J+% B _0Wvȫ{!|>,en+ӏ?a+]. ( _sB~G!<իwXAȻQ愼}}=~R2=WX!FI|`ϥ:}[}{TkwA)nÐWv gU޽_&T}ts<7o$֮z~1#WZ|5_;\/xá:^x]`Z9MiW;Pj.Վ%2nj{}֯XLJ9c>!mRiKnx6ƼCqb<:P~5GPwUY-YmLX5{5I\;u97ch{z}·/b+ j]@OHrFbmh͔}g%ô Bލ򅼥55u޽>h{*򞏎joYQ+u,Dq{ow3z1ѕ^,q=γGSԵ~uvˣo7Z4s"ˠ6\+6w$py|7Zym#Tϟ6!FgwP%n$yYv_o=7]I 9'ocNg3bm[I}dCu+^fzM2]Cȋ|`]Α6&_8,w|!|Zf?K"1! uf]M7i7wFBglA;aw[Ϗ1mQx%A3q .3Cuk>,49&3χFȻQkyOyyOz7N^{X/jwj^T'`>:~o?[99~Qm*'7L+1>'ss=Fd}>[{mW@0Sxz wcF{ݶ}x>LƳ=`?2 |T(8>Z>4Jzyp+ JKof7w;w{1moSJխ{>wfhp~Z9υyZ4{W yK!fjEn.=i^|q۰u׌ck0`0ݲƩ'z" BA07р"eZaŌMYm8'YϢ|s[yʰ1}Գ3o}|J {(y}LGMOhStc|ֵ~e429CPR +J5^?趇Srj^)AvnǍg=n^e~>\/p'x3${WzH ;翹96BfnÚ}MSMօvSC^UQ@l؜i9C[%OWamt/ڲ y7j!olvox1M1{ ac8"'2VnlEx|\ͱ-a xhgj[m5u;}iCWC޹1'`ۄ[6oE%.?x>u.s?ɔ&Fٱ)aPOW5ƌMYs~q5*ctD_ݴ!\loq~Tz=XΉ_&ŏй{dã' yKkJP;qƎ tuߋMjBS.8^w<]~w^37vB^ż~ɚ{Ty6iG%n%zR^VG7>xC<0 b7rB"W'#I6im;oSԱ<|>~h2B^EߤsH3OW4@:gR]ȹ8=ٮoq~T|y?ڀw|!oi-Z=tᦄz ^L@<[{vo tn~`外8}>lB_Z|V Konpe0+Mp[>˻A^KImw&Hxskq6Ʋmozz+Wv.WzOӾ?Nw?=_K?jyTyxaUx_snc{܎KvQ"!o=Qq7yΪcFf yo>49'~T6Bt yn]L`鱻k[?.O/_yFϻCxғz9Z׼nѣ|3_Kț66"rQ/!h^?/p1oigq|7CyHepYkIiֱ.i|7I񍛬.8{;om?rN9zW U}J{8}L-3|?)Z|0sy\C/!/^B A^_x61B^>xx!c_8ft,)%Cȋt7?%x}y`y`y`y`y`y`y`y`y`y`y`y`y`y`y`=ߘwIENDB`Light.GuardClauses-12.0.0/Images/compile_assertions.png000066400000000000000000000560051470750352700230570ustar00rootroot00000000000000PNG  IHDR.pӋsRGBgAMA a pHYse[IDATx^ϫZK^.^>%൪pۿ[^!p-pXu M_SB+V+ (X% (YIXzUUXzUUXzU$VT㯿xwrw_|\z*=rH^/ĪS0 Q)֋@Q\^ql:b YNBJ5*Kd#q_WQ8j: Kn8^< u)oh?OPYUXE&bUrم`պ % (Dz\*,WkX,ˍ31 &V^b%ۏUyR#dTa9_{%5%Vv?~|GU/k_geJw*5naZ?(c+_WCaKgWXg/#w]CnO*"pw?|H,ﺱ*]9饴̕7i*|_T1d\*kv=w{qXl<}I-{5_vcyxkU}sŪB*Kǐ㺿7V/w_rZZz8Kƪ+XUţǥR;y^;òpK_=D?3?uXa?8#{lL w|wNƪu;BnZ*l#V~UuX~߳U뛒ĪT ܈;˵<8Ϊi?wχ}O1Xt6 ?o~uU]!BÂwm7VP/ Ū ĥ:H;]G;sοXU BĪ;)x )EXU>KCqtSW5ُ_َx"V%mcUN!fƪ0]fQ8Ī[.|OOwZUJ/VfbNd޹4&.uu: bu$$L~dcC4σ wi:˽<՝y=Ҭg/y\OޒAm(Vṳ|XziG?EOO5^9V̘%cJq4sZWi*֦7:V[ e8u VSCUe]*~n?s>?x=_0-}5Ī}:~WJS=}o`hZ?UK>/S*F%ߔLHIǠ Ӧ*>~|V* Ġd|ԍ2Qp}i'ƪrr*XuG]8>p'rjN)VQw2K=~oMj,^O}}{z^ĪEg5;/V? a}~b\~pf@Nw-~ȗBJ* 5b]3cU^O/)dJr?ZUģ^sǡx uPUYK{m~y+\sHԸYvXbbj}y*+J;uRqfCq[bcpk~ǖU79? Ǫ5w]͉UC(j><-Rjx礖 S3c)Vܻ?CU6*w[{^cG?ƣu\/j]Ul4cCW ?3 Ūrnt~U1eX11͋UX(iBǜiǠCUyfŪ180ib`57TUV=oٿe ĪS׻bU¶Էf~UX>qa&V4(.m8Ɵj֬kx7Y|-XUY{bUX4?v??(ψ!gXg!X50*!b1"_fǪ^ 9͛#koiL9 wui}P3p8tTt{-׍@u\0{MJ,G8~}83sl3V]{o*>Xuk ؋LA^Rw%͋!~ێKmO/ac{zlo:~'s3Ox^DbU2@dL'ȴ `r*0sRSeJ89w6$uם2m/[-y'StW~lmƪ;sLUHWMՏd~͋!'? \f{8u;#YfT:UG `(IX2%V =n֖ I3I{(bۨg0ec PcXű0΁s]Nˌm6VU{ޘkI\1xgI.)*)DI+uOB*\7V5bT$T?S.IOt)ܑ%UUURߓ\J|u8M:!#z|sloD`1b%bT$K=xpMĪ3;.XU.uWYx~?|Y{(`R'9Gz_MUG4Q nODJLdZUOfeUURߓpO*KDJ{"V^b%bT$ (`R'T@z`eR'^U2ߓp/*XI:Vnw~x~\K}IU!$I/sqIbR'^\?VD5I{qXՋ=_~wb[= ⺱vy~辷0gM&v׏U |wUXŖߟ]=V^1 w\׃001U_?{Gൺj *¶R߈U˿oW)FUw^暱*V>$V&߫\=VTR*UXZg!pשׁCV7])Voe k?W걪 FWUcBXTUwUp_n"X_{sg؄Urb~_=IJSj9*>%{X-{5>rXu=}]OeT7.]3V~>WUDZ=xr.cԹ|~z}}xsvXU|kEUsU\?Vcqb\bp+WU"V\|zpg58ƪO# w%^8~OyuiԺx~缾*Đdf;ƪlBP;cS/oܸXG1pX7WUMlmtG*,^@Jf1G!*utvzo*Exs% D=$ߟ" >M0+/ãO6<۱y=<&׍U>|;UU0I)= CBdz78c]8t]@%DǦû/v/!&%M-ŪV C|O/XUvX.Á5}FśT:3V5%&]@j(t= QZx B3UǪy\g/.#V\ wbź&3GXX\nx*<.P/Q^ _Ξ U|Ԯl+̆G wk]7Vܣ+~gU__=?Q3O;-V T#<ŝV`ĨZsUY۪aL\ j_yDnʣq%S\w*0]0VPNN豼Aq>05s[!VK~zDƪ:D_ &o{Zz? 5ƌ'qJQZ`DcUxZsPZx}_ԁ)HѺq?R\nYu{KśGRĪ*ƪҏ#UqXkNA%DN뎜ƙǪxzcq1£rTLJ~QzμX5k[XUGs'Xp]UQTi?▎-8m6wQzĮfgĪxOu½ &gN;rf/{RΥyjֶFY `Xp)UD(\ҖU{SUU{/Ou MU@${e(dbW2&lk(VUt X X X X X X X X X X X>=owR!vo:p.?QOecQ|\cϟR,I{uXUY.B4z|5>cUc>obܛԟ[qX{_Od;N5VEѝl¯ T6L&ɴ$VbUeu]> ĢS:縋U@L2L&iIUKBPbb:7oޜd2rz΋U!bz_=NؕYįOϧGc=\%\?X>xź{4cc\Xe2I21U=*fQX dzXe2cz*S#)Nt/ĪYJyLFsN /_qj9C?'VM=fMHUL1U&:&rwINX/BdcuԚ=^0㗕U!g^rگXe2I21U=Dv8#U{g1Bx:l^.J]*Vc۸ܒXe2I21U=Вy̮ qi:j8Ǫۚ}ĪrXMjrnÛ_vﾤ޿/_j߼yڽ$'ϱۦk|N*uLbɴI)Nj:Dwp1 O qi:bռq /FD/kJ*D[Ū#/E}k0Ūpa95b]as{cZ]3cb՟|/t|gY_~2?O$xyӟ~ȢzLw?nj/w"O׿Y<{?+eʍ#Ys:j_ؔl<}I- sbw_:7UQ.y^gk+ƪl.GJ¼[zcRo(sXeNŪ1[3\UyktI9F,"P\P\X7ysc^a[GϔXw:mT6̍UOV}y(sVŬMƪ頰U۹^lXU.[9z:~sA; Bj̼p~H#~wy20S},ŪpcƪǼd2~zFĪ(,醆UKS9j})<#Vuޏx&ƪJ'XZ|ܯyj/E:6!%fUGb|b6U9X]/;SZ>` 4 zKb?}n2қ;w ؏3>i\iOs&:7V-2l15L* ][UHO&*…PՄa";,S=EiScU2Q5MwaX=tVgx LW1U:paޒ]gB/Qg!J5A`; xO0|Az~yj{wxE.Y!^/MG4wn9g$a]b 8uzAV:fq[H/V%0…u<1xB0j[PHmĪp.E\M8sC_6Vg^s<j^tIQ% ̈́EbtWX>9]/V]uqya1=wSArؗ͸c:^* ,'l+u1͘swN׌9گq[J7V/QQ;%R?+s!OmXz?̔35L&Osgm3 GKg|13L*Mk/x{ߺ/P ݋Ep w8䖻~]07/~v>6̝18_^zʫ]7^tWkk9xw̆>jǪaerɋ&#Bw3cU2SٟǺ3ew8D!2"L_fkρ5?VM9T Iol ;WLObU ]hf#h_E݋q n/saY)_4\^iKoV}솗YbS;*ͲؐǛKwg(Qz;Kۥ>[a;@>;A3[?7]bU>@5`x\xq U疙M=) Ǭ5d0@Lӡ1v^/ƪ4WLObUF];OZC͝ 񺇷۟eeNP~uc2"bG&;b_c.7؅yں}391cv=U.cU^,1Sn|Tz?5nX͹)hZwjךL:Mc^f2n?UW2b-)Ruq^nkwb}\p wTf̾NK~}v>[%}-\w<90֫}.skiǪecirɰˉyÅ|ǩ`屪{MFPp7}O_BYwVSx/΄X1~m2n?UWR 0̻oo A[csN}\pWm| KR20֍Ǫ6.;7&][.\pBb0uC&$ ƪnx*MUM0\q.Lgs g;ĩǼotIp9b*\ \Nx&ֿ 7?(\{gX5OKEQcI>l5]XG{ە0xzEzew?fэUͅĸ2uM6V8E^X5*pOvw|ΉUdf cebM&' ꋩ^p1^ SR83EcյLs=u;]c))aXRƝ;[l7N050+~.ycvX;v)˅X B?8i|&&gȼbՄu&99=sYf|rC97Vȭggx`;z̫6L*.Kq@JJM0p@K؇*5rrm wxڟEvٟKYiوi/K`o σ\di^<Ŏc͗ JǪj zs S|:}Qƪzcǔ1I7ǫ[2f2?TG1;?VUӘq ~b~jTgktIp֗@.R{ e*1*(\m䴍)IS.p,gF:{Q)w rc)q9H/VN2M^4X9h,rGYO;Mb@PiBA7yű*o:zcʟ|}yu&>Ī0yh1h8WLOb0pBC3L&&dZ$V#Uk2-.N2^$VL*`j=52jȠ~a2n?U:4_~ab>D~1J=JSn Ī_Q?(XŪw_暈=uhapa1]ϟ8/:~t/XoB`D{w`u}~? UBYOU&X`*G:q0wU j}{sS1J%_OU'QIZ: >RxZ.V#+1?}l: &fґ1j;rrOWUA7G1!g(VuS#bՔ3~tXUUq:JAidXXnjӊcU.6V3~xL}(ΌD_a;ow} poEbUgJ,A=ZwV?}cǰ3oƠz긳Xu0yY{>~em;V_Piն>~*Rz6bO WmJKHmYyK="w||OkztIX ĪS_h[?Xp`_ l}b}w6^vo޼9yڽ ؄cUx''_OU_vB(xzI,VX{:aKgUXM]}y{xz?|̿{o` O6aXBUƪ`0vLlݗ{ V6bSbAδ%cU/.c:~^k[8U&,RǪ\` e-qFġLbUnܺ?G86DkGb KĪ\cUt[e8n ƪJ{^KQ>̘S0}f¹K͟I<֓>;e\XlBB| 1.л_PZKŪQI-6~\cE*؜Bd*ξyL~\aq(׌I6!_PUMamM &]wHt݋u{CdI-7sY g^<α>M}o)~-G߹]ϼL1i<:(̛Cmd? R&VbRՔPUMamMb|DU1f-pZ!RW<α>I\Fǒpsujy)w͍Df~*uM1)rjjԶΏ.nd8+Vx<ǘuq~O;αxfF͛y:MiҖU[E6!Ĥ Vw79TUSXji1h.u.ϊUЏg1V1'N-#ɴX2eΛ|̴_r`hJǪE6!Ĥ`J\jisA|ܼ6s}7*uǬ2<:V A t{*mM1)7y/.2T/Z:cYi2<:V?w;ƒ:c}nj2s&Vnb C`_M./_ j?nQ?V.$I1Wƒ 2f0ΥO_|UXl˜XuδxI]Tz/m$X5{YKuU&ObKtmc|,S>וiyI|_~{5gGS'VX5d tL_*jo8nc ۋ>+]Y׬s87VmŸĸyr}I g||8`ib ۋUSCf]<…b1f-q܆QF=sЕ?'cųԼIyDV$Xӏ/XuɧX<>%߇uZ_>=ŪOo)];V 'ĤKKmlDeuXu 5\͝Lb۔ K6sXcraU<>Szv2*j*lyc憈Uz] V5#TUnB:|WխCLZ>V:.1`x(/kz)wNl  UɪbU0FGBU&\"V8Fc͛7'O<#VtBOCEO/ U^vO_?},sc_=t\8ejctC?qb Kƪ]4Vv_똫û/0V,d#UuŪ^m-D6aX U4?VP7X,ޗwy#!`AXbo z8oځ-sU 2<_Z@Xl*iXDw,u7M4߱u}gǪʨxֱgbUXb ƪRŪ:,/Ī *C0s8-TUĪ. )*`O1Pƪ޹pE:z5ͅ_'CQf'V njVPJ}wVf|sߗ>'O{SIߍ8}SU&ı*ħPұ vu!TԲi\Fc=AX>>&}Xt*6 6臧¼"Q8^3+VlXlB*VU.SN$Eu+Dh]Br]At!|aPmX]nG:;VwC&f sϔ)_)~-G߹]ϼF1ixy>n#9_hq7nM6!Ĥ0 )SN #C*0N0?V%z?s8ҴXӏlʎ}1cGsW>lc_H^ngyO ؄)j Om;X5|ƇbUnM`3{#;UsoL BM~v}686! G0t6ފX b !&unɡSN$ NzX'a;HbUXU}gRY7jLD}>yS3v`gz8C繻t>^ `*`BLJMq j ˥6'$k:bUyȍw);ﲱ(,P:d΃Xp_*`BLMsƪ>@bci\<(p,RU%߿o۫ylXMbb!!<}VZJѨ]>yW㯎ckޏ_%;xޓ/7o2>\X*`Cʱ㏻,O*?~xG~`8lk7Xq*8ݸrHiEr:F) XlH!.5< nLi~&.Z0LdbV2V%/~b&V1 ؐUĪ]X\p W DaiZ\+ĪJXo| *_|=gb  OŪU% ƪbU<7.Xz_ ?'Y򽮿uU@L6d(kF!jԏeޏ֕]_.puX3ް?뎥/eC4z0A}`qsޖw[g1UQ}GZ1 GA7 /oϯs/4 Sw?6I ?` ]b UsGKVCXU/QG؟hza_;6UE|±I{xߢʅE,XJnN1'f"N| Ak̝RWPJ/Vq%CjjU@L6 "XC1xgM^1#'7wu[Lkxqs5aqڊse qKԾ ,XBUi-bM%ACg( BXUi{_bW VsBUEbb!XU^/ʩQ a娉9qe#AlzisMrX*`CU !c0V DU3X5q6WEIƪQ@ /gĪ#u >^Q4' ͉Uaws Gbb!KŪz@\jG&95Ūu`r[.CIŪ_hS{sb:O=qahNWk<XlR 'q|t NQ鏿2Vcq\/[gzwsE;jL;JXȂǪ %:3VwSj]VS5w;Q&?kj/x@Ebb!KŪ?DNNfsCA*up[dc5nxW+0_/Vz0HscUvκ rU_J?.1$ U,*ݰr :;h:L /.H&& R:Sc֏H!4bAbe͝UpYXB#AϏU}TJS_?ψU@6*U@L`B*`+zwVsU@L`껠mcWb* &VQ#~(X_:1<` UX_GXWjiwfXQ*mXW|W\X*֭/ .V p bU*f* &Vpsb7 UܜXMbb7W]-Ob!Vb!Vb!Vb!Vb!Vb!Vb!Vb!Vb!Vb!Vb "mG6!.!mG6!ĤKMb:U&UA6Ab b>>|py-5xU&/V[j j-O?c9<&}-=hscUXǟR"VXuOeġ?xK&>}vNxD:wc XlzcU"Dw]%hcn,WW1a;wXL?0& .C6aS5 jwr͓OW ؄ŪQ :1%֊"cՄu-s:xMCx?b\XlbU6RGM=~8Vɠ3cmvzݍ i/uuRȟ߰@!VXN)]D]@X5gCU)YyQ(zaQMXo녞:N6swH%ԬusL)ͱbTKrb\Xl¦bU.BTߍ (\gqg^y*|]ݻFĪu^yij?~)>܎Xlbշϧ[XJPσXzU&?V4&rU͇JڈUXlcO?~<-=ߑX:?xW^`*`…ݷ=>)9oEZQ5X/ ؄UǪ:U5&U#VjU&9VGã#>º[8Ri{]g~_7JQ_d?0j~}HH/?9{9ܷ(8pZ|_`$ ؄ƪpS|9;D Q%hBtj"D;QQbX5)~~ەT*+1}WF6a*ӉBᮞtbͤSw!v︮6ΎUw]V5lX~cge\jMXc "#SS"`Q ˆ׎ԡێ4;fnA4w`u}xOJͳƴ?_NbZϚpkd}*`BHUGTǛz4{zq#Č%c^2dI7XQ8cA&i;}b cU&)Vp9b !&]Zj\XlB*,]Bj\XjUXjUXjUXjUXjUXjUXjUXjUXjUXjUXjUXjUXjUXlmp=b t mp=b !&]jA6Ab b}M؞/wovo<}IU&?V0uP{-` ؄ƪ\xx\HK=*C6a~͛K3|y.+ Vb kU/Oc#T^#VXsU&.V}y{8!b#Uk'Vb kU!MS*܉ՎKY׍fz ͺ :?cG0V?RRK_Lz$bc;}cA+U+b kU!L !Pz(-XJEa[XՋ@eҡN@*.wX!VX56Z&D~HV֛UuaTm+%QF(ql럧5Ǥ~w-s+v[z_uMx*7M:RLYRrޑN7t: >m%uИr}WF6ǪBTI.wnʌ} cXuZw)&:m#x:5o /,ڈU&+VM!3cBOzbUf{w{>ؓ\oސq ıvqryWx}*`G&<BO;.=y_: PvaryWx}*`;FC!g/hVbqqJw& o伽,K{ߗWx}*`VBt&DTXjŋ[UaCafΝj%F|ӘyS>1cىUK+6b kUqhꆌd iuJAYVTw2 >}}y54on>`e}E6a<Vk =Ց3)%'M0kێ/OUQ)h'?mNq}uv+Fv9#Dg'ˠqE|֩H$ERRW^ZÇg={%'̮}5'uٯyRȉ"/u⦛zvGf#<}nsf?g a]Q#~#'>9;Y m^A!ҭ1x1gSRQn^Sl˞)N<-c(ٴk0 d 9=" 5в5B))p^X_Hb|cotE)Kxѳ}PYxvR TpOgKzM2 Np*#{)"Pݝբ꽽rB`؜juQ9?C_*,fpM9DPisŎb\ TFP )O\y-e5?aHfeᜠ R7ouw͘+R2@PLB,̟PI 0t*9bUR >C%(X+=Tr# >QlA-}B%7R A%57Iv+Ū\Ȅ&DMڷo':\뺙bUJԧSb[W_R!c̶CTG:xy[|Օ֡ c\,b[_,N}u֕ukf)Bc4 [byC0^\۟5Z~ CGW֖NKRB&4 txtn<&w[dqXX|$aCVRH+EA7jsA oLs^ޓŴI.69űcRJpI{! loYfYHqi\kǞIK*!.)SF":6KM*!pfpR@)Fubcb}k;}Vׅ6Lpicϸ}V\J_*)VB?JΪH~65!I@,VVT!bTI;?uێ !T;~e'u[KߏƊ_Cw@όiBB;pY;޷kw%FX(dwӮWB9szF)_{"D 6X{A;H>k5f[IoN YiJ$wK}F\w/ $kƏX}R|ex5!CfqͱZn1N2)g=0=DЉjPӑA;Lt 3;qLρiקP48JM꿰y23 Ae)vsB{eS}H]$~ޗBJ:4{/l;*ڷkK!9U©pS<}N(QN;sUl 2t0zGUlH!(ÙuuPV)t!(`ժaSW7ܚLPNj uM*)~JCݚDB8ĨAŲgjx#.B#S/2{8pT7.r:9mcz\w*6ܜ|-W1d M!lUgk{OxmCrםKKRHy/=ͅJ/;R\l*"`*6l+zvv@pWUZQUBB)Zlk @K{oSzD!\//ZCkcR^_>ȨbS؆}6gtUHߋNdvBXP_@MaVA'Ұ*61DBJUB (=yƃUl bkJ28+8AVUŦQ"E*4,pM!<"%@Ul "W:σ*[nn0WA6NL^}MNV)vBl|&F;rvҰpUͥ+<"}m.SgD'Q-R+L*ި# [ZZ.mwLzn%_UzOjU& Hz)Dϐ_iIH]#б?R(Y y<^@OU/ɀرzBx ѱ FSƞe "+[0¤)q0ldn]0hBXk$H",IZ,o4~$,K/Ug%"Qˠ9GFxD  ABbݛxUR薁/(eX8/{q=D 2L!(NCw[ȅ3ݖ,vYqʠs! l$]e< a صF=dpgABDl-p>mhpۧwL8C vx4dpcl B>h2Jי20drdݠ[S_(,/^y3&P,̟],z>5G4!iK_C17 a+YCz1-oPpߘ  pC4ehhY aL g9Bdv ϝq J}GP/҄B䌻#N(!BDmimB!Lp 0%K(D‘&d-iB!qG(r 0IQ&$o/2&\? wB!\ԑ#L(I aB!&"r 0D7="_Gp BB!PB(! A&I CCj A9jkvUJ8!L9e0cF<+kF_iU%GhTc<ǎxe༆&:9= R8ǐ!ohRm<8DwGFs 0Sdq[a7ɟb<^Mj<*'EY#Q,4¢y!a AWoB(! A'w#IENDB`Light.GuardClauses-12.0.0/Images/light_logo.png000066400000000000000000001753151470750352700213120ustar00rootroot00000000000000PNG  IHDR{C pHYsod IDATxidu&vN-o`k4@ck\\HJChfMVX#'!#?1<[x43-4X҈Z(R)H@b߷Fw~[-U<'̼{Uݛ̼w2[[ BW'A_ ?`bt!W6%myL2`㪘 8)řkp/X+N,-%.A8eˢ3$nlg>gιty)45 dqu@khSOrHUߒlPR%B>fjy JSԺH=I&!W!) #Fq_>'bA²i-rґ /]90ŏ.j^K'^PYpV)Bz`U5Aob#Q z W Dk|8C5t⥏6$g™zIo  n {f@t+ߔݺ0bZTTW = GdџY蟇](p_\ }dCV@׻Si)i>KxdWku;̐!+@Gg&і -[0n!c:e~K@|vYaDm[\E[ԻpDG,I)i4`{ 'lv8cюH/b 6tS(CޱchE]HՋYT64`KR Qޠ5,?sf2ERџJ sѵF#E؍om|;L~.6\,v%H\4;Oie)ȯ@*ZX-0,v hbave5ٱٯj?[5UEIz3ep7%#Xń<@IޯaC~% )ESCeogi=$=CrJ,h^-*@4SYѦቮ/pHC:RP]01N̘udK%,YHjA>9]#̂pu7fcPK`cEi+: ;Ȩ 6Xfs$TtdY@|qK#[[@1ׇtך񳐂I7tfI_Tj$a}5wl }lu3kfd`"{Ay1*(lFzi >"Z])]b{:hj\"X?wN.LB:pc7NCR/ D&d;%X&H".<y̦ (}@fkLqK_#p®[w@(zIykymc@˔="_ty7dP$;߭j;BN " h+m/VUsXr!#h&^8 tr1E.v-f:7r@pABǥ B9(/%$m>UL֚"[.id>I79p"M4cЩK-JY:{T[T69`1e;i<(8,wຳ]gRAџX)΃-Ylr/>?CnG2љi@-+n.o^2p*X(#f@\UW[@LxM -@-2B>󉶳(8%C&LE "YCk!::;Jh*wPx ,^e@.D <:<\c$M 2a;4Ga5E1rmtc}/5h5c-hͱhh \ȇ@%4ِdX/>ļcg ӕB (`nŠL^~ -!$_tBꑤ;{w維A##J.[gn<1tt^G/%du e{4@{)#Nuˌ7fI¢^0%Z6+L_-mف^AaD> 5 QU}ZjnppaA]BH S`)^\ypܺ.DIe4WTI| @3݄ᒃ,IA琜8||ˠ+ K.(DyʠTؖEV҃[l Vdk H (@@QB- 2/9L cC:׃ǭThWNk!5Ț 5Ip8@X N1Y\Y}/"d;0<|$e* Hk9Di3&MHBŞ̌Mp@G6(ۀ*HQAw&'hO%8ے&pa',Þd)C--o, mE8Dd:e;ЮX n5,x"-֭`IVVY @A,G1nl@:=Jt) 9:UD?Jr*$G\ cU T8Ba msݮe;8D qg͊.V)$7FA+ɰ2ͻؤQ5CdA0OhE؂3uC;0,ܹ;?sD('0oI_ H#AE_plK`|zg9^4_F;}c7ww]E) &|Wg-dP}r` YPȩD3v(p#RO"^)_)rsW{ -hM&@S:ԙ@:SXS:$f[LkHI^5PBEټ̲*r݇Np0bi{ '2/* #}}t} i͡KC Wȁ=r;lX h a:EbBl]MF\'I %H"kaLQV:LFPHr_<0(82ŅTq*ODWr 0ЄtzټKr) C uQ`x:"`b,M/ಏk!bb-/X`y':R2P%/P#x-q߃lUďDǯ69e.q &C֯4)hP0 e`y0I0‚vP. >tt\EeHh!pE2?αb3eq-tAH1܇W H4㍇E.8 AFBP_1JDHC=Y6hG961ӌ0/0ţ 3X`S,?Я'ňS[DVI\ȺU$c57x"C1q@#!v$, Evl&S0} ]Gx1~y6mTm8 S8[C2"Rp?|ս2&4$io)_1d:? ; 8@ \32׮G6뻀Rt,XM_VD\γНN,-kot$$]esI| P]pX."~8^XF.FiWZ$3"f'_6 1fph=MF*6/*L'˙):5q +4Gm< IoKH0fE&@uAP4ǨwyR8 xƲ(E{#,,Cⷔ"lJ[@l@;\pģ'!nҝXEC?_2˸/ Iʓ:^EZE8@@g*@Q3zMzˣH@S Sczds .m]qH؁Χ]dSfةŭ!UEH???C4O}1ԕj%Y !2{S.w9[t6_  ,Nbch3EI!:d&ALau-[IPh}r\Olnq9OAZ_ A*A2P*֙ӎ-b^q=b)cFj]0X8%:tx7ڋT!93)ҙce"6%Aѭ9~7fD7 zџN?bK}/G0 +K]m*:q7"!)DX%ʙ\ل/p63 63 H2tiCM1]'E_B"K_}`Xx&jI^`jE.+ճrS -(Z^B4qA 7L=ze% ^$PlHHmd\ U?:B" RHګ&.jc= h{ >oEa:rBIm"@Sw1݁k-bf9X)M#㬘$)#TݐAl\ cȩ37XfO^:s' \(8HR50AAJbttr|9WĘ24g٦rӋT$]_pb[vU\k)v|d/  H>fiR8 õ|D ´H-&I.#рLxcmz6տ:mA׈[" - *, Bn(2i%=cSU#ɮq>U(z4CR EX~{17)#FG HWW%@;]S`lmQƁd:9hGWF(:[:F@Xfl |[@,:K֊ lhT_P6ܖʛb?Saۇzj߃` &}X%#2 rZ~S$sS*v`Q4{@TFcbPOVYz8-fp#˄1 _ E@OWC!,'0-?Q o4G'C켼};k_~CYXqƩW^mx >2v6=EJ~P,̩]YQ2j9l%FIas;# d]F-S/ fzYQ-yE*-j%$zG5-iZ]Ll`8A($Ho|p(\S `֟GqT 15W:p}g3QW{4xgǟn{58$f¹YN |#$B&G1@>n?p Hoٕ GI"|w,Cj> ׂ!xR W!5M8鴚ǞoT3_@4 P^ ,@e^[t+ "@"ۺ-TkO+9= EWa=;eПVXgJ@74Fʨ v)L%u`D"5zxzC?(?mlOa֜[Kw|d.]pv*v܏4W_FZ< CRx\LTXeXE.ЪL=% -4^dza7b؂C`T|]?у~hX۩_8kjkKpbmB8C1ꗇwes;]Wvv]ٹ(V]%n3i E'[0yî mb`}dIeT9[[eѿ}-Z7ѿxW8Vtiw>캢ξk.V;CsO~/T\4s78 odtG@_H`*9#|-(Iȵ`4?kp:1MEXց5|Ʃ4.Y̘6ڳ,@LCO[Fi#< q9`;9 #8̫ߟyc1j2}&Ph`޾zoU!y۾O1""H0E@P(w|{-" HtO,` т~d uvhfo/T/̔E'" }Z:a0>Wu"AuX$.D(/Ne2bH)x=a}Uk$joө;p{‡ξE GFċ/`H%,0UJ!u-KG>[T~~mo< o楰yIFlPV0>* @0E]VT8`ؖ?\1@^xb۝۵/$S?W<-4l@~BUqYAf 8O|}Ley;۾jK="D$q=EXw(6mi"C&4 q(x/)I?>p_wBYɲ{3G!RtȬʁ֡._ !f3jߍiE@`.DL5\-XK@@/a=y'=Nk[,w_/nz?Nko?zZԯ0K ,d8o{ՋwmhŇ}kK'*-e֋ʦ2UcLv $PdgmtE%E~-\X\ E i0 yn`۝{~YBD Я6c>L @x)` `Jd.['oDN۾3/~$1w"(^(r>@mE6àSF7c :  /(WQ:⃿|'t}sڸxZƓ?S4=ܿx^#ei`G_`@XE@W$#^SƴJ= ")|@F#HRuJ#YOt.;p3cgRdG= r  Mc< g_bgʅBxyeq2qx|)PZ W3GAq6?oKQXreh )TQ r#^6~qu]׹ۚ|;+ 0jPw$,)O.7f {ל*UB82P E0o}3pTn,P 6 Nkj3(l6m9 Qa#c Zپwh͛Eg_nԫ_QnAtw_ٺ_}}%Yyͬ" U@]XWePe ECdqϢ>`P-$ yW0IaOdO*s l]?O{{ol9!q &ICC @pcp? Wf @X?{tvwM\ dV|~&Ĺ . A [UK2*JeQ7o19 C`G6S `:;?}'c?NLΡџRe>/-'!YTL"1$ $5kzu͝I1rG{ W5IHݐ֤i~*{#ԣP "Twt-'M(i!anW eX6 @!A{0ҽ{yΫLv2mHZ;`#wa'Li>J&ɓ*u[-t@{}ww_ QZ7ޏƱgx#T3-ylb@nEDŽpgŔ@7ÇPzg>~ KAARgwZ{ق]v 9%1b.Vac(%ek4Md= q\hm4Vf B ՚ob XE5J i_D]2a/iRR1m0 2e$h!b%E#mp-58;%5?,SIݽpvs HPc /'KA0_e?VXz#Ͷ\ӷj{u)H>xg63?e2u r[uwt A*nSM.cWy8<\́ BpSruwqMc'`!S\QBdGeUo *T@tsY;^vٺlX۠s+/Ǻa*ju);AUŊU5'Ao9T2%Xl@ |E5!#4qKaӿrS:zŇw忨 @E|IªJHNI 4LA$4tJCc۷Èn->ރݽ!&+gln;"R>g[>AZbTLIN!;,hWJ~\z3ЋAj\ 簫,>K+w}:'۾)*f&E{@PH{`>z L`"m) 85@j#/̼0[1\~7_{ F./q2iAYr&^P^k>D("?63n~Uu?O,(_'}moo?yu}UϐXE*ҍ!WVD;ļDũLBmT6Q cO΁#+b],"A1STK\j@VPEd4;0|Lg'H8)B2,w>n->ʣݔr\Uh h^B?.ڥ כ'_)zeywvGON9:\b[4OxW^b7ԏ7$QCr.4_}}d!|.bYI1$TK)% d \~1Q38q;|kAw^{Fµ v?m &ӞH +v-]^0$ .c5T9S< (Ҧ90ȃٙfA@[7}k*!2 V*}H$DHp|H *SCH&$ E|@^䀈 )D/C@m.̶̿]^ǿV?wb狣X?5(GRE‹bCObAbN~hlWZ@ 5>D⹙~r՛5:ୋ@jF;j#@.4͗\>bP* !2 02X;+o`il>?7.H.]ǿ^?{"q$v$?9LY:nCgFڞLkUIu,GtcG>Cy%ѾL'EC yG7ŦB&O038H{P bnbCK5;|HQџX_m~_G[K;7'_/u)dWD`vmQW'Zk!8!lR2sA(5Y-%rO8uEw3/>rvB}ROT7<\gYI &W鉑%B1ѝ Z܄)ڔbRFVWnx+un{oc&w28VLGf(.k }L w)R@ y_ 1kUzw_ޅDsEZ ^fnM/(e( SJ&L,a 'K1J83TS`1jC "Flyi[+]Z! %Զ+4Y PrmN 3M4`n| px`젂zcl_冠,|t] b m T5T5!]1[&&y`eL $$twfh5.};=f^o=zXmon)Ti1PX:C!t zpj̾GҘ_2G!G:4dW@\IY$^b"dr hV@pyD[l"ȵiTG[§sᮜy?xFi3<.r7iʞDh$b5%UܳckH_amS=;]]/|t@%eO~m I)|5t*=2+*4S%FM@,sۿ[l|-ޓ?J?OD-fa=oP,hQdKu:YWOGN_o֏?.<+=9* Fb4N|~2 boDEM.&ZL,-ptw^/3;a %g9X!uDw㝔C72cn-4Y%{;Weqw`TGe(!Up2D)ВYkLfv/[DM @ j }q?ŒxLRXՐ8x_9^\j3ErE@_df[G0\ؐXLl$uu1:I,o̹Tl> ZzSIU !-I]7$f|V֜ E(,2yE>Zw2.6LME 4I0MLIB3 @ ?$\f;CKj@"gFJ.4߭{;P7T] u!$M#LĄg0WAſa.SD`N+Vb :X Y;- *eRxha"$@S8˸ND*Prə @N^= q0M褄G" u5A0 pfTL UftH'݉|.JXc#C(DS`3fh;A:i"b PrqY^$.<ۢ˕i-4m8q q[LjezOPҢМ'R$H=&pƄɤ@J#/eLdF-`z.='y= "BOeb1>g=6?@IV p #xZ(A#!eSc7 i^&TxR87L$lptTa\+!$qњ;ѹVe?rۿaQTKR/ fҙFX~ZJd`Q[ӘD8kGy "(.tj wwi_sE[jx$|azBPbc>iy/X|bX!VBA!|O.pv(~8Ѷ|HUs+x_-! R9xMC)PW[Hhm7؟¹Cfyb·j2Q:% |.j~eƘm@ё)׶пx @PO{ڜUS$tdKAy0N\ UBfAWY^ $B.P.rsPE^A4%jDDgDj>4y0Gc/0@ %{?'J!^i4ImEs"#joCWZBXEUDj>ǁWIǬKAXR*~߆ń/SMRW+=S(PQ*,1k̮񉀙٧, #^:gu(DHa7(J4@4w+r@aJ%Zh:yn= ,Fm_57cNŨWQsqt02q0QAW1rɣWOPI [G>nw?_F6]pd_("w,;ف򰏭@" WIVF8cnb֭y$ ,)JDx9_ Ñ 2?P}0፾mVХvѧI1x?Wd?a1ckZ[c"'@L8t npE$r=ޠ90' K߸X%aFyW"aĘ. c |AZ|-ɰֺ_ _( ẍ-&? -sw=eh|UmAB=\g_ 1mT)]8Fd00@a^i:q2B⪠`q;{Ts_X74<+ T$E&HMQ2]RaH-@#GWq. ,fZoiv:n˜={c>A #@>L XN7#@U/50p*|,|o.Pх |ѝ//`[el/Э3=u9Xf`nAJ o5_nkȃq$OBxz" 1Aa<]sC@  4sxTlboݺà_bTYzgtH]zS= dGjuE揻@w0 -9是C)51٧pƦ_rUKdG&ubH`R ˃rrf$$5wV=-#,qW5t ?i>>R%{):A瀼|_g(| @[Yj #YlliI&Q׃@ TKN?_QTZ~4gG0k'Y3~8 >A-H]ȴDh}(K; tnM@(RZyO=jU"\n7[>I0i8t((!?e?)(Le#L5NgdYz:U*°(Xϋ eP֮0#(c"Yâ" N&u̳A!J]n&ԭ,ESedb `ٸC樻eB}HN !>s-4<1C# ] j HJzaCx*#3O hwܚ`+ʳ,L6UA& L`%^HZ&s DyԲ0iB=Ka&&ƒd/7)|coaݍQ BώG`C I3A~(V"] iJ^voΠ}= ZPlLdI⃩|P2AX9C"xZ7?``G$%,3?H0'^ ,kEL ;j4@OTݱ)+Ħ{^ᑟ8~)psK 1 Xz4 Wq',)?zE\('YQ}h=!4/%N ;'E$ hSf$k W O}`%܃@ L.9)2!Po12e0rM[zxD&00XۿqTt% 9:i|R8VG C B([+jfw>A-]XA52z*ᤀ6sMWYQK]eY[e&._fcUxex 8#hP=mJpHemHX5\{sKYu-60"hx;(eajvf+J8.gapF J/uZ/ B R? .JWF9,z2hBk:0(Kh.w  Kεt(12b/XJd2v>tڍ/p m ^n LE 8dž)'1u!E@v)s@Q J E@@\fpJسu!R>pz.`UEZ0٦5Y_aсZ$)xDԫi3\ي F8(BWݦ#i!#~(%[2 ]] P`ސN}0\Oɐ+StF6L ՑEb\O;xVA|O R?/C<+(M6G^L =lM!@>PDnƛO.WC(^tpbd3"cކ\+ rW6 KOoNR@/֟Bї^.GVHі2v?Q\&Mhba$ҋce.Ѽ S#3oZ9 K:j$F|(:AOO;\qS@E`$kbܶaF=1N Q~D#WCD.@^ekQ3K U}H46L=7 `Rj{NU^:[2 . ==qJ@ODNR#pbA(.S8@hV\-:AKV"$~.E{ #)9%GiZF&0>B[9(@U'r^ 0ݑ IR?:W{UTOK-LXeE#?qk٠ѡApH&pRn7Al9.JrQ0Z?2i+rI* &&CHTb+H!R2֝5ChCK('`"d t%G?% y:rSBV)F\3Vllv *]*LqQul/*=uP?񲤍 8-3C ӯ HwA_xb eW?nR.LKޣ,6ݽת1&*&G+Aw\@cFJ<tep[P ?EwŝTxyfv}(NFr@VZ{>(GG>Kytq.LhAj(t/ >JAi8krE{QOpMA#c 'r`K8OЦUVTJ? ڡ فHsYFV)F %?꫅xpg.S--_-M|_JF"~@?ȀbC 30B`мrP% Xq`%ZA ^A"K. B4 I&p] 19Z ϿxJS&%Ie$hP ) ^&5~ CXT9cP>Y[r 9ecw))P-?dAIɌSdWidmWZ\g+j I[ >pnY"q%a5q K2ŸRWjpI-7tZvIsrFˡjn֘{#Ӳ P _9v h.%D )hd zqAQ}p( G @ BCx}"@p]< d;gN=XynO4p LJ)祯'iwgsoWy$,# o,n#bi[@amJꨚ JpI.ņUd`z熐M:Zz;=%.=_³3Ȗt3U !uNj0z:C rXgS5Bnlm|Ч KɃ#QB5U_ڥwTC3 iP#*T@$Ҋ, .r/(sэ?e.>p~\[8<`HIF&j0qn`d6-niAyBl(p h܇(?*t-oxY 8p+.rnK2)J}dN h-JJsGj &668KRd#2+4b8)f-dJpa)H*VNbB@^"@,W~btO뒪\1kא*DU$ 6Lа4WmpC[H7]f?p\tVoX&kq(F*7*~ ` RE){|9_Eꡗ=3 &tC :oްqMD'tɬka8 5):TAÿC"|@0IPx@?y*guo,'K) \Wbp++3OA/e04C0Eay RBm\C8I bR)i(CREF}GC \<GVKƌ ECEEjf8ipPEwCo$V(geX,Mk2)+FiuxmR_eW f4[Fbz O Ss`]zR}FOS̪Zɀ/s Pv:oҎ'5/%z=]:P?' ih `c؊.+¢(ɝz$L!@;PEain2MݔcW'ٶݕ=> 4g cbL`Q0Qd!WӋHQ4\0;-Ap{vKH,Q4g{0(#J>@%5 _+\极t8gE$>.:FHTdOsPfa|HWđ^zn-0qtr ErK0 LY% 7„˳ZǸb *Agm+xA&-$lAW 1(i_oj pJxd@Nّqq=ݭNJ 0ن nVd|qH].[y;t#Ii%LT {;^ʥbi|Ϧ^sf IDATL:R^ v^b*8=sJଳv#Tm%'دtOb1DrwUCc : ï~52J0%шgĦb7߃RJP`czlw4czjf TVIY6hh/jE[.^ueWvl۝iVO6=WqAn ұ^J7MgU{FL˚&_pzF xej@Z%Nhu_b Rd"&DJSwc?]9,"KyлZFy:z+op^{|KԖ/Hz[[#KI}:H&L=PYc2iC]RLu.8P "x]go`7BzLpG.ks%! Kŷ!6_ymx oV]FWݒ Gdm" ? ixNY}u~ޟZjDF9H3U}]pB&v0udkbh#U*ZFa3IP"@O7޹oF%_u`D2:WmHQ˸do6=QZ\%)A LRd <1c $-jo4ϟ{慓KYu_Ywnwq*>s,!Ȳa]&-N {7k*]wv_<="gpmaz&P>Q]X >;?'T~iߞ=w,7?՚u^b ޽G_/!eϱt | 7\cs#({#Fسa2mS,]*+?o-x,\y槾tGGdJ=OՕ_]}.k:xG w\u~ hn4^{<ۺ^zO0ViӢy}6.kp]ZUgyoy y~_|w{_\ nH6$0u`2;l=ꪭ{js9?ئE N1w(f]c2D\ꆿ7/;p4;^bS_ìҸtf߹pG܎Ok}o]Ztk\tJ6 LvL6ul @p<љ~{Cx|kWx,x]=^_Y=F*>޳G‹}Gm'ִ<ٯ|‘6W]' #7d F@=dkR{QՊB=i/SF^=PG3{\wwvb^PAo6xx^w}ן7 *m҅W:8D]FZ]oNf&hr09rڻ?tRGWȞxiĬ׽kI1/}krl5s`2ql͗)oo$zHǡv_ٹh'cYq r=p62{UASyk_w.+ 8 !ɰ=o=3wV(]:s;o-=ޏ=ouML5L-]#t秔K7V5eƤtQc᜘{W]f cd\ոp{|#Ž%4~b;0ڋ4^Ҷ`D}K uckA|Ýox?WkEzzp{zua`_Ŝ'[) g+wjz,5i&BJ7rw~ f%ؒI k|TjKHml¡ϰ7W+m.KB8w̼>sHE\-E@?5ހL}g,%}X&ufZ@ڈʤp5*wd>W3Kto{~QNyfF|h|/}k̞N~gF"r,5:t#k0d֖t@mٯc76, 2QX~!Th΃w\^Z]u>¢{Ň;/8"*!uƬ+xڮ3ؒ8>fvάX]pX“| GQO)GP(DTPHƣ .YuX3;\\̪̪>ޙsM\윮ʪ6nyZ2ha)_} r'ܦ>Bcw~QX{B5#ĘZUGwx re\K*>H&oVsrW{JLO)D`l֎T=8!,\XUx΁Zb 7)q:X)h^<𾇽})EhIl"M ^4m^W[En  0+ҷk+fS?P=3:htG]{[)x ǡ$Ԓ4֮)ZW_ ,>>rbl) VNkp?CƼ=KerVȏϪwl_ȴ]`)n.3w@~7|*=}xn&?\zYH9R1` 9~'#T3ph fⱗV H/01CZ$rpM8:DH;qOv]Q wqT|L2@8zoQ%sEv?YSF{NٲlN9+E샍s- AǾ'oouݟR^^c'6Jsϡ+~>慩.z}>CI=(ߝW 㴊]ør&]9ܜ(cyLe+9}?gO&vs -FϪ\|U@s1/0uQۊrͼ᜙4;kşXe/sǸD]dzC@~,ἐ864'>zuGwuM7R.B\xO~^ 4@h;fϾ[wTEiܪtOyeEljkWzO=̝{/} xԤ;g``ϙbh͹Fշ/gm^b#p*|g^RkzcmGcq)W Q(c4fƷ..Q_x~'۞ݣE+]A9m E ^n=&f{p|vx6{mɵTo[(i7`i?~NN7uBaKk ƲiK n3a`gmµ4ꅌBu[݂3K+gM#ђz}}nc/Vr \R2 +TI 7G -]Z `}6RtVqM^>Ҥ^_Ȫա8%~j[A@<_T{nw@"6[q .vÀL?[_s_z^?d u!zbZedW x%]8@agiw\ڽ?ÿ-WկO<;p^u4,Ë0{-1wmϡ>t}WyLEń_ߑ9ٷA8ygQ=[ xHa^J$'6QFHI I&XY-_@C3^^<1|Ie壿DEezN+ dХEPj+uԵ703j}-ߙ 2h+Ғ?.qd sP$C|s_.u{qF=CwhNV ggoZϕi$lWܓ_,(kMb ۇMՍzJ[֮[zZÔ4 o\V(-}GУ^x{VɂWПmڸy*g^Zø5J2"&L6L5F8-Cj7X/?pL)ο[iv_/Y>pgvX̔b`Ecݜ;v;B?a>"\׍UL}X5f?[qB;]q,!GN#z%FR535r-zcu%C.]/J61Bȱx5xIxOuvw45'=ܵm"7a6_x2nđN-i w}J|w+?']/\+BW)ڱ}_e+AxF.L"lV5a8N͋   R*w_tmjk{캬ہjMu~>c7r:A/l뤯`N qQ1=|/Kz6ub`cpD2p=R,TLqc/d";>߂G#.\LFh"O]ZyHZZ枹 <{V q$iEd UVj9d'jgQ"~{?z;qu9e`dUp"X&J\]&-7 4n` ?h{e[7nhf41A̜yS|*@8΅.ct Phg簞DwSp#텽nz\7qYX)Qfi>:$Ivq/K(8rȶUrZ.\Q+% Q*΋LZ y/MǭH)s%_X~H9yQЧ5+7A4!ocaw__$x`$_JsMZz9|ɔ9?1H>(ZOqk MEh] qQ~ >$ud¹w~$.s/(wm /?IFFV^PmCZQQ2E Vj?{zeȓj|SSW>8 t$Gϐ$IEEqMB߄w6x[WLyqDN `׏Qt3 - *N}YxbCd.{Υ^䇤v*Y;?ο+v>2 KQw|<,j{c"RE.s :c2U5ǟ" 'kH,=h7$f'!497g: ھk叱_n U})޼t@]~>x:KBLA`'Fr}o珑qؗ#~22={%%^/Oӝ{*1t^v'}`#S⩯KW?[j@A6̜7Y|+( IDAT m@X< okgv mdA\T?%ՄbN㗹[2bZY/L`a>VJmKyx Jөn 7E?˝="D4=Y[>z+׿"guJ0$| *Fvd[T x4'=hFPlOojwv?^Y$0P O,3AFJ!NJ״&|0+2@?T wD/,bf~v#F&y]/Ȟeo L J y ԗωmyUݙ97wď'Kmڰw})>a׿s@A1#>e볠KͧgzF֖1 p1"Vb`2 .}6{1@y l^sj_@BvLy b *Lϫfn*RHmB&+xo;E^tAjorGPwfG33O#fZf5νkl*ȃj? $}O|1q<\=,U[oWr~Fx`.)ʉ.+PKF_!#b꼇'8*=+Kg{~ک@:t wgoZv]{@˦4@iDkq_ВSC?kC Y>Я_WGėj+gQ@< X糝+P=ܾC fx4ݒn܋Z|eI~Xj"D U`w[G3864UNw}/o}: ea!n/ О۽zSoeVɚ?_E{LeOG:pYسry+oA^Z̟/^ 肣OظvL.-L˧UֿwH'0Ġ!'~?)K_ U+io^6瀟6J"Mb?u H յ3%~",Y%ft.#W'^ⷆ9#GTF?K<(6قg(qH ,j:DQR CgF D-CϬ#~ƊGy1mR(scyCpowc29"/2Й̝z;~$fǠ N7%韬 Հ1d jzM ?3XQ=)Lʍ˅^K.5|;L.o=ã{.eGDԨVY_Z^;צa&yRݙSk {eeOп+':gibT%VkgT."n❠t3(F?[ N|w4Oڭ?S5y v{1\;utbh`p-%c28Gkg8]pUqx(Iݖn|< ;-=y8 0QY8Ndo #6^sc{IM]g]PU~fXj|`,Jz4KM[D00M2)P/З%V;쫣6/ +C  _h=iħ TA̅S1 ? `;N>}c_=1 ,?x[SG-vR^MiT{haebV%.b=:Z)VE!m?xc|Eߜ3lzS`{CGHɏ|%HSj BfOi@?iCAT3UEO<:+V"u+h!dk~X/c EN3\!?~<9X†W<'-*}YXqHPIOc`/e)Jsu/Gdÿ8*"oS~rʛ?^cks] V/뭴2C-gw|KƩ7fμqXdvgw^{K[IdE/Ke=P.cg>9T.$_&'_@YO?̢kNA@!=$ r8bFH`@"̛񠁃T (R'R>Gj 3)][9M05P5gZ;ݟV76_{Imbu_vwt\@kׁ\Zޗ5[?|_/G|ɣOW?1UÀ̅O?tZ*f]dĨOAZbAF|<o[|겔 !bHXː8[pmf1(*8D ;S0E@"Kr5\:TkCwPppi ^E) <t掽Xxoj)w\ͽ΢GwN6w7ʋ=|?qF ®WUoiʺV?+k{G̚!ٔ@ړ" $B*b8@ &F@G^9{P蹃(h g2߬ BoOͿ5 jP]?T{m*=qݟb% ܶ{յc/yqpMkh94?ٓG0ޯmO?tvY_S{鯐6ǨlTxݩ%ctNqT12AVg] sx5ڼU)!AO1hO# XKZ q5hR-sg"ђRa5ҵK{}ϳ7vv-P/i7UHvm][l-dݗ<檌OGF}>e/%Η"7bS\g9eQ;0+e@&(&(4th!a;RֶAZ؉;qvH|Q#c5 1.@֒KwKx :.!WxpP;-]Zg_7=1 wPi > `uceggξ}7IvkJk}m2﩯~;N 33g{;k*%Ln}sZ '(#K ϣUCcagqg+حPXOѧK'{͓ngt!EY6~E>+m#3ڢDj^ ͥ|zKiNr`h q'L-r1pgBP,E]u N9_[' lr}U5ʵ ']ToiｦS[nƸ ƃţOT7V{{# [x ^J-r"?`L7@vYokȥvj9Y"v r8T~Dz)02)=0Y&`@nplB-@2duqh V$T$+Ő\$"xv-j珯]1S^0K Μw'+X͑ӞO<ֳ٭>~ otR tϵ\e7}|c (8‚ Ѳ xt3sXզd+U_+uLLXW!'ʡN|) @nTrl`MGz_xK·Q wr[R. '#Gn~}?m5GRlXNݏr?,J=?S>{ܠ/*ͺQE yG6miIuּd_=.z 7JGhѹ!DuDIq~ˇ"U@>ٹۀ(흺 C7΃eҭgު/R?+ا*Ӕ|k D#wn{أ03!#0iy N-40P>HY2I MB4o8ܺ QC t>X~{>k fpJP US9 Jzm\B:83(C-i?(_scJwW=ׯ6`diy)S y1-&)2 %P1~($j-ٷWKq̱xie}t=`rV;,l81k`4Pِ?xm,0g a(YٹXݟ(̼lK^jQ<jQQUJЛT՛l@0u -3KT U\sxv_]`tG RXG64DZhLe4H+to@6B /%?"n/nRB wE0?{@U,5!2Q+zgœ("1*M^qwzN@ 5%;sY3(F@PWa96pJU+DiژW@E'4:?;'$IzAډߖm0LGhq79zXt\^a,(#U41d0q!xu>","DfEl(;(>=j=7<@ 8߰ᴝBh gfA׏@jm? ֳ>PyKGO0:Չx \fĺ#7#- ^q0[2d[/^3")ڋa%mޥ8X@P}v#oa2uFՎp?ɭ}g'hA!!4JA/+QF"}|2Q?wCEEgDqk @k"ٿhS53QV#mT.L3Ɋ2(ϚDx!ɯ~su- bIYs:Z \U*e`I&˱ ({ ۙˆcؠ4[@0(Px6^ꝟPpNH h(NH*4σ]  LeV="CJPuJQ >SEE -4]oECD 5Ȫlڈ%PQ=_do~wg=7";9kppHR=32~4)$ !u| BqxxyBJReFYchlZB U1R +4 n]A'N\7~@'*).X"(.j^~2{EtQ AU>P8ǂ#硩,(?^GOí$ zA@l@r2B?H@\HJBN{^sCVZwcPq UU&3o8LL]@BC$0I J+;RcƄr1]9l ~&aHTwҍ)@fҒB@1#ezh,'֪NY.J7dd=1GDsa&_g`Ѯ sFw#\ 5&@PcT?' /}c`R%0F%(^W>=R 0TJn) =7CJ#W%b4vC\2'5WO$.8{a/G~q]3skkq8 C@[z5L y)"G Z 4߉ 6f5LXL6Pc B0xdY"-sPܤ<i#@?Td" !> U0p'v(rHIkk}$w7-qBu40I@&/bDv0'+WDԼYh 4>ُqԿy Ã,gf5E`_]._AA䵶_'0hU'Y76 F"W^'yd Irrd@, ܥ0v88y?rL @E@ayP)y6;.R|Pa0 8 L I@L51Tb"0E`4nJvQK8zuv2`RLɆ1:nzK#i}ʓۼ0&nCP,̓B%\ @Mh{L1vo2V;]ثJV`)2O0IH@^brb|"hHR&:<,3:@sVN;ӛ4 xht&]h %@>7˲ -z.$BOIjv{,}#4\eY7 3@EL&O:[a8},;pD) ( z7S ٽDp78"4W/HZX/~ @E{VG^L#QɠN4 zAH1c="GTJ1cQkD^4^ah65s7XX ͫp ;W +w*+~ >ǟ N鲫 -@0Y}P'VU(yn |yt1"[Ÿw(("FR#O֡;ς.N Ǔ^5-\7?M. w_JƺلG$s2L,eeR;B?SdwaG.;,U)%i-{ І:[Wlta/U=N0V@sacq)@ ;,=&3>B,ܻhK$+ճocxL- fC7}$iMQL85o$peW24{5E;7Xs-@ʰ#PII[?ZRmﻖ]Xjo)`''NV.@C<[o Wf AwF$=f\ehJ*Wٗ4Ki>FX u62/0\`qFiw5 [D(fOWޒ0 `]w)mQ6imY Y1GϯOAW!u.`EZSAeyf0b bNLՓCq`pV˵AɀrQ(S쬚F3{Frd8] K Xb}8;N*B{1[@\>}@]?%nU(Fd($8025P`D/ϹW]14.3:qZ@vMv5뭃78p(:9 D,_ ?\~XAG@/&oڟަ h:S8җOu1& .FtPu&SB162Ɓ*e+6G\EErY>o٨җsrp%F Nb#40HmOW:oE~!SL"ճsǬ"6# )#̃`!xʄ>V}s^,;m}N<@j?Ȝ9P%Q&NjT>*+"b,$ݜ@&* cUMSs =vmfϴ"Fј$o;x!Œ8R#/$ TS0! yAg:跓)jLL,~f q J *d^حfٯ%s(/ 63 Wy3A$C~ oo?1AQ]%T'yJK&Ӵ \ , ѦTTpa 6:!PpD,O2nT"_~ mK2t@\8AO1Uեz8iHte@Bx-J׾1i1JE1)&M,"8lc0C!sI2uM`Hg+ 8 >"ry8ГW"ARЀ8?6Pbi &uY';ONR=t"? cn4`QE~~@p.>@Ts-(Ds$cf|G:ž#2,& R*v?XSb /"~8g7DeH\]zwb`F2gXV}e}_]"S. gKnmW(Bf?JP# b2cLV;i]_osu,($m E h) R.КOvdeFw1{?ƪ+xɈ(W&[ge 32ޅ0ӁuՑ@O`9t?Q b@рMaBu1ȴmX^Q'}uT/wPDsŪEɴ)'x5 1a2e} F%3p/C`0+D킣,q }SՋ'=.Ld@(r} p윂T]+RҨp~`)a_B?Ž YfI޸0 I5x)1nvKuXR:rAiȮBe`)Z)q D}(T >rV:K$6-о\ϛ~1f.]*K meHlEr*q]{Y)[]q e^ᤠp{Q0=GK!1̧1҂0EP!/ng TY>9~c8  (kZdPi |R٩q#E?" posreO'SP ˞(5dAX7=%]m=}rd65FG "Բ S\6'#o/"%T7 II^OP3 Th-vn)&M@v.,ߴjn?J>RI{4<&!-8!87DQ [z6OiZL"{+:0cz?3{Ӥ^a^j*&VVXm8@ ADU!4zE oc^kh.`+ޯi4?F`l>B֢qcdZV>[3= wޓf:'EЂ _ .ςug`٤¬_(.V'aoODZEˋDB~&,&/f 0G2=s6#oikdB@8~Q310C?Jn{MPp,lbV65Ǯ`p4+KwAa%ᅘ1I̘ #ѿMgiv~mvf޳%(qC!-G蛤ŬH ΄T>˽ȡPgڳix.Up|nۡLZ=|-J d@"/FaMjID YLQSn6@csA+Km q {\ +i gƤ:ZvJDI+<W T\ d<UnkV22!/+{uVr4%q"@PYKU֖|_Ch4a˲# j샕K/Bjt_^$5j$wìo~Db j0*$˴* #{hɖO#:"ԖHy.Rc./UZKmA[`L~ۥQ8[HOge凗HRC\@-ߩ͝ 7dCrTdī2/DŽT;vc@lkͧp9u[Y<sSd0D^]`~$y{q *a`ØH)z@ VVҶ`nL:L>m79 /"5Nй+~w7GwЅKq) @nF@jTĂͥA?Kif3Wsh_{AMtz35̘ˡ@QL`d nq(P{u/p|K͒E== $6)ʸ ^2Ep]ķq?LvR@-z^ @W}:,U |U|!mKV@H层ACW|ǑjSRը4R]$rPkf޸2Sd)ڴ M03?pMZDwVпw=#yd0%MPǛ'(#?Y\ uqJd|QͲ҆R Nb%}E\Ey;E ȕR<"  @* V]vae.5ATRHkJA3-81u5 F::)Me>R'#sQ d1L)a?H4ff,>(~8"nB2rZz|^ؔඊ[Kyp,rϕ?9T%5'$,:|Wd%;fxՂ$@XOBe:Wm*h}(\tŸ; k( g oz[&ӸHd2 @F$MrU nܬVwN!Iks@z!:Ȱ2@cB B}e~.Ei6)~.ܰțlT0;i^Qʀ(릚5# P|F-4  f¨}Jo3ba>@a)@e}0o8OY<rF>p[y@A(0P]Y]G>CpyOx^R ߱MAZ",4pP $ō<$'u֦`a7chO]\~X:[!D jj m_9>Q2 ١s,TNA6I0*"d%ag Zc-0%G>&ț R o}QAG1Y *^ !/(o7a|XLL`r7 O7C? 2I(.m8eǾI@:ЀT!lH JVz.,2dҀ;?6_țM4?vJqП@ v."+XMyYd΂pKLL`[`/e k!Q3ׂ_c2ILb ?!Z6;Y˂4y`*IB+^HRSé$L$عIaZ? %^)((~+|$_a?ufRe;Z8xW0g_xqf"3I OT4R(VW`+Aۚ$aŀBK%t`5R:)an h+MvOT=51t4y>{<A ;lw:!ZĻ$Eϳ$cA]%$KJ8Z  .epq\e%nZm`rA{E9eh%"Iz֔qW}!΁Y0?~״mxD@ IDAT7fd@&P3|&".Lsf_8m`gMpy=Ri;j0CmRTHVAS'=<\07+luRd"*H-lOHLCD֞ݥ4CDltFL@L,Pdى`Cd3t+`..Gtg\s3ƅ5N菬;L*4 P~/O]@V"+аL a s3h Ixc %j'CVGRDlxegtHYbN2t6sw@Ӑ}onSD g?٨SDl ~,FB~! F5eXߊP z4y<<\ݎpfNi>&@| ?TK+tpϠAiKAny! \ayf!ΏA:tq.LK'uО.$ESHgX`cW؂iyI`) 6{.ALb^Ww K6yKm:=w;+2d ,$EYUr:qiQRE`:u4}@ .8dpݢMi C")R`aBǷ~DD 8,2sDv< D.~ϙ |,Ε2ł?ܠoBLq aA14`2Ct `@2oXtY;5"فpYOvC@kRѡbo<hC  u X#]c!#/mvdsdB5?,}"E;T\KKn J!4,z?7rqB㟥tg}]rOVnwKq2a$ |Glx4/ٽVţ@cCuӼ cRjaRr"rH~gS$%^X@!rshw\B=ppHaOzI6R|0ҞˣR)E)' @>!5(tL$* TObkڡ[kRڶgsAt"kR,Iry;0?4W\5waN+d!D+t୥?2?~R&ѝ[a}2iHe^H`'@`aj' x"GcDTpTL>uZBR ث:v!# q#'ר?:fFq ibAZ`qNuNo65VBpW#h("Z+ډ.=B!Ai):z S,`ՈXyG! :Va<[ KgJœ1T9,l VVo3e3 0XG6d5Rgg5Ad`IPQ93Kwp Pkfom)rG H[D6w}S}gU?†iwx{εi2Y\ AM0#@QE (91eQΈ$m+(P9Fz4m),B>%@y@>JHZRTC4|#=G~wqF]>G~#1@85Dr":!{Ogehbfl:oW!T R@"W!tBU bͻ?_T0 AiU(u"0@? l=]0!,Ldt+na7Ή*J BN?.iU#hNl+R"t88Oi,M2 L$fo1h<5O݅=6X1Aް^Dݮ q9t@wXX2A<}[ (h NrEeDt a lK&e0Do VfK W>9/҆Ë}/*G|Wy^"YԘ7$/iïOg+h;?\{J6{>tgި\xv>iodXpHy3 PJ-}svj8k݅bKV|eL\V+id}~.vLV&}}Rs%csEDž]W}}D~R=Rh)"gk*Ab; XaҴa". l7B_0$NcZ24`ʦ-)ȕJnvT- y,#H00g 삐wBX6{?Z7N0-B]Y\{bCO%JJ\bJ kSn#x_@`,KVpH$ӄ$D 9@V8">eHq6'VA6;28pu=ԅ%{פ>U ϸڑg'c@y@0? cvlE/1A&z6a4 ٱsCIiF?wHX6V?X$,Wg?Tp6$";/c-@-v/ox56E@9(Pe1RvA&dX ![+&)B@2Ao}OHR}c^?IB/?5B1d?`(zA<+%#ll;&ضCml $$xA b8Jqe :mHw}go'Փ׎Adq{VPL0h@ek cCn*A"dJX2"GXD}ås-؎xx(#nB`j4 bX`jH׉*6juQ4^&?@7)!\ C"V/m`m'RhEضCf>pko>; 6؎D@c,nv$T>~?RkSEN, > ~?$ۜ sh3hK !;EGp>'ҥ@p82@8N6jK0"y @w0%0Ct~ +oQюGq,X4=%#[s/=l{/R.kl\6@t cz D,`ec=1F0I=֢Bך?r~e#!C`TE+LbaJ[Hzf@ZtR!v)C`#`4SP <C3ە:Sb'~:! .) #6i8oqEs5DY c4`0 g<c[^ǟX~;gcFنhO?Wa> 7'm|C`^hQ n'gwޡ| Hl:2 /7/G;&D Fgq4臐Sݪ'm7HlX,봼Zv`(\,JƻIrJ/"Ċl@ϗ4`$4@x1+]`KFUG~va5v qJNb *(~8`Cv?_(eE :YD2'==qDLhCBbRNL- O)(; X(-$5bAћtvX=yQaGb_PX&8oԠ$sܲ5lٖ)"twg*#}ٹ TAޠ ΃1/H2g]ړ NV1+k/՗rʎN{+k$97>wo@PD`U?(qeN wqx$ @!, ~+%XiX["pUqR=} iW`+[;8D?GCg3RុvDEMX܄Y UG<0k p@e,]` /fIKsBG|kie_s&U*; Ҟ"6lƆ- b@!@QⳑD$s瞳Wx9Zkj>ƜkcY6 >9eL 9r@{܋|w^ @/@ @{n ?#TdRe44PE)6̇(%*KEu.$싙|,Cs7(o׉(C BQAk1WdAMl=.ti SՓ 5} -~ Kl2!aHD8.8IŃpXgp랆=m_չ'EvDgdTHt1泞Dc67 x xpq o,c2B9 4nWؤE`3?䏜 4t)%]pS\)[j$S^ŀm< #pX#ZS=@pR{_ ג@Q?_8{>=?'hd[)L c wh7!aVԄc2 ʲJ)M5YއO8@kz/RN P0-A @ RT8oxڧª.M;bU^',"ڳ?%,:)iLkl Ƃ'#fp?Ԑw?p/G @Q nzDAA%* `DxWFR< X[&e@NJP)D#-Hf+y>lG‹+?TK͜3FV[lt['{ oj̳/ֈH}/?Ͼpc=G?(H:)V'̕vչD'3]$›N8A*KFbxk?xy>>8Qvvb67ͤ{ vgӨGR@yF[B.a[[ X `N$ c#<ǓM z~gW92ch7mF?LEɒ< N"o_2ks*kڀc9)`N "?<_Rf¯ӵNul3L_q`L띠NEƾuUۨр;@BysH} {7> ~齯]dlO_SiϤoѹ#㩧R( &v;Ȱ<ؕ s`DAn\56nxxއ#>1D6sq}_X3?Y%svXtE N iB䞗~V~EK5]$+IDATnP-6-O`:oWI89y 1m0C rHD_ej|o@+1UĬ8_4JKzU96v}g&5Vxhм`wlS'?~_Jzuwoa1@tdL> K: ';qؘ?~Wgo?9 PpXb8:?{(Dq@63!~HB{*Qn U[.wj(KF*qO^{Տ–ג+,W">3kH%P̉(8%C [ð)\^ˀ22{xmzx5<~ _3铿~d[kGXOϧΙ R%9+kFCۃqlDj}?e0w! 1h̀@֊v^E^uG1H?'7X9}I?H I`TpV&nzϋl-Qqi ֚!@J Zq* } cڕZSUD] @G} =K-7E2ѳ3 r8:mi'~w9H44C_i5jO\(878Q3eik A8VP@v0O ~LbK ;ڦL΂ ~P(%8 njm!ih. ?B,اQ}qJ4&|cX{zmy{O۹wSF\ t4`Q0dB 9%,z@HG:ԏCk|qk 9Clb+s1\_E罧fh6 dBE5.`D cF:(r1E$ͪIW3k%.9D.!)xۈ4UDvJ;@(c؟ CR[QpIĉ DECRs_[L:Ze9%p/~Rh~ jC@fRuׅQpa,BoK 4B0d^(_tUj ti3B@g N׬vl_%1@&AVP2v"يAP,\0ԏoSF}` @ 8dԀ-s,>MVM2JW p+[FF)L$q?5ЦTbˢV0N뉛BkVZ 3Jmco"54xcԏy m?fTԾ[@ Skg WK; SM 7AAWmIG90o ?;t;[_ۅ] X,kB$9 U%OS?g!o% ϜyoIqr0X`5xC;[~?vJnv1`Z4oj˜`͗} q]iM=k #48iI8$֨Pp] pA'Ԣs>m4H=cԏ>H?"' 6~;[wB: ='pϪaHc$i~+wPpGqw |8)T(;d9%p%=Im萓GG; Q?]B a$C'i&C4>A@*#rJ엁i4h55 R?v;\8Bb;Ԃ0h N. gТ]Jв5/SqH`hO^@A ]ù5@ KP@N@3 ]e]BGsq/,U!EN.(>Xu`B[XT]^U;my9HZN[n'RYmn) X  KR`h xKȲ/0i)E}t7f5LqfBL)7UVp$}whN W箣^( X 4n?׀~(N)hH䈬"T}AP h#X@N ;ԃ5j.Xq?nfPppn R M$Ɣ.ԿS}<#GؑApyF €ljlB?@+#jwӥ+YPjǡL&QQpCX4 ! \A8#(Y>.?ƨ{ S^Qp_0B/@.# Qw苺s.?P?fؿP(HhoKP&d +6(_"}p9;((8TĒ 42BˀhQY{`2(NPqj3AؕyQT(8^A'}1[)N4vc1D#pǭet:ei%@D)wxNX~x9pp%WHdr&EpoC.QwDS4mO=$8!5Wʄ Ae:p:Hj0A/Y\gʀh4'gD^IG"|Q(&49MIV@{! f}R?`ג/ %WDsY & lZ` MK$hv/P|GD !q:C|X:;/ mJJ>E%W%2 z92]Jpj{P??>̫p(b,i4r`l@ܒ@ـc˶v}n^% @` d͌@4t g_Wy1?6*QpX Zi@ x.CmȺ>! !mёSN%!485tѡ~2^P(x bWY2V@-=^N&\^V>wۆGG.ԆI+H^)1pK;X/pr~̥} ׏hYxO#7 Ӿ7Z~8%%(PF0HAw2e~pQP0K*dF!pJ܏s#A G ;_g}cV0NpQ??*S(xh&~(Hoo&|&">&!'4Lr>(ǿB @2,cF0\Fz.?rԏZ[2Bxk)1Tuhy B%  qE%K5ˏ1AC @c<@0/ 5 偦k>G9(/l((X$B}7 .=1@4V97=8Qn([du0Her##~_B @!?Ǘ% 4Wm*z-+1cQ!B:@raݗ$gZQISv/G(/((dGtƿ#Nyfu MGR=T]v̦@ , _+ cv4Ĥ56p^TP I`H pܗ¯%5TΧ0!tN7$AG9A'o>IENDB`Light.GuardClauses-12.0.0/Images/version2-video-logo.png000066400000000000000000011771221470750352700227730ustar00rootroot00000000000000PNG  IHDR_,|sRGBgAMA a pHYse!tEXtCreation Time2017:06:03 10:24:30zxIDATx^읁bέji!#0`;M;UcNׯ_!B!B!B!>[9 !B!B!B(9%B!B!B! %B!B!B!ėB!B!B!2B!B!B!_SB!B!B!PrJ!B!B!B|JN !B!B!B/C)!B!B!Be(9%B!B!B! %B!B!B!ėB!B!B!2B!B!B!_SB!B!B!PrJ!B!B!B|JN !B!B!B/C)!B!B!Be(9%B!B!B! %B!B!B!ėB!B!B!2B!B!B!_SB!B!B!PrJ!B!B!B|JN !B!B!B/C)!B!B!Be(9%B!B!B! %B!B!B!ėB!B!B!2B!B!B!_SB!B!B!PrJ!B!B!B|JN !B!B!B/C)!B!B!Be(9%B!B!B! %B!B!B!ėB!B!B!2B!B!B!_SB!B!B!PrJ!B!B!B|JN !B!B!B/C)!B!B!Be(9%B!B!B! %B!B!B!ėB!B!B!2L, !B!<L!BSB!B!B!PrJ!B XυB!o#B!?3 #B!BB!BxM B!BB!BX"s ɫ>v\ !B!JN !B!)t;{ C?\zv JN !B!JN !B!^>O }0o8B!B|JN !B!^s)P!BqDe"B! }d\I%'>W'@?iyUR '%ϿSB!B"2B!BgS7ODHK=Mr " Gsub <&V(q%B!C!B\j{_גSȄ<ʧܬ0+LSHzxB!B| B!?GIRyJ@tB!SB!B{u|ؑ!B!zט>WA!Bg4~8)koWO}cdzwnXΧ} jtrG'B!{D!BJDL]ܞt 4#\'``3wdQ`q]UzQB!灿B!1%Y~nh&BYFl"iE<YF:4t0i?s9j{}rj;(B!1<B!߇'7c'R)qcOvm<I˟4!B!1x?3B!⻃}yY#=~=w~Q@xG˱Q_ ݎi8_y rOr=_g~>7*|KB!\H!BgGw$0JXc=y\%>ڷWh]'뎏*AuԖ&~ݑzk)9&l8uB!Noies wlP!BS<B!BaVHR|Ω/-7Gqhh~쀹 cE՟43c+jSg%Eax hwUvN= {w+=s w=!B!gOB!B?kSr;=*e'Smnjoy$Ɖ)ݹ8SrjtgidSq͛՗yw=!t&9Z2/]E!B/!B!\r.ͣ\6Ou]Eg֟Dr4& 0u>#9 *ČYԢ_lhu6D3<~8謄c;oXB!o!B!Jx!BZg?09O2|ެGv'&I&wO )fR#9~DgyyB$fq=[Şl A0+ 9 CzE"d}9%3kG\6kJ bǹO>M\"0jaB,t-N 8#y5ЭDŽS'QIƎ`jboOsKgodwlMzSA+|'_%B!ӽB!x!S dÄَ.YųkBd؜[(9RxR2ow2W$K$q#00lȡ>&PiƽZcn֑3a'{29 9 ;O%&{S!B<_B!B)dgF".q,cɩ mbpcl췇q)Ok 08OJNX'Cē<=:O 1N&aMh!coDMSS:B!?/J!B!? %wbM5e~+5s]G y*U{$_39&? |RN YU۫97?B!B~SB!/3vN}]S_(wG%6.lagh?vUƵ˜?~_9xymM^v?5(B!g B!/cuǞgS_udy+t2 Yqk3W5.n#qE[du 0:o6L% 聻)cd}'V(q%B! B!X%mw_ >X%@EԂXFĚ:N{*N֏`=ph"NHQKւYr095e'yG70wNJNA՝f!ҬS:%B!ģB!%-@s+~8.L1m y&w+f1Ae`#6{D{wq^N|Ar*# eRAw(һwa&~bg S*B!B!'X% m:>X<~S{`͓[AyNLƇbӄ*yƌg9Nތɩ;u~oؼ~d7yINY%0/;eCB!M B!8fHZ}؆?n6y69=:#9"2??od\<=ꂹ}5jRWlWZ<ځK~\連crt2pN] ǎQ}e4gA&}B!(B!B+,Po"8$$f9}2,@?MjzL.7ڠ QrOZeJ`JI5vy2?}Y`qMԭSSQ%@(?~3)|ظSB!B| B!Ǽ>9/6Qr C~HgXJr*y?_ G'ד78IY5>'9Ż?2$]m(H^wᥝS^7bB;kzsJN !B11B!'X%ƻ|9>8"37q>DJN漢 瓿ς' %ж:ԵG8NNEb'kE$u;n7];Tُm,40nB!@!BqE&ͣ1;?n|Kpr&7&fI?+9e#D@;jrZGP387]:Ü>1=[r*>EfB xge$f;ɟ]r |r FLrEod7Ѷ1B!#B!&_c'D-JbH2͘%fDbʏV S'MBF%WG9gswU+Ƶ3*B!B|B!⟃+6|nQc.Gk?nѩQ{h!~6F_7m} li9 cb fz 9LJֆ9_#5o$"%xm$2&lh.:wޱETIgc8WLcEbj96g1F׏!XD9z29EFvB'n*vfؾ|߬blAiɪ,)4 ~/hLPz<껳B!󳞌B!?0 gX/_Hl|ar>ɩ?&OG]!=%Z3Cfרos{VÄ"]Vc>d \c1V s~Y˃s>@VRrJ!BC'c!BGW&zY%EK՟߻ev6?}c⨑lpF;VRrJ!BC9E!B!%lrDSgGrIh]k }:<{KNu Dxx1&957$>Ox>Yau%fP6sQr!q|Frj<\)!B!>?dz(B!Ŀ$(95nwLS7_F•@?Ic`y:X}B?f|cRd_}s6oa?n,2hϯIN$sIע Qqpf'J !Bo, !B/E%=59(fX^.گVOuSvLoVR3K61Yjƥ'ۓSS)gܞ5혫 )3nskUة}%)W2S$0/r>9E^1JO!ޡ3!B!e𴌧d!B!ZI#ԍ)(gᒸIw"ٓwIUB&ʝ"x맬s:][#kNֵٰ>><9Iu1Ys뙀Hg1I Be⼆?b$ >K@B!r!B!~T ?]>]Αacdww\a vJ]o-B=]Wq;p?Z'* RyVIfعg=Lx69jj2i ]|'B>NN&u3sA{I{++UlrM [^'zVsjW)!B/q]!Bqs}Vf\9?SX:Yr_jx{AKiXFY$wz MP{oeqۻ _kk7b_ )}H((fMPyxie dJN !BqxB!e1e$*VV;}ڄG"vNEmYDgRǸܕr^{굏t4;sfnHq.y$ho)al[Y(9b3f ԣswGG/'+ OZ#qX&؂UB!ϢB!'m崘n\־5&<;xd^c^rA2eX wN%"u55c[q,8F̓SN< YJ<#G/#Z%[0(H<˫S29B-Ԫ z߸fwVխI-V8\#c$gt*н/B!!BSL]sN4ɡIxAqǬ8øb KNv0LjYr 7R9B2ACa,x"j ]LJNH015gU>{-9k1'+8Q=;4V #I+=o[!B`Q!Bid +$͞ H\>23~ag(3H=fwR'K.1&',l~h^hOIW#`4M"EvEr]q-Z]%Xo>)%~)YO;iqd>bDvN5;|NaB!B|7'U!B)gH.}q18|^(}sh(Ic` 4ÑYɑW'ɩ9NNE{@&.9h ʕ- :Wx>95#fǬ^3hԑTwg$sKq")qla.jV?259{MCSB!OB!BP{_$N%\OݢWFɔSkɩŊ\BOh4bDsHNasȅ[\{ ëwu' ڞ㣳l)C=oDKkǎQr|ٷGɺ/~G?O&"DFkӱ{t8>%B!E< !BC#mNN!A%^s$=fGjRr]\'Rzs>X6#|.bHN oBqū}bp)Sl3Iqen"1}1כ@<8,R^#$yp]G>~F1OEL. a',<8d̳B!QZ!Bi/Oi]Op]T>c8&oHL&F|mr*t}wO& 8u/p|+l7s$'Qĝq25]CЯ359i5w@=uqbu&05UԹ'SG;.&B! B!B$H[SXRFbb.ﮙ,~qr]boHژC\SGg{=9uSK71&Ix;`ϓ/쉱MX)Я3_8=rGNE&tgfBˮ͌?ɧ?JN !Bc!B!gHVESs{3/h#$>4%0x"NjsjpMp/?䑯JO$YaHuc^=1")>Is{!B!'xZy!BqqWvNw`a'棝S(7hw }(CHKBَ|6vg;`h@0vZ aWJwex<~7O.Nsf={g1"j~ߠ܍Ns]r]=VXvFT~p?cxy ʄ ,Ǖ{xU1c`B!VOB!G4L{,z$ c.PWx;299QCnժެٖᜢ#!>d}nܒȕx1'ofY^!B!,B!ķg@NLNֿWiG(Bۢ6~ wgArX%yXqIJ|,f?{FM$B095XI9\6 8LKDq]%Cfɰ#ܗ_ט쳿9>x0~dR<9uy{srM Yݜr縿SB!;r!B!uX`p ڗy!#̵_O-aڻ|Vy ٕ1 1 Bqb[,qn7Ɋh0NX{-LE@y%3aLŽY39`SqkV6Gُjy1W3R?}Fx]cV5FxOiu~lAy0lg=B!Us1B!BI 0J$3IN;v/hlTw)TYn% q6No~$,W߀Sm"nҏ+LDUjoŭ c]g~fDxy/e#GF9 Ix;X|&^Y4&u&J8J;H?sOɓuLIw%Wlc$#4|άAzLi[-8B!𜪧Q!B GgS]:iKUgӪSЮmAtJEyP *b7@Й6)2o~S<9vϖB:8rrr*HNIOrTv^kBw K-mqG[fna|Vr*<>(Ǚq Y u1ڧc6F!BğYB!ObO%>GIHNE%ڀvJs?t^/G>ҭ3bi-=B_.e^,xfA|Vn~Է'F`UPf$vՊfqH?BVY)kbü=Meh;Tqb̠vNSݦ6Yr c@닶`3̌ JN !B?S4*B!hɩ} Y*lxqb(\Ϗ3c|GQ.!;Vq#w>ުfjh\a-Yvrj+ll 4iJ|AMHim;]*qf1^䮥S#,b)~l3U|h(9%B!|B!c,p59c%d[[G#98 ī~59)3ubs)0>Xyzy›{ ;߬үi~uȊ'I$L#DCG,&ޏ7 bnFI-&=X8OKj;K kB!3)B!Bi4'O].5)B։,Sur*kj<]=Lbfeܞ^6640Ʋ8?PS=\s[J\!A1J1(mo;E{cb|&{y%9.5^9)>6 ITprxf<^oE/z/,#)e涏sZT_-B!W1{FB!S'~ɒHW/AšUm\B]&<۳%-HKN!C0wz}s6J΃E3b7o;|T2b1~AXãdјi{$gDgSF'Kgɹz<='Iov#d'.]`UۍZ +3p},ş13B!⣔Ga!B!᢮Wdu|bqOzTJڹ(lc53ϙfl|_/ OhG,0™AeBg&"Zu,E'Likn剎d@Xãeј'Z^GD:uVBNN=C qLMA[箿}\,:5ǯ$<:kA[5hMM2E_63yE!BGYB!%%˫u$i1K]vU jr5]Lt 㳂/[EYLrW|-/C9EGszFsókL桧.;1"QT>~_dY n~⻘œLGHbue^5){!ycMꌒS ^W%Qv?ʹ9m~bJN !BW!BOOfèWEre:L%K6sm#TкOzGʝN{"t"4*C+͈19e1X\Xam̱_8d]Ph;+ +a&-I%i&Zam4/\7Znjl8ǂ:,oGOެq FC)",joɩkGNMRT s"92ܲ(9wk ':*bT%vفeJ\"7N0)SZj9fcb蹖$B!B|)B!ċ#f,{sX;YZw?A8|Ev{m3CeɼFmq,2~?cRr+bB؏s9U~UHg|@3bCH@̽W>+Sb8fv] ,DjVq\b#4&vibU1+=_iRb s4w ){ft}rl',1'9aG'BCtX pxj8*3t:{>9F>VZ-}[ykTеSnKan SU8?eHN4Hdt9~Vn9jƟڶD&h4p6zU S֋S x̾B!0kS!B/`},s^^4q mӕ ϒKO<ා WS>Vx#cur3q <)I`,O209fUC<fD{ABs.qd5O)g~oW{B!<>B!"xl:WM۶H=&j/[;h/>'.Vy,Sh>(z=Io`y!b#nw{Yswm Y8ֱsBѻ?a {= ݢޮK+{Rl ۳;tBP';TZLSg(#VgqZ{o*a5[6y>+Q`C!B3B!B.ff mx(EBg[| =&y~(>JNy$/&G|5)%9er~"ZF:Y/~yf~ s~LI$/ybޮ1Mv+'"mC&@FzфN99Ǣw2ށ&+ɹd"l]oqr-} qRrlƸo~>B!F}B!%Ģiet`K8'@$W A|S$Yf+Ķ~ 9E=e{Em_Ǽ\I ,xci{뷍}L^ _)>,攋~}BEpKƓ|Q&XJ e&{M7$@x_Dh%G^Q'mDkUH,QW/꬜{G]§W"6Zgϳa\A6|_)m(5I(1F{3dB!B!/MZdF̉A\zHN/2Ks1c =9x壤Z1b*GWX7wH7*93oVuu&=b 5Za'*鉺q4!AߔD@G?o-Z[7O wӋ^9a/5"!Qe^>36f""B!n\O!B'X}oe)f!.-F,g>W`Fr6'm3kF\^h>F_Q"!HR5E*6p+C cw֐wXjGmmHL-8W>_;Pkű\cEuSxZܦ.c&-#qg6"{⻬"4`:4 ryYeҝwA4~~Pi}W^W8ŨSB!ϸ, !B 'r4v I͓;udo{Egs.r96Dk*ic!9ZvJ#\^T~s3 R>Olr =5qv<9DBslxn?>ASx)93w&A2Ա*ܽH&4ϱ{@:X|&JX(6kNx%cgSo̗B!5 !B`58+ljDb xAƏH1 ]Ep^$Vmx%2n czn.ׂxW`wxrQ:@߁|~轎i,|mSNcE蛄ώOXB([D,B!B)!B .ue^'amH(O)4 U(Ah6(yDG?ah~\e1}DŽA?F(zvb`6T<ǂ9?G߂8s9˄vf,("lܞΐ`o@P{p;A<"|h vEf;j}l[oq @Њ#~F"'&TcN>v(xw7wNǙS`739CgOޛ9B!,ˢB!'=<؋ڛ zC8g]^P;lĭ$T[s;+HAA$M]N(lIN[s89oQ>YP*?cq^R;GCɘf("4xI{T췜a?@۾äUsHPUtHJ9k q^_Yz꽫璜o'Kp&@NNy>t=w59@IN}_ЯM qO~<02ONY9B!,x:SB!Lb%a%?jz)n(e[,lᢷIϔ ݷLw)G 8 qY0?/.;[Ɏ[ F9zs1slA9\DnS6%s+غ'?ON&c<&BƬS ?~JޥNF3 O N,_Po)h2=R~{Aw@=a%mۄc*+LUHX B9i cFj{\q"%O\BxFI*،{FF)]lGE,~O7`jjE:<Y7o4N$c~C/&'ښhIy҃ 5r&|#dȾVܟ'YjU%KkP,5R[Nt>9&T>S1'/9FӸuB!b9)B!.JNatPKL,11w>9P%Z>g$HzDg69Nvm 1lgEd9#uF  Loɩqurj˓SSQ"srڏz98̒6}~n:M\_?k19iq>xվM n_!B뤿dB!;Kon_7HI2):W/F[~04-Pu 戭X5>µ%Y M}s$ Rkw)ZC̒ڎxg1y۷XjyFwJ0 UܟB!O\~ushUk T":VagjV]㥭1hCs> +lk™%=XvĿw0_6Ce,BBʯb+-z^c2|Omm;r4wD63 1ǟQr*Ⱦ8S9MNm*b~:>R?G)!BӧB!/#Q?,9~Cbe_T?h53a~$+.!U_v.Ͻ}/Z-^ǒ\x];msgJNؐ _&E[v[d$<&m$^ {X~̑zO^ $e` -}?3_C)^ocJ[?yZ)"Qr M*;ma}+l$Cg ԄS)!B"B! X|+ɜ1/Їv}FɏH3P0;> }{1^8}e"HhƳ]$FuO U$ÞY6?|&ti#|m$u%~OX O4nOoM@h 柉{m@Y`S xɛ~$sMUiz$a+cUPsT`_P- }*o7c<K蠼a}j zU7z=!BYR!B٢|:\ zOe~:gSDnUW4=_N~<9޻(9y^vsj\#vst8J,ɢ' ہX176ّsv-#۳? ,ͬbx3ywm2F71ʚv}F:3wWvqɩGU1[ ҏsZ@k_[,lwR9Vy(%kyh`6Z>vOm=B!$t,B!Ďq×Q4_o}=!̖T$9~`Q¯QS9XdR);1YC$~[}*97~a /6/Sqadq~YbO% ;Rw$3[f}@)F5]V^ql-ڽ/7*ɖB!y4!BK%F~{z+^3dڅt$bBz`}d 84&ߍD;BoG>v%grY8 !Bz-B! Bf,b_x`gelX. Ё k; If ^vMtޛ(;l S(9B:+u!srBO$U˂v;cfϦyzB!xB!E\YĢp^ $JRx%yn5~zEpݕM9.&w-6#e}ȭvPqS-8-U|f&n}oX'N~$ᾎsB!ׂʏm"B!b_"x:Q⪧ W ;+nZC+t!#-qJ\*8YgOMծfw5]k +c`>)~mL&V:jۅ>acdZqV/f! Y8$v%G8}[]F|eUμ e4gc6 ^kL$ >RW!G;baD\'5MYYr*5[>w>_IE5m}b{;cchı(F掠m^_s~XLs'{{ Ml}vѷB#ka33/qκ/:t69]pHu,Sh7GM"c˶GVa;։.9/B!.E!B!)\į^&&=Rm$&CɈya0yP6,V=g닅RCy|n+[~=/5clQ#Ə,}:}䕸N-8@l۲wj /JNowVnMNeFVUB`,@۪OLZNJ(/wM8j^c]MaoS^LaGuC(9Ο,ߞa{kX8/B!.YT!BdB}d?E~[;wL(W%)]1VW [˥ %9Yx̨ k1^^Ur]ߔ ̎-i~Siރ_v^\hЮ`mQĂϑ)T{=z>i=V wߐ.3ONu1կf,2;E}m]U߿lxځZø7J% gS3Gosx*AZ`lS34q[!B]L!BXB|1yUk >E&IRWALzfY}rHH̀. ,̈>EoCΑ}Y [4 G<8/z>]y ~?n}[) ["B{.>˱mkGO>J!#c,b쉺g2zɚ#Z] !A|a! zXE)<:eGQ9+Dߤ砾:ek,x/6xVyZQ$|> =aʹ2^eGf\<]]g?ˣ[1;!uP*ɎYkb{T-3{vnMxP#Gi?Н#jƱ' Paaw[ G`uMf c݃#h[짂&bvOM۬އeܟy6V~B!(B! idUAr+,Rr[t@#t;Z# m%u.{ Pq}܎}R<v)A~‚zk~>4zYbU`?nmkmݷY摏Lg EU|wi1^LGvu1r-לG8Vn1XQ Frtx$YcQOA6dz^6BBhɩ\#c+WE/u,xlZ1Lݐ'5h㱎_[ s˫SEgc+B!c(B!Ƌ\R L/ƣ,CP:/0!V[V[$5n:8b(͈b;JL9f8}RL Q+w96h0.6}Κ$mTXF}wXh穂7&kes;H~_ۛ}g@\m{tA0}܏'k@ۯqyG,FIסoɩH΀5\ۧ-l빔shu~S 1ǐ 3SOճ(LNi.B!aWB!Y/Xc%=+)c%b_Ų#L۽0Afs|;ȔvR x7Cs%+Δ`!-4Tn&w_ M BzrI}~^*qBz#_.*3ڱu?)yP)xk_yp󏙫KA :~oIiw+vط'A/l m(X]1TP,v _/=p8z(~cθQ7Q8c8Oh<~n3Ѷy%/̝"~%J Yjn[~]֌~1[Ӆ.q!] AށbW轗$z *tmumD?Rǟ}?z_OO?׮3C2aj9B8A9M{{*cm`cph=%B!9E!BkGTYF3p5l^2iDa~b'Rc `4k^'8JC.'h]r hvM%zt/XߣQϻ#̑wE=y=vL?%/ij!{J '0fگ&Oϴ߆Ź0VK~I91LvXF:ޓ^^x"=9%B1R!BsĢcg+XcYKR[eXVfdM$aG>ƂD>oez̋'To,\ZNHhI3y6_܁DKY0e3Qu/;q Xڽ&Gw ^i<Gy#~$yM(;r&q={\ _p"!B񯁧T!Bm>m{,0XlGꄞ#ãP"@f|U[ un= [vb5Ep^[>"DlE1ߥ~.lE;}`˶k A9Agwe4mK`+Z95^~ӵ?4ҎB;i MmwNѮ(w=ku89A{0V`ʠv-/G696OjU⷟X1J~h B!OB!I^\f%Gлk{bՏDX;Zx#V@I$È'P{]Poڄ*oqfqr$Q(c'ʌ%%vm Vʶ[yeynKMc%ę ~kSw !B_B!a2% 93[b-0yamp!dK!jCy3LD3)yCo,Sc+L81,Hd0w^_ ۯwyk,&߬{RG 9;xVq7b/pmb>6L|f|t=윚GOQv)QlS}'Ѥ&j[ǾCwj^?pC9oʶHzB?Gێlo|.Q2ә|Qfm۷x߸4W;Ekcq^!B !B?~7yI"XH*C|7 I^ Etc.xLm#8x;113!3`'_ =^掶\nwHcq0(7bj.E!B9xbijB!,\VzY+wcOs |'[2ʾm ͭ/P?/K>/ KOvOc\uoîύ ψGSƑ[FY,%)[K;FG>]d㰶}Ty"4 Wݷ{MzA^?v֍owak߹4 4pya7T1Cqڸ iۛrwAU=3:&-~ zӀO̗,9wl;ߏF?Qr*UzcPf2.J߷͢~z59 <ڞ]3yX4s<%ub^} I\RрJkuQ}(Є%k㋈W OŃx%5` pjBo@۲Q'WG򖁽k%MF{G ˱CO5&8/1z2ɪs qx[ڴKڄ7 b]Xz!Bׂ'D= !B`A}d`vB2N>tC9Q|GKw Z<r61USEb=mDuKb *ζRo'b ޫ\C>G\l7/oy-217+۳k3YFm^_GX㫙U։+~(3>+-GI!olϤGm#a#%ɑ>R c1Ḙ7y@nTۃNcǚ9g(Ǽ}ϓSM}[~ݎb'y)kqV!B]B!Xtp,bۃ Ct,1rVj s ˤLLX 2@WĹ?ڀ>&G,X:Gc⻓t;~Q/ߞc#Fq`NB+X_wSſa %>(( HXgAbw (ϝoS @e5GyT~B59Z6"PL?%B! $X!B!|AҤn4R$k^?-=yaGs1\޶Z@?X'dPW#>$Oxkv[KǎyPs|":&=͹;c3OȦ 90={E}Q-*1˥q|W|Ω#n gL),Eb*meJ}٣gɩh-#v}Ωy3;V6}Dzq n)/X3uzHTHxw v1S v u5UgsSB?/}VNN_5@ehUimjB!?GB!)X!BHF \xzk퐰~Qou= yN} Il=/?Ɛ~W$`}Ftv8/:(ߔqbq{9&[U6=gvjP;c둌vŁcURs)5m?=ޓ? ;3lވ#wmhsJo}y;j]Lc^{u( |W^VTvձmW;+vT[V}P^Kj9nϱ _kf9mhx GkBj[歃vmVCB!GϹ, !B~u~}-\%Z[5 CK5AO}bDϣ׷FqRC,F_Ɯ!F}+HN=6VE~=uV F?MNy@U9`ܜo~œSy'sיm"ɓ}< f>}%ί""ED|3f?dKN\!$SA#+"WOl~7SA@E=vㅽr9Vh>\v2=w$Dp#[ms#~K^?&1,A`7[)b7s؅B! ]!Bup ~g-!4[hZ- }g>?GR^ػܥŘgm1jgm~.v~ծh^GvU> Qȳckc}e$q:<0d.j $ޏ>_q"k_!B\)Bʫ`7;'v< W{;.fAt0LL9LRܔ0Ж5vN}B/lSN@.8=_A`֑FHp]*> |4c97cݍޥ*Hdo坐 ~~3,B!D瞤B!8I^EP_HezQuIH̜I&`1x_~5 HN޷F+m l sHuEJ10!BsSṧt!B.J"p >6 鋜7c<Ѓ),v,w( B^z#;p>Gf<*﮹`6s2xvu8׌{AEujڟ3dGwԾDq#'=ē'j?>Ƥ5p]ĸ 3s4A767P;~`,9&q5{VL1`~R?/1Ј;WDcf5~Wec55*\̯.vJ`G-i)ΎwwSx_-q (cf !B4'B0]m`!7j| 9$x-mr*HzO%h~akQ@7=f$|ͺ[-6,*Ϲj#1w8ń) . s!<,UiMѫka5#7;VͣǙZGBnz7<9׈'PkNO\U1^뿧3ñ$:q˰W*kI{Y$z/dS,0K47!IdRw%l,SV=nިIOx D|w$'dz՞ON f/?,D!@frޭ-:0Q~3>m$$2~$eF)2s>̟в,[z'$~<2C_ĞY|B!sB!<m䞾9`؏EXe.m A"۪嬑Lz/<}xR@gҴ[>+wS"|MX꽭Tuԏło욞H.l f@_L%߿WdFmGo? [dn5d_Tr(H"txl6{yz@!BI> !BIŝFӱs c""M K B$/' ~h;#=9U[]bV!YwB[LP:"E-._e4oۜ$j?ځO.ߕҙ܉KF4INbcp0Q(kyt/ߍ4eKYD-vΠ=vh3Й8>Z)~ѽ{dܾLς#c|8.lB?exm>-A)-/;Bo|}:R{a`/xPU+ms}B!_bB!r~w >$^`ǽXRFɚZe)6ǐwUjۻ)C˵]ؙ +>G| zcr߯M&V}Q.1)!9q[x++};HC^< @B=~(8GfG;oq{_O #ZWƅB!ĿSB!pQKMۖpع?Z5LX]42e`F ~fT9= XąV})cʩF8SH{#/^CX##1~3vN_q/X;뗙F=y}e ;``geB@&*w;=$uws`]˼&JDķ;ob9qZ?;<9S|v }kVN۷YoB`l:2.WO(Zwlc5+iB!_?!BHL]#˹0݇O ,a5b~kY|L#q3#桎ϻB!DOrWͅB!7H"E_bpq\ۚnx\̉Ec9Cf vxSb/ uW h.ڮLDXcsjP[@a39oX8^/*,lkvq l*y?pcT^ώHMA~OmXyɂ,g{8Fg=ʼY 1{M36]!A9k=]TtO,!bs}[%anpΩ>o7+>vN5=i|ZlabqZB!g1~B!ߓrԉ$E=͟ ,d؞.G/nώ􉺨/GOm9:o˞uݛl uĒiƸOpF;m|^/|{~m.QkSL4e>~ԁL-3zyVv|W fl3ްG\7Z}3XGbaq^ `Ɏ1U`KnD\S*_?ys]>֏}[=@xF~`V;GXrY* CZu2Թ+9qt"_ͮF>.&5TЏqs&dLB!a(B!1]B`xdE$nPnuڥ>`$ch"`PoVkrf1J wAYe]v2yzF)2%W9rJko'mH$m|^x|Vy1,Blz-]ݸ/'iѶlɩ2~wtC;ysاl1h:al XߙV$(= X"9FfۉcΕ~*9!;ͳt2ѳjN7'oiblit!aqs;gőf l= D$qmSJ섶|m3}&=B!O!B߿(#\ .8Z|$ % E3v[aq _53duŷǀ7~aHf7u@[NlyyNy<3g~2F9ro.q& >+T5 32H|=}qؒ3X]1d3d;!R;wtzk8L0.bWҏ7j5;M]T"u|qbsS ;|,AM$ %Α ynRiÙ'AM7j]hإ;_asp.(OO@fk ;Ď&sˎMc>ǯ @<7Sn qro| _oVc6sL/a}-_xmFrl7{4̉B! P!BÔb,LnX|[VU XK~"2cY`|\I ]$<28f&?Զ#N,r^ѻ~z7k>JP@HH22":qYZn$ݏ#g:LfH;?. ]{kyߔǑTg_B!y/!Bi Wn=X,sXp-:GwO}DBfER_F $ C>\> x0t.! j86I?'Bx=Wf *ץi :11fvҴ~#r,@0(yoK` OM~X __C5Kq q8֘HU,5Ơ}f QW#uNpDĔ /稍+Z{Ff@+^+B!;'OB!`nexx9]2dy"4>f6h3#j/ࡑ/wo~h@W*n~*Pf#w^d c%Ψ 8_?$\|rb^p(_$5-;";Qj_\2]`bʮYp}GcʺHX ';cZ .'nj7zu7׭ONAfM94 B!n/B!~b$Nq З4Q8u9uewI <-?όHg[>=%Bhzsh:ӿ ㆠn+ ǿUyGYdkH3.OX_ sDu hx|Z|vy?ۼ!!90Ar}r 9}2U96k\ MU'5t+G$Hp9GkR@ ;Y]sבqkw^3wM='&{L#bZ[E!B|WFOB!#2ゾc{ˣ8~ey8X/~1m>ɶq{!> #c?#]ighI>^~1/HL<9 &laN]]`_8 `t>IĸO2yy\96i\!xx6 hD΃8cNVk!BkrB!'cn}7J` |] @R;mmb9͘m_X-:ԭx~'QEiM|u9Ű+/b<@}0ѬA~^q:`?ofmIv[8l;|G|dP#_7$XHfP YhG8Zq`avD)vnE5ک3b_RFø6},[o<߼ =a l{?.2c5hqG$Hx:G?k! b#ż^c*y7>~~$ Ŧ76q-y9 PñpXưB!?7B!ķ f&LjוPNM@IsrLTAm9jSgGOٵ0G# fggsX˸fЏq Ftvf4Gc6m'PoɎ|e p+ljZ 7L[ ]\:A"׮X^8^efϚ;W޿;Ft̙zۻn@H蜋H!B} {# O9O}{/A[C։\wZv[\BoP!B< !B?  -K},N/yYtd[DZ$shwѩ6G~My[6\灠51ͧ2Nhn9.0w( ԙZa]Jٵs <Ð1z=CJ0?Cpom9GoE}r]~}eyMͮs|֏bN ޟڠg/WIόDg:d;>ΤO;وrC?w_ms~=8Gȯ3jCv C($':x&1-~p}ϕ9B!xB!߀X) oeeOqXe:_+G!mT{\ ea/ln4.mm6n#Ux?,8V.FC^Nn¾i7Yv1MzV-JPv0"?mt/A蹔j GևzMئ)S#.$I1}%9$cG1Z߻Um3sLF5`؎G0v|H^"A%nݎA0 ca@rm$a_Gf${x/XPS.f;E+}z}Î>.']GsJ)}j>z8LMW+z$cE<6Bo|hx)|A lA?|ղdwB!QB!g`oEI?zş,ƛXDl XHd_{X,e=hƑCLm .d 5&r{*#bv)_Fm3^-oH&Ҳa3~)e'b&qd׸jm%>Ői[Y8? B^3{gS#yBS</x15^v$,N6G r%clXɋhG})U浾i甈'`1y3^_&p|\rr1X#|-]|ԤRKN%"qռ$ Z{J -5&{Īk h"~}Ɛ^FFs&B!_B!;Ұ.mz>O$&fG6$^^`,E 5V3x.ᴉUoǐ.zwR+Oy.oKA{) Ǜy tk'4/`걓12 (كW7h'sw_C$} !Bc)N!B8ҿ2\,5"V3!-5ޯ,D> ye8JG>NO`~ng-1s䠌,z@gNdh(֎}6gŜ uTίa&q_ r3$%-.?7Dz%uctH7,SUp*b~cv2SVc u@n6qf^!B'D!Bu~8"Z?ȏ؏(נ>knȵΫ`auJ=yԣ.KO9 F,{O=+习7_w) l$rXF3k=ɒ{<1#O(Ƅ$ ~rBә%A?vu6\_#E$ߏ8F8ƉgјF.B!⻢B!F-"EmҤ_ȅl|lX"F_ߪ~fc\-`cEs+7Cl-`{vQj<-;<> XF, Q/_Ϧ>8b.?|h|ey>3): p6x=$o:O9ǁiMA&{K8hQ+kx$l@]6L_sGIR0|2thQw-lnrQU!B|?#B!Ģ~qW۬.r^xv;ŢlmI?˾d~a>:1;L'3b|gqL/[G\pZحlphZVĹw.ΛۢSۯEM+6btѓz{EOIDUQ~N5TAG]Zk9w@+/ SX̾p\H!tW49) z=Hv0ooǞxq_vZY@mv :͎xHoHno&b@]Y AS|\8h{l|38,Ύ~K1'fc#S1bCoB!3B!xI|$ٯDXCwYLXKc'Nml1z$ ̗O L0I3  h\Z(N y`פ3+Hxٚ+ꢞuQB`gVWuNJ#my1^hyO$;ĥUmCzk܂ǘqy>95Ur&6AnG9e;K_s==CNx]<9ePg?徺o{YϽ{ӉDFO݋H#8v]Aߎkw8-9E?N#L.B f[1k1y2d{D(bh'W=4q!ưK?A3NU^kvpOkmDZ _cuB!_?/(B!4<^HSL0)T/ސ=`1(9~= @ ٥Rc'9>SxhQ5n)Z9E_G@#cy4scI;=IQE(m`̤ONn8̓SaYwt^3OAd>9X= ~ntA]$_?zm!b |jQ9B45~|O~2`9A5s[6>سVWt`WIڰ!&U /[߽ Q'vYT/s.|8"QrcWNn6r9)Zo8mb\CI!B|-gB!!W(k|žXޯHfo :O w9~D?9A\v}!UHf|kT(1— lZc̍_}x~T6喝ku|kNJ>Vq$w+cjm[|R67P3V#q+h$hՉXNҏ_!B|? !B? 2_Mnf:jO-P:ЋG96Z?b#b1㑄}jm*G ~}]KĐc[{{grRkfxjË9W~kz 1tuPB^v^ \3\k?)x2k0꽍ro$?n뿄Q ،:S`~vLx,NפȠu73\B!<χB!nPo8G╪\p$+y.v^LkV{ĝFdoν^awnūr1u >rOĭ[ؠxv+l| +f)F)O':uqñFz&BI=SN{ ?YN&-0 ϧZ>B! NBJw!^Op-VPdQn -s󺒸w:x̬-гf[7M{1OhU"ю }<[ _i6' /s!BU!B.r"'֎@,?x sQ>u?_iE}$t$ plxqH$}%_ToX<DZ G9b x%co ]7a{OX"jֆ8-cln7OV VD}cf#~/[>c]^[o@b26& ݾY|,oYu_L=@ I?/k'c~fяgn;vC|7h{咩hᾈz'ʎCR%xn[ƕ/vU|ba mGd9Xb,sLK״%x<y>evΠ?vG'\)$vN礴ja824FtKQ`Q!B| D!Be@;͒Vt'm#"/w>]J24ɬ1TX]#/$hUy1@XvY49wDo}H(j4{/=bhژlgNu3H@ɣ#f9%َo+r{ Icǭtx cv?B'3mUauHVM1BWԓ >c]={M\V!1LTo3g@_(?6&&B!s) !B1 u/ؚl 弗XdlX1+h~+(G}=%FLSܭQ31foϰBhGNx4~jA_eOށ,9 p~y2`*f*T &#׎ {5mT/Ώ?)4coww~98>]c}1uxѷ?f|yoia?^]ݗ#̞B^Oo4 i6L8BysOB@)Aq mngap!oqZyq+֙sAW+ "|,<׌V!BR!BpuIXo"_Ch3P_.R>e7:,"G|"wn,""/wDU8*!a"OXM%tRU1,s1)%vXe_DHN1msݺn0~3ߛ(F1_m.B<m*(vP?4nlDE7_[\ ȯ0NKY!Blg2!B/ HG8b'; vt^Mg|^X䂭oKWx0FC'bj1bMXD~/cXyxQNUߧ'lέ >a76JGէ}A۩>XF #l }`05v_n8P:ɕ_A9Kqe!+xuԠKFlA:_Bz?:QFx|]YI#λXƀr{ξu^=&վSNM ܒ#[s}G{Q=~o3[6S泷 "91!z"^a)q3q`ba_#q"+ t#/hRԘЩ,lҧ]PzY`=Қ "ɻEK;c83ud$Q yY0o$c Y/U. g>1[ trҵM :[{o#kG]v0.a LEy`X@}B!QB!ď5WaZ.|$,yquM$ds\}Ea3Ic:Apr GY28o}"'L8ϐg$vߍd[cHFʸ۲55Vzjsk,Q9>r|<~&p|۱2N{±5fv0۽HO_Gy]?DدIGx3I!B|xR!B|Xbq,gtcՏ ߏ? wo,8 o Uy\:mw}z?$4գ/l:†ϋr(r̺ˤ+7^g5ẏviޫqo`\e25vdE*S3]N)Y:Psb^#8|r9;qU>vڳ:cVK?kȉp[*El):6NJM?X1B6}ؓ6>,Sodц6>Yl(auΩ58ZyEFA؇ԸJۃn?ԇ<Çɝ82c|:a;0b8+qzf~3#, h$Eb) W%vJ!Zci 3 }\0V\7 aPbclms9^+a/KU3$>C*(cG|V"|ҎZ6@l–>nO!BoF= !B|!\QyX<¶P }}PBesv>@Ew yM3`}ox1f-vb|Awhv^NN~P[aGۂ)]9ŏ+'yĊ:9sWý-?+~W}&ڤpJ|d(2v/c8xlk|ThG{V8#ڋjcM⡜[D1fX>,;~c n}ٝSboP?dq:d]{s6nA9Cxl^+9#i>Qqr,Asʯ镺l$B O^Xq=hUq8~Kc<B!_B!kr~ ь$3R:Zt}ƢL*9F`~Kx"ڰ߈RYgFi" > "Q{GC2|?L:ņy6}h/a~]pdR^Q˸{j13~0m ceM pJk+B)s;\^>vqF4!8"ϳ8籇Bq-(=R-TVwj[$FOjNJS_!B|z1"Թv,bǎ=Q10iǸA-T'%7~,rd˨1/y_61+68z[[si?'`6_WƆU`bvh5I굃OO% j I;WҼiTw-;=/w6E] XhvvSq{'ۏ;w5n3֧T{\ͷ~7ԧ~ǚҍ-XX3.r[8V^!B|_B!"X*D B|,^HR,Dҁ.?Q `$?ڝH{|t, ۙ@,5E1l尘-@߻-$=ܑVͭ#Ғ orD#|F-y2ZPwoGLa{BlO<gsD^׉{+Q;88auL܍1iAۿGx |o31E\>GTd3f $^k9oxLr xuTwD D^D!B W!B|5/f ߅B^1!njwIx]>cۨUy_D!BY,B!~D[Ig~!#Dq|kv9K9!b6B'؏ݏ-O_6r gv?Ow𽈣ב[~\le=GHRʋ˴#׫s67۱]!BBO^B! H~_uE|<"/XZN JقZq@Qtc𳋡1>HppK3EJ0_?W DZ%R}[A&)2 y!(޵_yる͡g YE"}y7]S>,v 6bhnm695ɪz## Wa7 #\@pF*sZiɱG ;qo}7Wcg^$bzmVQ!Xg줤B!8= !B|!\` jqsv˹PF?Y5}m|A*lcq?W'XGo}Q]:{C\D/1=m!b" 2ɡ!їB!xSB!ċY/,Y;4`E{?ҶE#E7;YP~cxع;[fK.ٸs=X,8fsS_Eu|o}r1ޣ0ߣr)D _.A>*µ7{<>Ǖ9}lHPoD X'庙#jR4ݜ\[xD7& $!yq~Cu7О}5<~,j3^ka`B ;޷ o6"o}Ez>FU`@4GMyK ׉g]Pլ /ibz;|~);s :xV1zr[zs}\[aw/8]6!B ڿ B!ħBxxN`,x<;~Oh|>UҠzmWޔS뽐2j yԾ1&H&gka蔂'0m&+/Fr)D؟8r-#oSH1V^ID4l6A&"1tBx=2*D2$@I̢"]B#sK!h|ϗ2ca*:#| B!h҅B!ďe y|ǵ_ƯX߿$%.ľ/g1"XET\\]>W%+fc˶HT?dDw=e|gݧ}#w0KՎ!}Z_gc\g;kGMWb"|\N\_s?[rvB! Y!Bݼ 3΁բlwC Łﵟ6u} y|,H0fAT$ı'R%-> 8%h y86ONst2q#+8c+t>3r&,|\5zG(I^{_'e4}͖B!B!ď$նGA_0}qϖA\qrUXZ˒ZրV//B,;+~k7ụlX}$?#1HK,sR[s/t$Lv(z~܆x4ְ{ >BeQOo׊v_~w =H[g"gq֒̉qz Y,^&#<2 Ŝ#!M{GX:q4-詔9r,>+j1w +g1G^œ=*B!=y !B6\o3f18,n|^m_sZm~᳥~ yO,z͏nY^䈰nL7Y4答‰p?8 ͅxH5~ysF;yD6 ?zDD[Dt7YK{qɠ^^05^ Sz1BS(2d^+)lMcXD&(jbzy/)H /=S_m8õV?,(^|ٌ+ 3`2uqa<61rF Gs:jG]{ !BgxB!/b z_%UmYEH. ge1kwZh6_D+/b W9AZ1A\N?n:!q}w1}f %hnP1  O;U/}yH8#P2B-ZrO񏹁:WɝIw7\:hDմN;lNJqqf60G~s qñ~gN {}{6e %e#X!Bf ?jI)JloW.92np&jO[V/epv7`s?!@h7)<&xn UMs 7k Z&^5PGTC*iE{an28-M蜠ޕGF&p,Ql/i}Yyo/[;ӳ~Jh˭MO۠ ES uh{>Y\YA>5ˠW~.* f/7'?Sv^p*{m9Sʱ/  8AA9 ];;%"鏊0ƬO8:gfs:c6nj}k#弾+eWMmyC:=̧=sH+eYjl_.r Szn!ClL|lM} Kَg}d^2(签A7͉͍~=AAVrocAAǁ'coAygX9)ג v#dDx(}+ׁϿͷɶ1_>gՖ;Lo;v ^>-5Fgem >&4sAAoAA8c;}&;};r5MsyCJ{x^)m/Cnߦɔ2CBS PU(DT=f+}50Y0+C|^m*mm+daPtⴵ }=ux!Kɡ;mq;ex}NC6F#O]A\  ]AAmԛq\yA~Z{}\ڋ2@1ͶRt|N˹rli}򮪛t_?όɄA)HYOcc@k\[#uq0<$c g}g,-łCq(o"鳣z>%;JC]K.?_r-o>pښFۖS5Inze)=%VXyccj;]at8n݄eO'0]e{t[Z/!yfr5AAⷯ  ;醇u|(C/Cx=PEV@/*j-먛ԆYS%~G=2?Sي|nkˡ?SIi\죨/NiY7wSŴOwӁ۠]:l u=ALW)&86+H:*= KR[˦g|mz@z5/&|cyȌB *BӉ>2J)6^虜\ep+Yuem[0clΉ67ߣ43:vs>RP j/:փN?lcg`;LW(4 }"jADv:'}oRUC4k~0[CF}&[a 8&%iBP;wӮZkbޞw&p%U۸eֽ2Tl|$?zIAAܒ|  [~,`Mw#3m؄nTlm !'onm PW}67XJ9P7gx;o= B]ϡ@F/h N{M Bי[灊˲8~ԓ |AWiZn@Q'Onms. ~Yb{^5qaT[Mm=8k1ZcTrݘ-8>~o}T"&% )#mp1پh/GbeLwx4yt})h0ŏ o`VwlE pu  $  [@vC7!9ܺÖ<$쏿"|O ݬ C$)Wd"7(G)K:Hv|Q _BYf{{|[Ҧ{)G8.4/]j`(R#]CV)u:甙E0aOyZ>X}/,7.ׅ1*Mr_lީU&y¾sUN> Kv=#.={ns;&jwy-/{cAJоփ  7  g=jv:XO)D9w?oOX,2#G"L~}7W;.y%vp'`ItQ:޹ 5]Ez} z|lC|}w$}%ݯ_L$w}0 PQ.>  dAA£:?6(axyx0❰/;"q^tn,S;9hr1<)[o ak+M&qfh3,`l.6כ4B=F6ž~7 k~2؃w?6I=t5EB=]KOʵ ?79  xSy~C  xuӽz_z\iY>qw=,EW׉—%gc24Z^v}w#j}љP2M 瀰d(l͟pA)+` #fIlna~t_}4+cs8JفMvӥyZot\-Ep>M'>{czL KZۗ  ~oAA^Zlj0ns8ֽʁ[nkM/,D, >k:k,,U;aZϘ2LG]⾎i$NyNз5ɵq[d謡NS-1v2Ȁm{Ă Z0PNQg33)!w!$yβPwuX÷<ům@4:cjLJ.0+5L>YZ ,1)Ⴞ|~8,7}N >y70u6Tkz>Ҟ loik^dX݀kNwퟳ6.T`n;sԌ|EcAApAA;Rvh5v6<_viv* * z2U=wtkzn;uKZ;Ӟ!,KFY˪8Bx{^u]wk>RNumLCʻgzMKd1Or)P0av |\] ~lcҨ^0b$6CjN/Υ\pOl?öwͧH Ku[7?<~J?kGjS?$r%hjsmGYms^cܦEt ٳmg$vGԗ}8j/e]AAp;e  ð0ͥCAWD|wЗ{Y 򐳼| X8h=p 67 r#;$XZiڻJWyYd:uaQi6=i;lZ]GUzw MȶU{y`JNc@Kv:މ±Z2h5 ^RLjʼGnGzuvh-TO.mlE͜:6oJ9;[6;ڲ|vcX+m)MKGK17{xۡzM,uA9ΰOΩ:.|Ăfߞl &F>ב-_Za&Կ_>q< #4GAKA9ښom Wwqj*Z׸o܇~;mXݡN?YͰ456;Oͮ~r<I*,=Nnבs7  x57  /s{vxhPbp|t!e6ofR0h]WѠ4cj{V*رGP0whL~zcG),m\Kk6D`>Z>=djaw;YM_,\L hf$};ꦅ4) /fqu5/T_?u c{g 瘳|N!1 ڷ;~E΢E9i,w}߫bӲ4? ͆WhAA0J1Uyo{D!AWw%,b-уC*ߑLfvΫ^iA욡 {?y 6"|d߭x_}40B_]ed}s-u gװ2B=+cbW̞O쫸$k[ *k}PS]CTUbj \_b>Z߹-aܤ/LtMRZyS43cJat(+u\nWbAW5` ROF#N>)crx Gwt3= f1#5Ax2L76`J{6ǂ7mjikxY&ca6me޴}sYǦ=Ss5G;Bl:/SL.*q|8Ƿ~Bjsq xUv6&Mں>)}هN fd{_AAp{/  `?,ATakpk `T,C_ˆ %5l_gcyR IA w屲xyO^6*Nj\e֮ KYr\qBIie! $j|"+VVF)u=QYSme`-O-u>>EC5&B%pn&ZS)d۱|7~npN  oUAAJ١Xy8dpTX󚁨^zZa}25{ >VQ--:;d,8m5H9>ݯwN1Oy^CҲOR9E{4Z.Sg;lъPMu^{.CHL31t`!kq|5mWbX'U%BóűT#Ϝ'UޠoM#*8aVSKZJ^izʪ֨6!ǫi upmT Ao$V>a]FbyJ?1T%05)>Mvm@h,>%j'?6oΩ@h¶BڇG}{kne&v&V5֋*nc@jvS rͻs1 Ƨz8l{ߵW3t<,1Xyz<;ZȚcbivr&TT3ԡ^OfR-X~+NiZu5E$ӷ3y_+|)MTWZZ+~񝬮/cԟ k^a-Uk1"mgwHqnx|YÂߺjz*STbtިǚ~;d/1Mұl;؇+_a [m)m"~2@G[~ pn_,TQ728eM]7 _FAځO!\3:Yo>>"eQǁ̻lx)ٞ-8Ezy؟ULRAA)W  `[x Vލ6&z D#>mb-6z>- NYIޙap|nVL/Vs*A*v<0M}E#g})-5 OjvM Զ,2κăSS .[lѾ;>ί&3Y+\1'Z=P>XB1T''2C*Lf3Na>J6QiR nt9 ~{kG2__\Z.`-Օ̚Dp* >)W  / h0f@:!pWes6Ev{eplSPՑ m^;>cWp Nnj[ Nюkl&AͫUSVѬglEFM1[,Lơ?zP|}(2?9zDf yr|H4GdYC&wa97~ yգ$ӝ8k+W2mީ/wror]Cgy)Jk+YC*; c2.Liuaj̕ {…˱qCO.Enǽ6V^CF<2>GkCr}GٰdTC9Cp2?Ίz4OC  w  ~)Ny_ll17{\L,7[[@_F fs ]7p6[aS?Ҽi]Lc婫־z~%->zN;J׭3 nuz||T_3K{@^=գE$rc|)Uh35j*&Lj'0S/̚uC;L7!Gձ,tWҮ^G.p?K^=3AudjZ|{rލ}q=u)3u=pawYb? *X߃a;:q'6{mXk窱^M5r}=_|)նtANy]9AASAA@1_woNp-c$ߤMq0Q*VsSQnuԠe NY_у҂zrn[Èpn0C>l N-w?mO6C"uѵIUp,FV([+Y.R<ǟI\L0X Q6ߘVnJRUc[2vg5RﶕjjlϿ.~󥬟|! OSf{Ƙyo{΂ӊ͍[.8;4a~O %U^x?ҹlyq=-浺FT^RBv$-`H,-CT!mZԞ$ҞS׍>  O*AAG̗] NuLfQ6rTcgfWshR(T:7#M N%AUm ʾ|m8cZ ܤPs.ۓWNQRcc[ojҮkץ>VyGzbtRb::GZgc 5"rY-CLTaѦY8ŝ)%^Wz+qu\wLx9ϴ=uJf /B/Ko~,ϟ,_dy-ǘ?>6OUOYs؉/{B)jGߕ?ufmXI_pI@&ۂǶ's;jZ+a);[ogp*CFSFGGWۚӭ5ۡM{V  7ʲAA!Aa @)j0(}X&]L\; 8ςG{(SRZ?vThh9zj~ȎPYg'sH"ey4թf029n|NzYwl+rYkhMꐲGq[n6K҇s+&kY/4}_>x.R+/zBx%:\ضuWKfAJ)]EV95 HUv4v) )$00iA ET;S3ϊMs~p57ǯyM}^Ͳնt{iw2u}瑶64C7}Λm"8AApU  !/ e$آ|)n h S/^| ہ?#'8 ]/eX )E{1ԣg(ǩsxE;r#w} ~Σn1\]yp\ꅾZ9x.;/ N1g~؅۸VB#fT߼ce}i+Gd}Y r1=a(0H#UȨ 03 HI<N%t:j#ZNjiJi/7~l 6SV<)y}Zl%)S ~ae&8hKɽ|}cV_TtM6 徵WeF1_=8eozOԶz#NüRˤJ)KL  P1AA`uyK/YYMMYj>5e{&A# 2sܫceN^ H]!+5k,/ծDvS!KWPI#`\5:+ -T!zY l2_X70v}e ~@Vg cPj YP%zOaTt8@ken/ܞAc#2HA6 %irj\.0 hLKw5D!6 }KW{5[,Ixj9ăRޖܞ;Jђ\1N/-0>GlÜҦz1ٝbm6X,ɶm  q  !3_s8=.S_ݎ0)kq;evhFy^YσJS+ɂ.z$)J9k{aў,W}=u) B [-2ūNί7{nS~jm34 GZ捒Z)Z X Z$_' .'-tLYoe9>A)nkuS\T*N=d i=~GG2{'2WrS̡He]0ZA ׇzpf- iWK8Y^\>7DV DA5]Oe>}g)0Օ#]s ˜g"=`ONn*״qLOL89^1mL?S{e0gj.q @qXGڗb{{a)vm|yG۴JG:Ճrg2}ciPώ9z, ÿ+5s|PX}Gڬ0"//d>Y꫿<:_DW"ח]C7۫VJf6!:]Dll^&c:9~ 2T|uOq蛙Tq[ԧuzgm2_˻3s1O?%7tJhVX{Qhh/wf);!inp}c?*czWz^w,IS/$^etNP~Sp1z&Ojm P+\&SAAo&_ɂ  }G  cA7h i7O(+gTήxZOHֻ2}=, ݘ 4>\|ZC g"ۃSZ H #!p J}q4&W]FX[?HЖ?y֢VH~kz__As- YNNT?>@w?TG'ƚLwuAݦU^Zf+/_Jg"OΨwK]/9&=-낦 zy>ԪF:ѵA:zU&\c[vD=~ \ jM=Ll-_k>耮eu;/W/r sIDATd~T5I5 TC<u G+Mܶ> _|f2-og=-1~j,)ǚJw>@H_UJlq9A̦lRw+gvqGnL꭭]t9>Tj_M(2}|eyg?  x3JAAqTCuSh i1O549j7 H9FbYbyCpX?<ۂ d=zt~Y`}N-ǧ?S@F8w,-~3+'eY=TdʴKlh>11:` iAV" D=քwA]^X9R _)RHh?CUȥf ˘Z?TMxװ3 BW3W,BPerT'"?Y:.[ϫcIp"ZKRN|=BVO?=i}UakGs'pM~)CN%AE}ڲ,#_Ky эIک^ǂ*jRkJ2 85dɿ PE?)AA,AAB Nu㑵Syk;4#epʂ M } fwcp@'_jǺ:ήcJ8O_sobYu`7JU?(-bPqVցll7 N޷?ͼ=,7JXJ RƧ-{Vkjl.Xֲv."~&w?>z rGMwGS̷K^?nCQU֫7;v3\v/ep*BAMWph+3P]!Q5f:Zw|o6cwoQUWMAA=βAA!xPRJB),@h)Z;*H5w ($mq_{};"c}7帰Ij5ۧr+ZP,5qz{ulWg6~ yͫ4)}|:Wm>5k2+JY91 ֗3bAr+6˺]zHOߕA?<>KJ||MyCӼ^EjWwE-+g_c&C ^QiXme906kXKZ^sL hКb8' n;'wZ'lz@=H)mx,{{jðF=\|c=]]|LD2OqCf _:+ʴ]I9od[2.5;;kluN ٬tǼ h)BA,QHt t+Wvk;,"TVvW躟ޮ[Ay*dH5vQ %A.աev72阞횮/:?ZL̛m疶6惍tFI     ȮT,afay>3hg؋3 w>kӹeO/MT߫^g?v>`]Bޯv\KRuE) hApo.׵TU㡎8i\߮'89Xpj8f:/oWl1~~->SKh^b.v&Mu&} Y1Zb\n.jKy=Vo OE+d~TsY/Nc%t7/:xn^uo9H 1P_zGC1?ѻXG7P" ^;1<繝$۪Td;z9ؼqRQ_Nʼi|8FwK[ݯ1K{l<  ¿e  CI>e>T$a-_ 5LUIׯ直vF>EُU miFWbΓnk=^汰`RڜڝjJūbuVɦOQ`]gl0NrZRC^{J]WTGr9?g|+?{?;k1A5[AFf/CLwC u#kcU΅ܲr~j^qwA;/,yCZ̃'j?զeG#NAA߳W  [`<4~k, ۔53E@v=֏b.R;$cN]kKMʱib$>vG =ck7)7& F^ɼY⩬_~D^Vj7f#=ˢqžA1Rf͵<\_ YgY}'}%w2mӝTLv:B}{k5žҢ>u,\Ucڇ0\wx;_uq={+czd9JbmrO=@#rIwx;~wNP}b%}"lW:"ޯ[.|;  ~/s* `OxxܖFy2Ah}vR6*(M6{zmʉTsE9.^Yg}NB}s (S'=ݾݡkH*d{bƱ9MRA]ҥE^Kd{NۏUJ}=BzVjֲ#q5?D.JOW^ß#c[J}&*[9jez44__ȓ'򠹒I-GN) |e~>eDֻLdPc}ii~|.`H* zbVn4;Ѯ[-P-f-Gpקm+e}-uqΈh!0850=`d!W/ȻԋM 5ma9U\+&S'Zf~2M{Ӓ?KޮkOduzNߓ$ρcR&BZ[#^=,7rc|=ڮKTk,CtiކY}qj(  ؟NAApYjb,xջMޱ@ +vۚw WMmzmSU[Bp4BmzxQl/2yڱqds&گ֌s`<>q:Hl^iqNϴy/~}OkNqqj,0\'rG2?^~ թC "_I͟"ȷ-ɣz- =lOCS:ß{9TR] 1|km] D۔lX-){FiyO6A74(ώ ׳yk'C>ʹzy`5RG" p]»DNk糙\D2ФRGٜq6]67\ r|NoKuBܴ{TXsôS-ȫlu,gӠױn:qj(  m,  |xb|flCɶ梍J!kT(,a};.k>Y6sޞzc!vpn;Hft7o>i+\Zk'?{d}h֘:G(3:f_}6{W;Hv>^-U+sLȹpȥ|Yi~c3-f@kott=P&BO~%~_K$c9D SnP#JKȵ2yӯdV_ʬ]C>ZfZ*5Kwz} \ {J GZ9@j;獩Erc_~n?3G֎)> t0k̆G*XWFo_tXYy6^ˇ_NT[/^`0TA\^@ݣUm8wuu,ɉ'F?GY|\͸Bw97]d&2'Y?O9~.'+>Rԓq#h̓>jR}6wipwDmz`uϮ4MxqPۻmӦ}:yrn?uGd>yeTo MԶ֥jYi2 ԔvR2v#mׅSYkLQޓLEް?cON^  nOE~AA{= "MvSـҖyU5r}yTM_Vzh8 }]\ =PZa-KilG5Khu=LK) 8>Yry%u-U .`C~zSxJhj961=ac3*#VM_ 5ٕ& 7 Rq[L B_(*uܶ]^Ȩ_]A&#_LzV2޹W(Ey"z(M'r +ߟV`Ef(бAA8"SAA{}H>?oN*P<Ͽ\δSaގhbDj$0cuV۫KCNldv./uP0\_,+mvRoZ^BM)vA&҆$dJ!EN{a%t!z$/E??gYs؝ө!쎘K[_?S9d6e`"~ͨ//ڞ1!PfcrnlIMշ,"^Cn9Z͛V f&˫K/K[] ,T)o=.I,Q8=ZHu@fgFjUf`wqŝ(l 4 /nol y#v}) ЭmZ-A-t/x_ wssM6Kh¤LaKZo[bm|] zWTݯ( aaSUr /ߛ f jT U:W  n SAA{HaUЊ=a;RـҖyUu:MI2e _tp 浀J_מW&$N7%%`syϔJo1G( OzShW˘|隥7]M~Sۡ~EtGn/4SYND},_dd9lXC&|JQ~edvTKY@g6IU{»Mt< ^n5wShy96OHy76w}OB'홫JAAk٤jRt}._ ix?JLNe<|p*Z]H\5M4;SDndj,Hk-X67KǦEk5cplcqXUz9c,s5 mr1h++8J/Zou y_2-wsp*U =r6*QzlΦ^7]@Ԩ(f(3f  Dp* `OxeQCWpw`Ex޾w@<#a73N6v)4ci bS=3^R{J?驢u:mlv1J~۱o?Fԡh05:s鴜ߌxRRlu\uHF^O{5[`@6Qo6(_׍Z~ѩ4??Gi>9W1t0'h)ʫOd_as%vm_K5i>`A5Wr5&z͑=uaʾӕגy.ʶCr_ڴ6.hkSe6]JfkWi>/fk>p!\f3 zu.%G-st}N+ZƐn%ՖA"lX+D~Tuot؇b?en`_}_WJUCJ Z0tlީa;M NZ  2 SAA{zH!aOx2 ǯJ=$)@]W2Vv6:[$eLtc[^<*W)q;0%ז3>^*;{i}XT!0 묖Pׇ Va$gz{sz۰GOPcrLjv*NN~e/dyo!.-]Cjd{""rɵ#`\JV(y޷þuI )>fx]TyFK#1%8n&o1}SMt / Ed‡5rcTj%rĐSiҲJY#G%.10˵L Mw\pCicebHe+%CPjbGe}>E˭zӚw&kvUپk52slKrsI!]-5+-ڵvV{uLjܕ\[Bz:ʂ  !  Aj@ LGq4ϲJ_!):n</mz{ЎV-۱2Q(H)K/IOm-Aŵ$HeXf}1MA(x.쨯:E=.f u\un7 Hh6I:Oɏ =MPTݙgGkNkԵWK+g'X'z63/y#ã{v" y jF* Æ;> 7]!A + !4\?X /lka7=+쫣{vS´wZ_Fӊ@ꩊ}転7?[ڗt*@ظhfv3A]S]̠]A[L  vy Eұ :CW|qhv?ylEE^.2fTu:N4e 鲚{̺/Ξ&vpmK}H7xz^]?Izm6:ZWK܏.2jvh T[l2TWïu ~D>{y9=CdGfğ )H!ȓ?"R]>R+kUU_ WSYI743՜';9"@qeڌPH!»aH9J/uyFP%=mS/iUPwmk4kYԵ5Z k\,Dˮ QD֫F jel1; "McNNv1j&$v}N9}/~*'QLli斠7DµJy|yІ-nbtE3G|jTM:SorPAAߦ  ðJGJtn-(6#x2 xs?^O Ge엡%1V0.˱aͤ'U%f*O~%_?~'rAa5,?KT偬dѮOOؗ] SZ 68^EX-pq|yQ`wJ 2f`}<\"&E;7QB2o>|eΡ^A>dRǼ so8V/웳Sy7E4.Moc=C̽crБ5wm~7~A82Z. m#  e:\é|Iu:h 5]0RF/kWzHސT}w:*ApW &SZ14rxu쥚S̎vqXc%%OGns+;R~XaZ/Rt ІjqLB.28FCl mQo"?9w9iWmt_g3`N7EzM?Ue>Cmrljt4,2SeX~1h!lp@`}q דVV-'X%vV}Yr;|6?;~[V3.J搶FmmüЌkޏ:侗Xs i6j 2WZB]kA[WC^?ɘY,fPѮNrk)e&^h hY*-s mj{=kd&ف}&X}- |  ;æN¼gr)aW/OLoOxz=!5懋m-xjߨN.{S2^s3cf?v0&ߺH Yeu$Gz>`s9%]S˥˿_( 9ƾ-U4u=wmpX\kaяbd_u'C X3]G^Nɮ^f- N^?`FC'oXapw~,r_'@2G4 MB>[jXD?NF]v0R=u֏lk 657Bߧc%   _7  -걌'H'Y@5atx(f5~W "ǻWz@;w@3ZmSࢅ7e-Gڎt mڗMS}_Σ362uú:D|&_\Ohn0~P7?b|L1 %4HT[-\wLӼ.o*v_A[=sZ>w$-:9ᮧ{'r|\ǮYIm㰼9l~?c.U -+kS}cdj}5u ZgN϶  x_X  --rOy |%G yRkYGsL׶\/4nuDBP#_s@QosE mQW% XJ?JŘ^2apԵ>4jW+:%Ur .f*KPҚ u`r-GKZ\,N,85p<ƀ9d"/V+9x}^a ,+R ;εthTaIvGE1U/̱59Pa!:P]!8k}DӺfmW׶$us6f:e-ل71F ?{?$;)p>  S4  8VDagR<źطˡXZި:2.{ 0nAgqߩt=4Y½xUi 2K)00t&u[d!{jqj6i"5aD/,,r:_t%v &@=$f6w~]p\.&c |Hr쪻o|]_C3V6dMcy=:~o~jwK'?7"5z\)U˵v&G)g|,6X3 1ncڴ`wýP ޕq6|F~8췆wgp  p   o1c ;t~EBt?'Ts9E兜V"?M`/!hqhɋwE~NgWcє&MY]M L6!,[9ă9^ץ~61AA#SAA?px,`j<ܵ;7CC%2w U(`擴ڵL'gR>~Gz%4Wi~k9URiP*k]|}4yG/0zmQMP7T&g#yѿGwrzr{ܻo>ZF2ZU6FTîOKє4Y}[q[l[7l~|saAA   ^9BTE/荆.N7U.65@*DVcmQi'€dʒdU[T"Bdqdfg䤾ɓ?KD F(>L^g<67B߾eȫsKlO6+3YOd5=3sEȓb\Com)[܃kLN}yO^@O_*BudnB*Yk̰t=1y}f9-5C_{AA!ySC;G;D $%^ߧM ~HX.x#׼j{ֲhx"O/d\aQ4o&6{N\>ugZWBFk*ARylǢ}W@.]{s wDQSd_x5'\u(SAA?$^AA#ݵ?&x`:<};BXm|2s08wWR{jo>o_㟣nOT1M|~RNWrH]RV!cA ؇z&>;o$,EiﰩvC)25yG m[~t `xFфAm9D#Y3~s'TΤFɚ;Q\'_J^du%Ow9.XuO| loEzџŽɐWBGR-7NN ũh溸`ղ+$c/KN䫿 ϽVN1T.frO&c}L%bcwBj ~L5W *|G d߻,uoFh}^?  "8AApk=;L,퐶ͥ7-ۢg{ocG»)oc)-iDa=-fʓlCۨ]qhJ6xzyΈ;H֓ZHuH䃟ɇzhx^<^g"_E&ϿwVr.a=#Ml7nz(zFy"tR嚖6ܡ'.w!}/{=> XT?G~JLȓDgOEV" -)Ut>\V=T|& GK&TF8==727CvHct7\!Ma\7[Wnhq}|qAA<  8?tJzեʾ63fc@=]G2ZL_~e2ۗ9 ټLaNgFɃI;XKk<<>rΏFK?i[ UVr-G=~&"3IFħFVWX_O 9%{B=y4LOpz1ߺa+( bRrQzw&wx0߽_]Se^ۺ'Rô.s}](f-G+9EE{%rȠdnw+ciP>3/|L+- 5Tr9k/amFAF]/,0 ~)Ho 7΍Ηj59,Nj~ ~^xN=A'֖cs2ddc'  ~_UղAA`'NxC|=Fj:s; 8h/t\Ϗ)f꘰i dqe -uv u~;gȔZ<9לPڛs0ڂ_jgߟ:K'~Hl}Է^36y9D;0AA_(uPJaZfCOIGZךIBՔڋ&\co5=#Y~(GF?z کez_N&_FNο\C_U>tL!WTܙф#aRPZ `WcKJG}uι{k E>N׹_I.g_9ש4%.Uo1fNpDX/YÛ\DjH3Wdgg,ٱ~+Y5)v$4Tq 0ȐP WϰTc -c;Rgu] j6eNl>d }}T5M5X^13J^CՖ.f^%_g/gFR 5 ciއ0Pv nꃥMئ[= m!SAA=a}BOښ hi*+*OgXE [)0iQ:og̒xǔj{/V:UfܗQ?c)z|cxwO"ѠJJkd]k߬KiU|YRXylNڸqk-}c~'>z,/D>7R3il۵TR>,<_ȤwMa,: Ӽ )Կ׺f>M|(狯+ Mr+@NWCq 8̸5*:I/Ļ`,56a-x}騤﮿dcu|ww!Q}v}u%xyx&r|v~ÒTک,_b^9t0`v] r.}2$wh}%,'}Yggɣ?E 9j -s"6YO,["Ey(~uw[s^z_!pUE:s(~Y/(VܙAA6  n.CʃCϱ ^Ywu&uTٽ¶Y0e/C;' =ֶ>aIcZv>b̂v؋j!OE} Q& D2]_ʻR_.O*e'A& ll : RZR RL h߁=`{WXe0tjq>h8K23Y@'GRQ}%J[,}iA2JV'|KiNޑy-+F:ȻgU]?E_NzZJ?KjΫ]]׾T+A34wB2?  x5쯄  D,Iwe#O? 'Z C!9bj;DQeh3mWr\_KJ/ `QH} )^M>"uetl#;/ TV# _rPtSy.Bc0ZW/E}+pu?ytsw><|$kO3=~LK9ePsH7!sϻu x"|[a@8}1n;8  AAE|lv(*{jv"d*/9'"}*[05h2_K{y.Zhpdu!y! ^#6w}m:aS^_JMqƃ]=^Pn mݵ8k)I^ec֓Pߦ0BYNV>M==}lVmpךhp[ 'f; n8췰  ?ts8xMb}Yͤۡ ZVYE}$iDӯ4L\7~'Y\'ǓLc 6E'vFntP A͑wܼWicLVB`7=mkA=/|]oogJBӿ<m}4􇃜MeǏh?n kR{lB]O,okLm  xm[AAp ^`Ե~hs~: V~p_}ۮq8y(|+l&j<#LapY+Ef 9^`ei7`|8$ X[Ueߋk1pΦ(Wa?⚻Ϗ}ؾ,~j]kUWûɶ|}WS,+yT?M"+Lt.W]93ƞ_qMgWT(.W=wDJ3@[ֺs?n|M&wP/AAvAAlA1,$zGM8۰Vڲ@ZVU1.Yl~R:0R/^"^%~뛱yev-;u^|[ ڭ'"D_Ow&  ^IyAACɇ+԰O:QIeuz-ELmҊ\bf};mGYo{qᵖMx8Cͭ#x`;,RJ%I%<(?},/dD:ghe|)gM/y%-J1jbm䝎SF :ϩID)k[l ߷ÔJἰgskfy=>Q l/fN$LM [ð r΁+N+l{~*ky^B䏿yUۉNu*g2ɿѻv'F)+zkn{++..eoDö׭>nZ+疮ۚCSAiOuo~v1tZcbFQ<2AA}l  {;,jЬ%`ę|D52*z0?lmw\x)[k-g'"?y3YOYBaJր../d"OUN_~!  0`1{-/x]s U6eFpgN9~X5C'fpft^0'tpń~  <[QAAXGyyrÃ孼zl=`wv9ZxBdP"mgfg5HZIUT)SCw SP}l:tMx7,9bzQ]z9 1ò T])Q`Th7=ȣO~*љ{ybArCC?"_K nI  {!SAAo-~0;2vSp{#dQv3G{H8EEc7< r̻O^>z-ؐMtsYORfhlQmM~=uaPNm4  ~h9AA &yC`{]A!>tՠZO[0j?zPҳ<ɺ\=RSY+9¤tՙ)vWݙŔvC&-2 2>f~FqΩ[ٯ P*,' Y{ɤz1dC@i=N] <9|ocܽZ  @AAX;t|:.mot`YЦ;.A}NtMzߏle rf΅M62ierJ;2yciI]-#M>/m2]y7O]^[Oޚij. SI;|03![Kіe~g)ۓf%{En:>]l&ݕLJ*S2{OoZS?m:0 s;ؓ7 6x;ixO\uʓ/XD)G2;{_*,HyC6Gc nd c͔2>]ኑ;w>+~$|8Lv}'cj9C^6VAAl}AAЉ>ABu]Ī-oPf~bWa|HoOYuA}x[Z%v8s` ܰnBJ)_mia@c{sT5yC[x>!)Pu2Ld{r1avkV2o^w"琫KV+ɻ!#| ѣ,%csxl]׉/p zT5&7?/Vux>9(EN=uCzr%x5g[_҃W"tU! f 42`y-r}!si|):QE9@Χ9Wr"u,yxel^R,>Q{JjBZ|όS\mo%]ISMkoe.{>q %Lۂ2ϮU"=3R  }_&ղAAAw6zPW;h>`A1%Ed";VP[zLuq邼Txqt3<$e^^>Zsjm,ՃT /x9̫MP;:eZWǓװam!|Iι_1ŏ gkSJH&U- O>,C#']tsl:6ptWOz,2P('kzbL#R䴾ϥR|.'r-vz WYʽȀsyI%%kjfy{mi& ר>DnN}6+,fײz,)'5l7ժ-Q)FvW/\W9bKK[\OocE֖ـefp A-_O׺QGtS+_5x-Q~=N7ZH{:Z]fVP ױ#o2GfX^rQk-Lt=)  -"AAK>n9sĘq-b[!}܆ݘɶ#f bwW3=t몚>+;Kg?6a6xg2nlMq,)<ysw~"r|M 4t)MeV [JiG)J*Wtu];g{J/P Hlmwp|hRIytm?굏/R:erץ)aC٤\X\2IJߏzD>o^d\ 4+<1H,5 lo_#; |X϶VgHs>}wA!~nam]b5]K|!$Y+Ͼ(4Wh;\2e-m5s1Fʽ覦AA?r"8AACÎNSlN~_9(j-%3GE"C)*3pEc&L+Y?">Rg&~i ܍z $6\2^c=vO+l/ RL8hbhNH=8 2T_.D.5"ė%.*G|SvܨkkA={u+?2w6вǥiJ&yAA}AAp78SW[2:kNE>x_d)=_SRgOEe&<% Ookx>lU=~nI06Oi.<YYU(\a^ɑDΟʳ:Tȷ3X|(w>ɻ0GϾ{w_^L$xYo}>wܰnAAo3HAAZy7&Tm;gʣlYJ]Gh.xw{JR&G"A9)3TãZ&+k Rq]z, 4Ս"ȍv|\ؖ>D᡽ dR] г0_E[-lr%ʸly9gb:3d^6;5P /~O4Zi"+z[n4gM -GRB#.%/ùqk5eɗ?7xU?ޔqAA=_AAbކCػv87QzU< ugcU{OsjG!z!j*9DVt _?ʏߡc7 MU#u\4NϾi}5lZ(ϫ~ΘN$V1G &֘}aCxz= { .D1F~7S$ݮ݁H ,;]ԃ 'L+߈|W}W&mgR=x, oVAáE}0k=}і\Rոyb䜵}cM93> ]xx  ^oAAo5os`o+C 5 ŏCM3|nfWSˇ6w@L?a/‹O*s8ֿiF7r*:ZZkDEl>Kn7y\fJ* +t>wd7=Β]'˷i!~7&qz0kJ1ng2t. jS)iNo>=k{G]?ygR7˔RYGFzHSPˠoYb1s>vӶ1ZV n {3;i0?I BVÙxx*Ρx6$q[q  ~D7  `'!N. ;쓏 =2&6YV%mkၬgx_da  v/Ŭ0cǼa*7ԹLL⇽?o U!j_ljwzhk2(̱,zўV\ 9iR}3 ~JZL^|' SKبQA곏h;%ccG1lq~yrvgm;V;б}L_L7[Gs#҇]=o5 + OLѥm~j.5Ɗ¾b[+]J0C+g=U^C%} UҷĹT|$\1Z|>zSKo vl\܂S~$ûbu&%앚.hQu~K5H}[~Jؾu-DGӡލFQ .kmjscL .Γ]vuc }r|_ 1lmy7;,{-AAcAA3~Py~/=lv.=z _)~lh˞5a1;p)OEi, l`k4h]k{q*z~CUTRϐN"U+[熧>d쑫(̨z[BoHNaY<ăe $QFͰ¾qe}5v~&  +  ^8 6=-K$%{&(bA{uIOԎ(;ҝX2LKyT=p$rCk\^[T :g5 mZ ];fxvS]\+ J/. Dn]svw{] Dl.k=ep{B䛯^ІBәԳ9{zvM-հ7tۭǾnNe ڸ]@C\^'{AA  ^ ?îtHg7߽簷m+ÝC Q@xf|T]jy d3fnOsu}%K 5`Z\҃%R^j)"Kxkz#ڻʂC% y}iD_=Gs .Rۄ~urG2t-8-X̸CT@)lz78#p>7/e1Q f%V"_.rqao"ǏzPN -8Jg{=yauwyb}ݶ1k#U t(*@J󴏍:newv;AA6AAV<:^j]z2l3QؓaH 6!|Yel]k!.H`>8%3Sg-sV)2EEo wBV?zRIz]WG؅=r=6Q\j&l?  oUAAo7ñۙmJ {V=(56+ϾACmV  cwXlr1<ߠzJ&+6P#~RDKTײ~!ϟ&~>fKp\w+[papSya/ȋ7_rose4rA3Yȕ"L6_} znAAbAAo ~HO7Ǭӛ%znp]k{~HA +M+iJTNe޻"s~N2ӛZ&M#+zRxzZ6C~tګ3;y#~s v}4ӎNś"YM8kP8Txy=f ucOէ|`>jPGv/|AA]  7:?7﨑[(RhNgv1O?)ddlkBfgBq6ۛVM-sFo.սac>ܖػl8Kؼ?7 a6i3},#G}=eX*P Veo1I묯@w^_B[|]`06#}znxzWnlx  C/  7LyGϦ!L^'\&I{zgO2ִpkfRAHSl.RA:j "R)ap ҍ S[e}k{S$;0bZG-h?=AA?<7  @)H+ۯMu0Gyb8Ckwi;gx<5]Tu4}NlLhc;u`4π[1c{kz}bZq=ލ4H;>Ev[s OR'B;lZ)Z-ρ2|L|Ci^ݍ>gGW&"jUxk >{  vދM_|fK+l5[ msCKؙƞU+[Ʃ[z/Ry?5_3"t~rsԦ|܄Iߧ >X-.McR`#  07  {l51,O)7AHg~:.bE[ \v;B#bMGȤmwP9(j!+@ kƦdt}\d}_K+FЛ`F'^k WwdMxƆ%-2P~_!ir|3av|޻; CނYg~{)+9*DeN*u[j6w,;Z,}xЈk3O)aePw'1Yc޹4e?  x+  gﮏ*wrwzD=CMKKnw?f! ~؛>o`(Z#Z`uWki./ЦF`bwBUgp ?Q+`~f.m+;^Р`S@DŃ#f7p`-=kׯ뚝z%Kf W"aM}mއ#;<v75t J{p?q\Xr8pRy~  noAAp.^an)ce3{1쇏0Ct2\UyɭxmwO^m_(N b]/!W)0eRF]=?o=ѾH}շep+}^YuA% 10cY,q.MldD/~sxؼ{Ck >o5x[],!cE58; }c>mҷnٶƆ6ùooox    xpՎzW^qk%+~~dmakcb'JE~ aZ^M+(5D ү/9d յڏ &ε@ eKҫSΘ='wñ'nphf^'b&d?|.FʝNG<2psf3`M.)|¸>6Zhp*1pfveq]i`\9w~p?^mAAA  xŘG:Ã4=tz-oV?lM {~_}FnoWi;i7u!ljګd6;d!69I<3f"#/qae|6Z&cXUwrI>&xWKNuQʋn43j,}qqJܶ6? inw X`J4b.${w[hyh]}KUqZk;𮩅̎NL#mnA_fxÙ-PMU0'nH=Ѥkǵ PwLˎaŽ AA?:{[Aۍ~^Xo}5Ab?c5ԵSZ[Ի:RϷ,gغm!ŭ{6nz2+4j:|t&ͱupvu%f)G쑀uֱ+}MnXID"vg 7Ky? rW44Nmca?bWGO^:7{2*62Epϖz,;d ZUXVRϏertލ  &A;~fX{~'7q8B|ljV/ߓ>|?Fn{37&6DyeM.+W#͚1:-̅}n.  /  =.a[YbA5z:=SG{do͂kv0Z<ڶV]գD=S87yV`Ӈo*?_3GFSiy=1gl֜=V㢘OxmΗݘN>B'ڂ*̣z5l,5N/WD;֔=Qg6@mKߒr` (^{;hIa?޳Ma'`ȚAۭgs:m.,OpVcZo}Uׅ&#+t$9L5O (IԷ-}M7>gU8Y]ra3L{GsEh0AǩY~+V@7oIӘ_RvcDI#kVIxa_26=#IP ,잞3jy={9gDO bIT^3D&DJE[yƅt3_g *P|_db7KLG15lI]_K,NE{Z0);!~Sm68k1 Wٴ`;%c ]~\M kkYf+ZaŢmB88Ν88菭 N oFwݮ`=ݦb #?wv{-Z*^A63i?A'AK>A)* E;GLk鍑[M}Gt4ez+e-SHbί9czM1hu޹kCt;UaTA\鍜Ιg6B4mCR N>?zQ% g&?o3Up#w88ߪqq+p2_r8neӅ7d>8ine5nK0(79;ñ Ð 4Y3`uq|qg+SӧIjZ>36\ۆ` q7mND:v3:A5Nz;DoeH\IIۃ>.:{wlgqqc88 ;!As_ qqļDy^IkrYJy*ގ~9_a!܀ZqJ5>θ:}os庵|\%sВT\@n\E$3|`kO v&N2tgn6| d}}^88 uqǹSzޟu8Ǜ8ĺMmvMκ߹^w7B4NL. Jrq!Wn q@~c:~ou\sA;[X}'N-b}vXՋ5 ,p GGWvjn>O1wVT׼88qqgx pF >:,9."MVƟ(QFoqpc&]öC4ֵG%ڷlMvTwk2&Mvlt}o CmXl t;6||ap=4be',4;8G۬$*خ0TA%z~ɷ8U1U]88ruqǹx۠ %cS؎s۱mH\uRM[vjڳmJzNs~܃[F\M:P7zR>vNߍc.}Ϙg[~&kV BJc[-Dʘǟ/ O 4+S?eSN#tKP$gQ0n]74oJôhcWGm~\M[VUz> tydy4*.(vEثd^p=j88 qq8r:BløxX#`SVCo0z)fV?Vژ,ߨFsc ma13Zػxz9$$!PpOƙ_DzL'h:mLO:RL V)cڄd ~VFi!d{ccٲ5bج8!|(88 qqqOZ/x;OW żui1 Wl=H}X1)tΡӖ0d=x~^)bbehm=kWйͣn?Prsqqѿqq96-y<]_=~PNxO= ]UMڋLw0*܎6ޔqDt>ۯGɉ|:X6޳ SlsIٕNz888rqq~ Q<G s Cm5{h>bɯ M>]?7{OQ<_~õM=֏]>΀Pm7!- d{<~ tmcbtS(?ToWQPf髉s۳88M"uqUq.M^rwģ9~{v=7'Ӑû|UWcGF'>~kwtl Ỿ[KtK%X:(!:  nKގΙMG9}W IoR߇ɗ:8r-k2q0m.'z<.vݷqb\g'?2=87yoMpYj8_V!3N`>)]ׯ̅úӖMpn3[7%oB>7Z<ubwO׳߹qqA98 xtf7:{'dq=ܔuqlE B"JhQbNVbֽk%DQ* r].S6:ZևKkj`Gz̉͵)d7kЊ6tcYMKL{,B=%Y{[oeha+t,[W:jI(8֙<S@-> ԧ--fSlu8N3&kOmqO+M }fMgu i1##,)$>Gq^W~)Jsdk^#;͉kZIՌhY,T)bMl\C3gy۱88mߴqq~C(=KCD] ifW+Vlt[[;ꀑrkAuI6!HcNcl6ߺtsr8O3p)Gq^Y_D1X܆h/1ҟcA1K8ؼ-DԜJh+\dJ)oxR˴_i^QP?8V).f QGP Hc%$ռ~t?NӸ@j"& :\ :SaoA?a` qi3-a-{s@ؠvCIEF~q.\1P LSنys)D@̇^V08887srqWbm]~XE uljjY8Վ>%VxmuOٗ4!ac:=׃Vu 8W3u9ɴ0hv!;~7AEϥ\I3f;ȃguLg*<ܕz= z;v^ƾ(wYWSߔ3c􌣣⨟㓜4e|/%[ UA"21δvn6r N8~&j+E찶HpҁqNvedD,VB,e_#YijCZZPw}Ϩ#,2pqո#}z]60/!t%Xck11+Z28$[E-\I!vi% %1cVzK|i Bb}Էe^@qqǹ17QqqG3Y=tz!nW~վ0Jtzk:>[RiF[h4 Bstߵ]bpnJ0v'^ ֧ΓƏ(iݦ$Dp^?Wϛ+AD+:.>eueg:z9.t s]"ɩ&ID<b5M :},8 qѼ;SݫTqqq;88sŵ.yif;)kmo d(es8\𹉳5ò612$o)wLUsmd|{qqqqLZo=CΩp0Έgփ&MQINZ]]gVѼY'zK8o$m]70ISJ\S1':yrAu]cS9W9cY8889888[kZk4nQi(Pf)wMlw~yz\'zz|nw>?:n6f0DDu# c6KC.g&r8887S88>¹K+N7;пYv_sqq;qq lyI ~ )9i꫏цC*zrjKlax[xonPw!ҬNM_.ZE m͛S[2f %4;;I?Kٟl+4eއ%k14EVb_k֧ *C(wZ]?=H9D'=ӇMk-\M{%M#yoŘc좦L42QUΐs#-Ѽu R$dV;U}7X +?a> 5l+A핸/u랼+njMk(<1\C-X {C| 5?qqi88cN]>E8f9鰗P5<ކ!,uB=7UfXJXuko;q:I$pL}h. oJqX0MeMBٝ5{-~G?W\St,3)%sd["Liu"<X m:-Q[}oEk28/Ʀ~ _`qq~ e988gUoK;!Z-VΘN/Ԝ` %Ω̉7(3՝:/%D:Vck\Yl@9xnKH!:wZ>֎Ω6; Ns-.+x"cYۺcylӦubR?C Ao16Ki7}s%uqyw9888ޚzcś AyܲCLL80grC,ɮxMc7q :I!|R; OoBϔǨFjjc(y-ͦ Msd g53$c%LD.kd١So3`ZS[_,|;8;rqq>q>1`<|vhsAShᐤIy:i{M"8CMnF~60ùss7rZpͨ$C٦(l,$ǦYyiz!k)ld1(H8wb"O~.!6cbVg~ZQWvЏO{!ot^Po$88vl-qqg!wq ܞh-^oe~c 1=y!Tlfnc;YM  3 Ј^w՚ꭰ˳yShzXn+Yγzk;6($Y̢1j*!1VֻCs/?׿G| R ٗ=A)tW%nZ>Fj)0g*h ,dal5Ty%lLxz-@G;6ޮvGn-ݏqquqqvHPX{P/"]-ל%]ھ Zt[azy記!_1 `zH{!dΨttHfSvfRH&{Vt7nW71z[Fvboe69xsLUԱ>+wŖlycM苸$\Љb{:5T$k i!hʪź)śRoK\ w7|A37 Y2~L怡f,=JRR k |U\']b i0"6A攴V<#28l`a3p[X;k] 69؄5YdPkgUC 6[656Y)]Q}Ͼ IgofY88V88ίTw5cs(iX9 mH*m/oUXI4d0 BmkyIL`r"4} X؎)VJN+t/UPK:Zy C p|2gtGlo,6Dy:n\JZʬU!8GqZ$*_w~{Dk{@ED3{ً1I*$ ˔Q],o"aB(uO\#30/唵 ^ 0s\hk[ eُe{Lљx`:YNdt~-A~b4$j}LĹ;؈.$>/Ty:F%'Žp{1γ̓},,}Ib6b>G[- ȱm.5IߵqjݺP2l:%:FV۲\rFXJ'sMZfaI'O[{Wa<"me4Oh7Pdl@A6QQ01[c[TUB6fHAa1KVĖ:>[iTҖ,0t獅̲oNVNЇyK+qր̬$=|`")H6cbFiG)9\s^qqrqqxFdSY=&o7D9: q^?/-2 |Z DZr7 Ҏva[`k4id<5IIER`^9z˿E?`~7xӌQ҈KLR&?9: 䅆6pN<;kѽ\p&Gq\-]ΠF].+`فJu6MΰBYK` 6R=ZB0Rw W14 DNA,5N6op1|h3n۠bs>k1${d7KX v#B FL0Ѥ88tqq0E6vdޮJoæQ_NT,̣x^m _)kk]S)YZgM#`wm28`_5n2͇50fފ/ql< ~H(w!2FFRkJ &pd @E*!,. G? OLdyKj$ sHGtLD3t!i /P#4;yFP-{ iP?8"myk&# .1Ǚg ٩:wb;mM2js8w6ۈÇ88܆kqqq6g!>o(r8a;X;TBT )ĪS;HbO6+2v=#iZ:*HKJ Th+AҲ*Cb+3=wR| p46:vYe:x,1}d؜2Hf*V x2Y?:@o%Ki?sdۇo^&tdr! sWI:T@E35K"֦2.ΙylXɼ+ ZY88Rp88YtT3̬=eT%0=J EGT8CNw݃#4Uc7_:zkn%l_wR 19RbQԚp1CJ¼sX.tYOևw/ߍ%Ǐ ѓoP}IuҪ1K'F/~B)/_ I^=KiCM.P#\cc4GIeJߩ>Lt٠ r.[cke4w4` N"ؒЅĨ]ިԇEgC| a}>m>VZzY[ks1Wzbf١xHq &yS1oSs^$DMvtMUIA,tj%JxKaX5@k]ΰ2+0Ks̋1># 4,4 WKLN^ [/ {2)g+ /~}/;s :|1S:,1>@G3#m6}T˜x:gl0|׊[8or[/:hF{Hw$doNr v%%P(?':2^קpdOwl׵Zqsm]ow5Zqq_;qqo;}wܜh!UAm]C!<$Ψ.i%O ֺÁ+4@Te4G;FzxJ)TycHb=s|8v׋.t[¾%PR!gVJ6Ǩ(&$Ydlt|sp!TIGN>ޯN2JV~ )fX&#15\SHHSd篐o1z#L%qYบb~y<+㟀`1`!ݹ[ 6[}LRps(mCKe+Q>u&75kQ-#)k$4sno[Guidqԩso#=FaMׄRɭv&qqh,sqq"_-88?4vcHW>8|n2Cn-cmK+|/!H2ǹQ>#1m2h#Y::Xމh~BZg2ۭ!K-ѕh}e% uBtƭVu 櫫Z޺${YeZZϵ&(Zʐ*a"ɷA6zYЗ"M7 .Aʄ *$Xl㳸G9kQ!~9 Z(1}Gw U;A|P<ȥ.K(?qdn0G~UgnoA\F''ߺzLIϼƵ-u'ĄKiԲ΁hg HۥBW0v(t&鼪U3T:up5|"r찋33Ps`Y74d:i9!ۛ{?Oh I1N 7 qJ&{^& _' Bf5eQ,ӦHfbU4yз3ٍ-: [1/1]}gR$@ⷾ sl?u8#J !̅uM6JlbXv[l`GY6,;1d`fGv ΢Nw;88rqDZC zTVɥ%r QT,MP6|ïf4c- A i Tt|Ο-jtMQ'RXȜd2OtHʝGH>/{ C:tG{tr|/sZenk'K@mEK6j:uXwU1-*2c1GK;Ǻ*7Cu%F'?Kx99z&b / Qz+$15n+{/#ri9®3spV|<RUW!Y~4ow @{32\Q4#k+Ջoe3fb%u 8`j>61M J6hCj3lmVz˰p)XS Վr&Wj}0ePUM.beshߊe$zNm־Qlh%AS88w88 _;LJ+_Znq_/K6 +vb[)ctp(hxKH{lحPs4*x lO;滩2/Z uogƫG8C],p4 '!NFG\+dOoQNRMHxa-.:cP ۱%Fhqq;B9|vX|_#I#{Fzޮ-F0/8^Lz(RTY<aafR֪=Fi#c(S5򓟑~5\ToII A:ziV= )8~rul?W19c G^,qqqqywn{c- ٧ze-ftS!xx cíhz2HEtd;qv@r :_᛹֠DjHiضhfaCZC)ugHD(w0 Sm188|BJqq}mSX]K,AO|ܦĜA!!^fj4Hs_=Ҏ {߄);5StchJ%2=QTM#Ѥ((To._n+ݔUnF77 T!_o<#ɋiJl ?|[E^dtdTʴMSBSt9F8K}ѽTtމغ =q룓G|\]툭bp4:Hb*{Uk(snƷt8C-Z t'd*4-H1 R»X$/_ j.IC#cbm\T=x%? l tpfI#2Ҥv gVgM[߶pU`=!g'f(gmxş[7_Z5_r3*0}Twlt88p6qq~[W+fp܍fj>~D7Hd%k7tZu bc/^6)ۅaacaz*>e=K x{넞 ȑC~u:Vޠ @Xg!KnO e-C;X<X>|:&Z4T%p8p ) PeD&n>f{OQI{_b1C%rmB/6v+{{?/el}?:ߖ5Aj@Eț^vIBs#&WsYYl)-lg>9砇&픾;S\'Q=27VH24UDLk`$s%ʥ2-DzWI}_Qg$mzSJ#g͡⓾&*F6|ҥ&9#Qk1DbFX܄ 4ֈ3e8$ª}-@cB'% jfM!k[kFPC^.Xs*=88y?IՒ88.!iԲ@VYf11a.M/v3mFaϤ(/T%&8X3˙K/˳6XV;0C0loENv̓= 'kGUs_!?D.Uof8%xCg ˬJ b[aJ: 7b]7p!sM2vi#w9!N>feXK?_WZu杚asj쓪l:7qq +vqqH6}(nzHsJhvY9K}diH'7uX}pͫ0{f_Z.PK,Su c7Tg?\橕IE}C:/#9x2ߑ_vQAC5%X"z#IT>A-ehҝC7ȁqm*5ț9槯PXol-NTv{cYi}7')` f ǥc9zV ,c6&;#l-fehT6I+{ڳ:8&fjY)UYeM:wԬW坉6e۱u3u[Sq tsqg9s88\ qqy/|샼_-w|lyP΀HRGyVJ4ŲP=|lm2_%;c>g[gJ!{"qR~78+vyŜHܶ,KL<΋0z#W(>nضW7FRW"]W`q"KS)ݭbZC&D4졛^<{ꃇƇR2`g-MߠxZg7)6MSFб9ͣϑ9*K |Z`g1?a:r-exn8x,v"(sآ1N19 y!]]`]9ޏLReSke}d-CB,C=RrqH88|8ԎDQ|L:g}2#d$ɊjO<[eM( l ŔFF/Cqvsf 4LC%vx#wLX6u:r|cwV[%ͥ0mХ.vݻWB.} av RlX1-4nL#Ea$?WGN;ݷ+h%X!RRPvsJ7lv:ئ.ќ+`{+ z5-&mNߦE)qq病;qq~9Gw}>l&o90b/!)w$|xM:X?;կ& "xe<:/| 9dDt.`Ѝ/]/pp[SR]/О=C}vq kk=mc#jH8sd{o,tHGhwHE%m=7kMOEzĜSЯ8ČWHNFrce1f#卹h%9(c$/z-bd,c:j$tڕK$z? w]b穬}10ڳo"(H_ ]#2Id$\Me`?1 !5_ύ}wIi88j88G6<`2m|Q=>AR{}pT<_YaD1F(G'ikm$Qժ.: ёZƦ뭌Pz9 /~ DM8b!GHje*:TzDa vK=P|Pb /~Nyq[R؛,Et"H;;L;E$qu^ʘ|,FtEl̟ٙco.穬>qdž[.{ӟ1*O1X裞X? 9Z6 C$|y\$[/#k?M&;88v888=7:."މrs4<-NMr %P&0<&YjçhF;Z"$^?p5o G j> Qz݉4KS`zDZb(ni- OcޕcOdjD ,I 6c}4P<dG;@%}2_Lp1${$ M.\$?x'Bl(-:ό;)ֿ [+wW , J(ӉIGaj>iS.e/}7U2g|7ËC+G9.~E@.ֲf8qKJDIlVRJ'koƇY 5aۭ2qqv7tqqbA>e7 g6I<>%:N `WhZB֋bkէS1MPP=B1@tv9F3$TхGqkVi4wu|8T|ג(t|4Of4]xQ'-rY'j>9;bz]BPk ?kۊtg*];88uqq>Akb7b I_7K`q|(ըcLZ`LO[2l.P_&5 >>o"6`W#*Ro99&9x (Q#ȜHVJIPܑ,NPԬ˴@={v&(EY*4aM9$ >a|㽍M88m88ί1ٻ/ɇc}_eÇ}qAOW{#K6%G!y|FFY4+E6홱lЛD!Kx*uNʺ.-fp(Mr9;)U =o{88ί/Y={2sijM 9B=UVA]~]6c!wcu,tcy%HT6W;/uۢ*&EpdT+Տ[8l'#+C%'0z{,$/ʹ=ELRǯb6aPo&iq8,r)$H>V?":xgqu~;SAV=|c򍷰zfq"EWjvPlTJU}`,fYXd#,s:&Bb:Yhԍ^5.^!/ed'jlGs-v䲞c[w$R P\M_ʞ@TR%2 U:89|^Z˶ct{m@s#x}UKڳaDQQ 2=w;1ıu.{4m~u!Jomc5"C [~WKXf1퉶]kqq:Ւ88Nh+I0u){*I(_liꍺ<(Pg) =#K3Ȅ>4aXDT<4X$m=:D a=-HrCyTQ:s4ӆ'QOdO#6"+K"5x du'ͥ'g)Fyk5zPyʟIuN?:W/+&➱--cQ43":9ا;5&ؽf  UFEmqk$p/j6Q h 1OYIڅ5߄uz#N4F = ؊W׽qE'fkBTXa(ҌQ2Gm% B_+ CH6zEF)ۯTCXZJ u(Z`-4ݕdUv+v:8qq~qR =!"C˕|U+èiq]bG7-*.3/xyH @EthyhIo6Mh]WΛS|yVl ͑-,tXQNCl= H;<#cf2K|,mF(]$@ZJ[;L_ þ8wq,|$co,})&z&ݗZ7`jw L,AvA$GCH\S`<ϰߞjĦDOb^/8</Ynڞp&ycZ}/ 7}yӌ! D͸19}1(YHR agbl6u{`]lQƊtsCuԱ[3sC~j&BC\jSskX7M\Vdޒw88㬳88s3J2[=zm;%b37X:ڇ%;+E݁v Q Cp u\3rDi@<^>Hr7uJ9諯Q#(f^.~tc؜%,Uz#H*mE1pzCHo'Y#N cb}Zotk"o\L8!_\u:J*`H2Yfҽ#t K&`VZopà]BtR1HXqt#eh+Ll(g2::J2FgL2&KhC?כOsmN9'\l\}/wt>W:cvR%mf_ao; j}`]}tx&mӿ \ G>ێ88v{88Z<@_ ǀiWQ6VGPVN' 7R/=?:y2UYd}O`Fޔ}E᮸S%Ş"̇մR RtQ魩Qꧾ E`: B2Oa$G,vH ,cd)T(jJ47THSsh Bt-:P)x!"G;AQ6%9Tv& (u,w.EO=e8V9t22 z)dVl_jeΦHz2o3^D=@"v=7 Cb~VjtSǂ_J88ڈ2988(62_f(6l }gp:\?D_ujM?]zEig0< d,rb> 8>c4gzK2a58f83%c KĠӮm)o\\軥wW3$;4 : VҴUT=EwZ1zvśW*ƶMPp*QikDo% ːxgh%fZ_@MQ"˷j9Ej.dQʜ޵^SVM8}#뗪Ս:m.My{A888/|qq\~4K7^5ٷV&ζOc0|&x9)%%0;}LϤ6L2 %vH\zH'RC^`BV"K:vv"GI:Xa.Izr,LJHŞ5y h6Ǜ0Y}cL!tNVILtN}:a쳚>}f i5s#̹:(%OG˸q$I1{!Qmjbp]cKMcGiJ/G={q* ƴcl?) 1|zY}w&]?.Ve88;88p0i+џ CJM2x2;$\ʭ7H/ <$a}'&iVԈ e_mao]jG v8u3TBgU78'* Ҿ L ~\TiL̅ܫ36M'T}K>z0Xl$cc?4}YF'T$Hս45z2_)?J9:cxL0,nD~Dϑו>p.Ziv"6E{-'. X;m=q/sE VƸ}eb8Ke|wX&ll%m`Nq|i"{IBDUt3CV-Ӓ(o(6q, Aef]0ruMy+㛣|u\F?"ghIa.>~988 Ksqq[}-P'2c d٣JGᮎ Sg\PeB㺾|̬ہ~h61.:~dn<>D5oo~"bb;/1 2LjY g'ma^D0Jq>:gI[ ~NP?}b$vʺ*8}TL؝NثO0ng?oAhoZwS462ðeEn۴6e]wqqޕM988VG{/7P79f:Nd8B;7gPzE$f|TE/ 7c¹2`t.R8zHEuS|g,TK'vc%{_71$-] 7b\E0tіZ'X怳I{[Yt}I'6DŒƏGR&iC]R廦.P]ޓ:iܞY[:dx#3%m"3v~`MN =iwl.@&RH߄.qE;$wwt9P!:U,-.3ҪVaGNb(vyk2R/dVN!۹Ԝ mɴB:\%220T:aebSJY92w6g\.Pyzv.jd9gTVXB~&m}ļ+4#k# |kE%-p\|m96GkvCj}Lq888۫88GzPzw|3d=tF@gT<04R'w!|hjIπ=tA(v_`^OBlI[ʖ"r@-D,eDNubR!7lsdGm$fDC+Ec݄(Lt@xi-htJG)msHe>Bwd,1۲ZIG٢D~>GVR0:,: s+V׾Ɯ;#dؕr˔/JoBߚnU%nO3-VΔL!;B~2jg _b[Tw3R=N'D\397ԡ.%ЏYDHY%\qqqq[íx8[|xLCy";k8WoLz$ ǖ.e}д4(0} |)qk&E:~brQ2h}U N#cM)MsNLN61SSR( w g^ i=Ns3y㨿"NuIyN|ݫT@&HK0{>P1>/Gd3*,^arvb1>^Ah} d=EKdN!d)]Y#,GFI%,^ֿ θ\5>2L88&88Dxίm^l-O(t;}QNJgC~.5򛦅MX-I;:bܗnӳE,:d)X&m:,ÂLy+!˜+pOݪp$ f#oЌE9 GWb@XoAbJL9jD˓;X=LKdDw*#Ğc{IfH#2Gg.LLEE[ZJGXHMʰ+nfb4#ٳqp 3su\dꌔ>?=C 9<;@vxW*/JŘv"u_F9n+st?j<ͰsI.j;m K{}ăRlޱG_οw`_pԖB.swm1L ش\Ylw]L tu͖ 6۵ن888 tqr3!$_#-9 Sx`JI_ B t IK.tW6լw Ēv2+  < AKaW޷bi":.jp QG7ZҸ &UP#S/zu`[eC`$2-51;|P歜).4jj1MQX & I!F:(¯w2}^ "*6R}gQ)ghg mi&q]-P{ Z@X g+)i#IږҜd(kɼ#%/p.c)aEA|Xob$y҈z<eu(Lb:| SCeۛwhHY)>dHgHd r:djQԮPIt$5ԛhR#hdy;F$4"eS/('/6n峿~g3fz9`u*ycM_MKJK55YsҪkgz2Tb"E-DTAwXּ1%ſD u .OX E[|Q}̳+WB\grUa9~^!K:'qlX'ʲCݡl0.rFv$źxs1in+ǽer\K0 ,AdPaYtƛFoڗByI2TDb-q`;)XK9iePNXIވv ԠqqW]88㬣Hˠ[Y<[eàm=%l7]MS-dyZQ%Tnhss,k= Z>oן!ZKHXcă˨%[%Zi/ꤲʄelN-\~'_}> htV8{|wX0*h_;Y:jaثػxO՗CGGۈ@6_y3B[P\Q`OW\S2pʘenvZPKGdW0B4{vJfKRҟ}nKXe[in&' O|GDgHo0b\o 0ޢZEk l$fAZJsٳx;O7NBpMCt~/_aƯIs.SYa(E/XDuz+6qtHՑ]&&NU >k=ޯ&c׸.f\qac m0c؎3/I'?98888Na_>x6 'gOmmAM]Uvknr;U%Dlj\?hyp'A #u_^)MI6={bWXR49})ohGᰛs8xD&:ƒ!vNGҚNT ~XnU3c)G[T!Hśc9\ɤiy.+ML,p_E$>ΐ.wNC#NG2Yxq/EUڌ'\k,ޘ6PKmr53XUqL_YBt!m!U') }s4e0*S9}̰x /RrH%oN%1tIg6mKfr3ܕjsGI. :tBpk\N^g]mLqqnwq%xma!M?7Ȼ^~B]ȜC1 ԑ~8{Te͆/. imU>5b\v4P%sF}Z*&6jdvr!b[CÉC", >1j S$_K y1A1tb;o.ɘl)W=Psd)F%3O攦Cd ITM<$NqQI/vp8Et $^"??8CRNpx@:D%5|ׂ*W -f'c`t .p\Tjad%+|Iǡ6_~>6|:[ V9!M:;888\CX?妷: jG[͇̓Vv7*Ĝ lFJo4SG?˳qjNk#|Y2IqSOz'41ˉz\b٠BJ}=^W@f itJIF˥"1uI `z: <m)6GI|"-#&*)_('D>؞d2fA!Q 6KнpMs$Xr>QJ Nm9y \0'!5-:w)OЎD@(H{h7ӤZ|O2osEwK:$&EEs u݆8&rJlcs;qq#I88܀͸}x~'f7긱HC 1 GG=82Jj%'=1H: L N1Ojj{T`ҍ21} mX8,C>2!ֈn:)F2Q:}9lDQq oLϤәiEd2M|W%oRޡy.1i)b㉁v[͍mXkAl[ M/>Մi‹]\CQ3dў:GhJ<칚m^kϵV:<Â{#KF5c7"?;CV!D/?gV?2O:.ue:qzTbq*chEqqq?=IDATqqǹ)-uǂJcv> aN|ז3f^ei=jd.ӗin^ӷi9pxLҧ l3BU9ot 65Uփ59nbu#=%p^bsi9rLue88F29@e^D^0Wk<ܿ.1iնD;J6 sY|mªBɅ{Tگ] N^)j+<$v`eF֋Yjَ{ie6¬S${G&uL1&fhs7^3Vs8OlokC(*lL&oi-0e f}2T/G7wZ,jVg8F]mR-dU= S Yy2>NƦVU&!{=DSdR7o+ڳK ѐJl1͛HbjXr>G)u G(ݢ]343$Q}ؙaUle tIɗvӇİ>!:Z國 $^O[I1?cvo#ɟr}DU3?!}'$h~d~ͩd QGYf2 {9g)kű'=M3yWMdz gTo{ LPls&fhZDA6F?'XEEN-U a9ð!?GUNָC2|FJɋ8&E_G5Z|}&|FB^'5XnЇ$W%ՖJz C1-52^ q~HiΣ}=VIqqj88sSxBޞvkCMCx7~=b!ve 9{`#Pufktx`6@qH4HT/ؼ?jXl^ @+::j蘚Hģ^]g?a% _)ec:A!'OÈzL7-}.VAe~b8mϹtRJGdK:SJ( ڐ yK`v\撎3:eQ*~kuH4RΪŲ ΰ ,c7zf+dkwh^bx ag7GZjqcB>j1uh,dyƏظ;d'DZ>Dww&^汳Y7W/N7oM+:nuCye=tr)A\888 rqq~ƻ2>4WIH򕤍:ڡ˟D4G<JYɃ/,vP:jZu 䵗+\:V\1$)iE~T/P>G.Qu2ٽȏc&|^f\9 [7ײƄΨLaɸ.Jl3=n8IgI% g .{уac4U2R*0]LF'/]HhoٗI ˤ\z2PK4R=malpͶ΍ԠC>VJ8{%rmr!7IQVK|z/U[BdtqqwN98|z]ukyS7N: mʛTK%[d/zǓoɗ$Fk,F{zȪkm)c ΫaـuDZdӤ dWXN62E7.O> R6K T\ύ9Y[!od^Jj!q"筩T?B̤SZhρSEG!%Py~̬-{G_"?~SNvQ=W8Z3$?#9{)_"GE׫lMކmW5bywv >CF99D;E%=PЍ"@22$:4ISCcF,1j/s?'?[:J:\B{{[d4`O4؜7ņ9V7NUZwJTHMJkdscY8: ҍ'y[jdc,w`Il«ls4oPyd6EZ.8ho r؞`ގn3(&X79"ۿm 41PϿE3ugIszΛu[>8`:?Fѻ#Dف'E\M|&;88#U88:GǙO琓ebMfkPks5n\POʏ7!${G7]P d%&{t uN'U/AFK퓵T8)0p19@U4o^=?cY(:nLhHFy+k\Vvw0~*FaQbi9W2Qeh~Fg\|'jj>~=gԦ?788ίM6888xDSƘ /6bHlW9/o1lx;7lukoI!꺑>=I˞\1}A-22|M\gz4>YqIX?$R (k>v7N*wBMR |5;L샨't6O&&{tm C5Dt˜cF'udLMIC DA)p x=pz& iT#RTYrdd:uxoN3JCKi<L{֔ÒK) z+dh&h?@5N6Fr #OϬRnۚ6J MI1c#ĺcW-ssqXlR&[g ph\7M{6\F=9zvz%^{y{ӏ޼¤iP$2C+ ͈3`AJļfwCchQk ymaݞcn-Hߤ527M \%⑔j*oߟ88/vtqq"(,J> !|HGzє;c5;(T=T,֙;t2%"uFx@.=CN&l ;oZ/^ җqıXچ!8:tc0raEX ݌Eux"ؤrGK[5ϯF+ac7:,D{6EFiAZ3uK9TכDky>U:rE//JeR0խҠ8v:=0K7B%=aay(dFWf-9` ko97|S{}NˆXs%OQJ Ɠ}u]QVH3:Oj~dTs%6RDt|M *s eboNI]ߔH^?C__Q$bGB'=[Qح#K1Q2SL0y"P>xE'K D|o˟0xI=HW>Lf9QbўPb j]FSI娒.ZO| 2U-B}WH Y`5kje&i\I籃{㰝F䣬;WDz`ޱcyyC&c YLmN*֩QlaB|qdҵc"1&f/l2˴f%.[ ĸ6ֆսcek2 Dzul SUPv9^SCy?2̭ܜ k(\;8zp88AʁT8dK(A"&5: 㑠aԭ+ws(*i-Ԟr,N)&C>~9>>e|]r9t^88,}{ԣM\_bMJ;&5oO3+8POtm$]/ΘcX,{+ho>*c;R'J)ɊF.jV3#椿*Ghl$)MEGޠ#Ng(;Ʋ\;|'"rM SdKj6b>{&c`<92/0?F\.Oe"R!}Y~hcK`V5bJʘ?Υ}~ߢyxW%?m^n2?tڌkL1ƶt^ʳv5E-㟶{W1%kue3i7Ķr?c<{"ԉ,o{qF,c$64u$-j{+,{МgVX'UB@K QǰMu[YʇTX4H_XX辐"EDi-J2oU ,f&2;s0kK < :T_/ۙ6kBl? 6]XF=+iŰ`MVYwq)qq ă=96C*F1As4c1x)tE朲9;>fSGb2ЎDT#eFJ_]}/Ԯ= PG6$qYP^wU ׎s ѫf9=Gn؍A>P0ໟJ˂CQ|LܸȐWޜf3 ͖H$W8EHڑ|PbA8!N*̚R3FQ$zkh9"84- 5 :%o("U2NO(Ij asYCn\R:Ϝ'M6{: 4GYcy who4N9o?$|1*GN}YSAo(ETtyW=i62Vy^پA-6Vm)=Ss$S%g :4(yF{O U#D(2 xW3-Yʘa)*aeN1YN1b>. [3:N@pF8ʼ>=3o"͉J $ B?lRPHӉf]`2ˢKRy';3:VwWM'xӌc#Jz~@D??<32T&+[u~azsԹHީ8?1MmXyVǦ88C988sk>xw (0=}.?L`JЙGy]Nٍ>R;H- ͋XA'&vXb'_c),*"1ח܌P,M1jJ 9 5ŃߪyR`zo{#{O1-v1hF}V#C/F0eG2'w^^iDr sh霚OttN53G]19m榫۶{mv|VcqqZ88sGЎGW<\PbzVy= 7MorL2I㲶aĽ)ބTwDpO>8}[$|YM2vCJ8!2t6t0_1/pqHdFM c,d.#"6x?:2#Ke-F{h=YS}sd=Ƨ'h|-0n精|gS:mPtOkOU6ÒǑcIu+c{䢾L2ônS껸?<.di?c,uWֱj[sэ5۰mꌓo[Cqq=88"wlu2FIrO=M|ވe*#:S5'7Ғߧ@] ?B{DW37fJB͛Yac_oIVo uN9h*_Κc#1*Ix:C}{_٣x8q/TlceNFڴcP.PtPΝD2oY!a~YdO%Ûj2bUJ)2"1ZNv{HblV doר2Z_IwPܙU)eWUxËCydߤe~2#{dN8n5_ kԥ:ϴX2qLv)8 %Mz3Ia|(h-Hl?wg|lo=FMy;.YqqJٿZqqljDG(Su"Hr}GdvЮSW愸܎DTޤmh$ŴŦCK(ǣߠC=DAOaglп21 4꘺zWuRƒQ64(oX^S1k4Τ :}łP?T6bVogEG{Ƭ?^is*u5toW# K:Q*l 廦(NVn`kpqre%}wwhfln a N ܣPS*C\aV́Jg`iJtрG(Hs:D؞@9[+7x~5VC,߸% 3L>3w)vVI"ʢ)u^%80=͓o~ p5PdyV؝aȟ ?c@!eDRސ2\pm9]i1QUǏJ)\%Ys3Q5YShvFk26Yddߐ{ƭ--4AƟ'֭Ay}؆05X2,5 =նV3aƈ́+߄ȨF$\D M=+kMV]!\&ehz-djo9lCv+Dau{2V1'֯#?`&miqqgr88΀sJϦ6Q)BSTJ]AWCUfIk^A6%İr}St\ "eyӡeð R꩞Uxl002c>irQ=K)=21|__(̮@LXylGC]Q<S=#:yX&6oj4~YrC@L 2/|P&,-T|Lh_Bx\lJeU"/D$ ^jYv!*0/= [X%h_Y/NvnH(ݺ2ou+G{>!I 4bsE1]wcd򝦕_I=vj;עqRbß1}F6 rm)_~R>vp⿡ꟁߠٽ'cQL)8ُ~O?Iw\DF[laP _f10xSz+i\g,+$=eO<-үHδCٵyw8_j]gtjPo7O!*B$9fؾo:Ykz| vz6*4.GL~ptbE1@В~^}0W۪3[%K iMz؆JGը\AH+B6_*{<U888sqqgo3)mJFO{ôaADk"樠f%PFkBΘCe.됚|Va#w~ݞͨCPZ[ Vn/aY,}LKSbidw8@^&Qg4h]_ b]A'f!vY.7xÆHP9$/MxK|”>p(vm|_5@3=(E"E*U6D tLM tzH'T < ߻|dإߓ&inoJQ65l=d4C2Mb~h_`{Q 9M+υ2Eo0?|7+➗N /Po1t|G'b0jAjжLܹzɈ9uzTBT)bD dOvOE/c)6b9o~?"xI5CZ SuIJ|Pw3C} 8W'h>jpj:Y[, Nf#"K؜h̀8Fu}IKa,cA/?THisKYXoXې~H>d;X\Rqqˎ88έ%5}~cMWi~=9aL;Y'qڎ)"* Կ'@,oJpO#YɜұFY{`,87;ޫk.f)C^(bk;7G&%i|h<;4ǿ"?-P%jLr.Swy-oG9%MkLP"+V"MFQF_ + P/}r+_=/X0< @(ks,>s%et;0&L߽%m+jgʽ@JOTiKv9XоyGQ-eXK:G:܏衭Ɋs\C_̻lR(wG-:8888scxxXw;ssF?Ķ6;>k=xC4׊ voJg4'͠""E,/ K!P( |3Hr|1AWM ,N֟Tӹ$sh{aNp1>KO } Cf/ IϤ%JҮ3\-T9Ί{E\Bby)-%Uǩ['|s?x3Q֒wbu;Ԝ?=m<79;`A1:vD0ilgsJ,leZ[Ta_{_p^rHslݚ6nK4§F\88Χ?qqgNʃxM*Ħ7K2D(wY^4bz(\!5C֨Ka冏+cGI̴~,gD,2ւ>HnPh z7f5<&b~۸%V8vA *˜f0_SU'aFo4@!l;!Z>2m`t v'z| c^}vsiNtE( Fj[}SG-K\JIC¿ztzRM>BOppG=S#7αUg$i#O+,G=w#?:'XdFbstM|WK[|g{a||{Od)3Y mFD:{QZ=E1/}>f -\GuRwyGQr]`\K::&ܙPB+惜p09)lߤ[ ,q$\˿G4Gd&z!c9Niy!}=SR)Yi. 3*]Eg-:[,ZWVmft.ñ {M}Lωi6`5vuPsΟn%۩Ah[%7Aplq,ukV.{/GL/!XӷX R&aPB- qqI)qq5V7;6A1=Tf^wm[: Xd֏ !O$־4RX\eZ*;n+sU~V3D;.c<,]EY*`v1}4< 3Quzh],дU+AVf[%}5Wvqi@Xt긭Ĉb obQ؂sܢ|H옳 qI0*^`zR/?-!vai懘AoH5/C")f$ɑzDgYS嵫Bl⻴JRCJsU2FS 9F9fުôP5%s&XcqXH(w`!:W8.;-Ŏ P<mFfG@A :+._gu;p.%"#S/ ec)dʦP滘=DDNr6_ΐ]'v) KXd0{I7@ۃ ~D]7?/e,c9K?CSa>./2Q9 Ys]LRmׯz6g }ZX0}?6_yڄR|s:؋E[p,/MHbMbE.fJhA߶K$qq!S88[XFP툱x8೤:u^}Z_!@{T*hƪT3|?Ѿ b'*ȟ#ILۥ $cmUUG mTKlϞIc=YIh3Y:zVr) (114vڨ# ƱM,XQ9*!VUvF=sJ]wOS&Λv[G&XOE._pw9ٚ k x#:j3Kc &\O;88C988svJ^6<2o+9/T Ej^뺲tUFC@$ٕMZks}/ Xx=A"9(cFAz| 8>%,Qh0M끦ġgp@XSMՆr#}yci:b]ϰ10__*eCl,Qa'zNH׈d=9'oW r[3z9֗)х̲5U~$I\LQ/0iKmgIN_'z%lE8$>&v$aL+MX[R[e|F}O={C ;o~½r#QUѭ%]܋ !+cM2;`%p3GG~@\BXbl(LSNH:̄=Is{(=D]pBTI%a95F !OjQ-z;J&vA uZoXigowpTܜ̰4#֒5 5y^Ș؎k^)miU}R2`cJbYJ b?qn;rQz+eYԷW +eJ/ٚDTHlaM߶ *KBQqqqqǹ)|}& ({[d> VXW:ff}|svuK#XWf:u<ʩx0C~/T歝5RoBl8ĦGtHQN+}߲nQbE9N)/^u`Yطt e+X}V0eAC|<#L?z7}}7_mNCKF/lg\ƨ2c?D$\}F'>+{7ψWP޴|f?k%I{1u<[ut\ !W"/ i>o .@ `0O-3#ܝ{,<0s35553Lc:_}!'MxAg]5X@^X_yw%+ DuҾyVoD./#/pA&6l8gH)(ځ:bA4Gr;iV"'gtԛ1>hi0)C]//ł?ԁh?<1a935XwM=OBgZO3Vms},k3,z^G8<5w;΢s/I(ZhwmzZ6_2dYo1S]AA  =mC cu&C[$hV+R({ 2Fu^646r^uMuS:Q#^Os>s:n\!e:>]o 'ޙv]{^SI״5*"3.(w$ UʶHGU 5GD+W|^_oj2$vƐЬ%#vZuxb{i^k\#DڣA&Amex^oLx=D~koo+y]˓u-gu/m xc[cC&ӹzF_9ؕ6{ 28\=H5祅2h~_|_+50cKR33\ NMh^v;M59_l;H&{E3G48eFS# sSI^Ozu4SfޞÚl;7fW1  ?t"8AA`/ qՙ m0?M[HyluCIW-)&WΫN>KOD^OFZLnm"K>OtQˊ%XBC|985d}mnQ:fsO͡ǟͅȋ<e㩛W+y~\#ۮ0J :KF'{tN4 +[%nWA!ѯQb=~ﻯDoQ3(;W+/EmB*\W#ZT~<_} ? *肞k-ᦽ=^kVC5-mmn VLray=fWhI%oooe} Zes#j3">^YsfROl<>S!^f );_!Hv֏fgip6垎&}9i۩7lA3eT֛o̮Nl}AADp* `6YSW-=lS+R6纡]sS7(lMzf6P̤̫$}2ej%eXvIRl߮3V^׍֕Bj}&] S]JLJY%ZO'v98E/ּjmfw?XT;vp-j(yּ pv!ُ8AVd k6ODH"s^2ז'u5_4ԬW'΅^mD,9P56Sox=-!1Rfӥޗ~x+C }cD Q?`U+OYV/E~K6Ϡz/EKKĕjUǻz> IƼO-?t3s6TGGc+m5L[nb^=<ĺfRB_#iWgPzASyMݾ7˿Eoe KH2x0]SS6a2bM,`;hۜ]d >~70WyMKa#)/s[K9NحkzʸjN AS;c裾Gݴqeeټ gʠ=N)7Oy)ǥ,O1AA<}.  hW7f+6vv}i GRn(zC)7wG%x n yR : N<}3kؔMH<̔MVt5E~к4V_sGy^p?ҠVm`i׶ɿP 0O55Rn$whmUV7rqZ^+כ. Ũ-1gk9E}-F֐H0u-۪M`nYq]~,G"Na0G@}ڬa8z 0z%(몵\䘾Q:4Xײ\b]=~U[Rxky2@׽`WOߥS:V&u=@{{8Tp GAAp:AA)#rWÔ7x"nH.[aS0TkA(t?5 aY g,=L%{?v\H;GZm.䓟T/䲭-eJ 0IYrgnOR5dSKaH%b⺫.,y'=xXCAu, `55{5;cYՙ#12Xt3LGz`'QTp8xM=]-[m'/ZoaZ'%p ZN60TʚeNOb>eʲ9)`߫ ث-toDwT5=ڔ(IvnAA  ?p`DQsi{v&{XsnE@oMBv Gq=OWZ[:dK|tƽ)xz>έ)I]aYxk"װ&gxz  :zQ]+?}ִ"WoDl}#Պ*@cj% _L?>Gʆ2_SÂKX$ vWS =`8>о3Sphy iuD8mk6e$GURw-Xx?8F2 H{pBd hGZꩼi<-S(@a~I)w{TX5ʴ~mƢeI*1iWۺ.L--fT&iC\c4߳5GǠ=*FVhۙGM#n^B] |c1NtסytͷGo6AAe  } OWlF庙ͼoR3oé^4d@)y0w>ous)-дag6 N_?+:6F'TnBk;; 77i8>(ru|/3fIU |LF̻ZbZtbk__ƨv59#Kf[%Imbyߊ zV%+ᩛ7oяE>oJ+v+OJ7+}_ݷй?~m|ӆUUs5k$j)/y"?y&J[Y]}+~-O(gjs:tc~i5`pj읕¾a`*sdA8mUJ.z.g?sٮH>G%lMrFdNan8=otcAt?EqH_#4).-Zǀ6zDDL甩թT}A),+' WeZAUJS}Δ27`0yUK [Up;jkRt5ssykb[5=,7]OvC{ۺ}jVQgB}JќiXiڐY}k# u5ֳQِ'p1HAA+  86%!eYܬͽT{^GVyMw-kHfP86|ё\1+a}~.gl54)y޵<5ڽy+}cc` z}&3T qLTIX`>6hknb?eg[IU:6p-XcߚzwXg ZkggaX/};Yx)gȶcrWF6^嫯0';8Mc`hݠ)<(c^sl,8Mc64\g>Hwte/(Z_\2v֬\댗AAe  Nbw#eܬ&2iM۱m͹?'>oyt,op ًtoD{ii`z\LWg:4|b 0)Im3R %j`ƿ^ ^-v钏6/~z<Ҟ[5@})o^}'XF1cVc LKu=T｜wqeNmgC^ҜDz07f4Pυ|d$)X S:9sa~  #sAAlo>|}?V?vsv^7jr^7+i{ Tv+ȗy-^}Eܶ:Ҽx)椾G#sG}?3hZ ~ -T"Z)]dB`snW/?Ҟ1J~OY\^h_AcV++Ur:קk&Rc>9 7be:gN/7bzpJ7AAr  fo{wHN-׉ܧ>:7oֲ ƇB|m)u-ǀVn 1~6H^G? Oa>=&}g5n-[n[E>\*  Ϻ޼zʪJMةޞ>ǥ'㸖tՕTVLAN:3ڔ*tߔ-f|4ν{ס s?e_ɟa!ǾL{.  G  ~h8߶+%3޲c$E͗և^)?%Ϝ&\>fqp]Z7gdЅ ;5S*vR WwאȻ"xr yv{f3>{.˟ɶy&mlبZk=";Zf4(^bS Z-?USiR+iOֈ}U^ }TJ52eɟH5Y|#GUNr՗P kw?KDcf{L;ӔB1LNsevx;Ɇ:,g}8 NjAA  `:l2ﺰM ׹},Ɣ(꤮zibX(HPMc[\ҷiScw?N7#~jD{Aoev#";+6fhV]LڋOr~W"]ErIǾ 0TOJ;=,B_tYZyKes}e`*sYn8mo9Ez?潎}5l8N9n+)`H:+BI4Q-5;n ? ;ԣn~6'ov_3oOS}6(Y  ]"8AAp7q0@](D|N<6ƅ'~ Xus;9FIvJ+cTxʏ7=?ŰA=΅m\&n[0^Vλuw"߽1Uج?{.VGKpeJT|F}lý„>n$͗sBc``JLu2UaNj%tOBW, @GjR_~#uw)<ύY 7\a3ؕ '7»UX C /V\eQt^,Sje{v&x?.֝_uJ]o;IRZRP~ P{˂  %~;  Hop~8j4ASI>7-_yƸA1J6"w&۫o/lF^z 򕜯R;=Da4RuYL{0-vb{=4Rc,uSkl J'<8?=d$Y]~D~ Tiki߾ZYa| LIkAI0r]{ N4 .Bs0=gKuv"0^>sɥ}+L~  {"8AAcS|ǖzLmlS4>O5.௉uJdw/{hm_K>giav\jW5n4|̙̦ac6Sal?G4 K@FO=HNh\ZUKX٧5.tT03 K~K9bk ceuBct*@5{ǔyRy L%{hI F>S9㇇^  'SAA'í6n6nxht̑IܛecZ ?$ntBg3|Mx-7`{ҺՊA";W_BS4oN6M%Փsٶԛ^`k~09ޏtW7Kxv ^{xq9.df8j{V yC8+5T ,]mZ/_{nͦײ} J}.02~gNZj]|jὢ1M-ٝ1ǾQ<wMt]ZO=  9ӿ  ;AuwĈ7XDy/yeҪ ͜njOYr ~AmpwMH8_yΞf9Rw؀"ow qɖyJD|5~Wt[܋4\7+YTOI^ɺjk`&nA~tn cu|= KR7|t=/5_UEKz@Y)ROגZS3yrM|{՗XKX6 mai?Ń@}X[ɏq?a7t:5{}N rGOg)ߛ 󜮝=AA O  Nb96쑝]]foxN6wyMF(7Χs2PwS.CbTCF%fby)m?d\oQ}kvƞ-׌~asMΞHS_1ϫ5{iZ* f9/1|Tx']$N}By2ͤ leU]jҮ F`y~kݝh!5eTDHEV < 7mA>sڷz  5  NS=mjerrf_sۻ[[e/7Ӭӭsw+jZwzgoJ/obcڠ]ilܤv%-A^{CI+ǒd136zR?,^֚` O?Bb+dGj2\}xwwq R[ͧTԝO`<,%6G^n~+@3rTPd |M=TK9N3@[y>ޯȧzsV%\7$+ȠAAAAoWqg*IYg 3>v'i6.|شc9Snܤ7^9/QgѡXK܂n"k{`؆bJ-uzH ~U1q[st:js(:-*Fͪ6e?nFm\D67.+BVoߢ/uLzwO>\6z~aaxTv˓h[O9Z֔4EˑΤ^=G9.x: ~ jU-xǤ&hyRzf*~M{]bNV}čӭruPmjH߮|+~#O7r@|gp@n'G"W[M|9 >zCkZ:Vf}ьI}hмt͔8&|ι Tuբo.b'!jLܠהc+jmzv/(m1{N;GOǟ4k{n    ܈Zڌ:rJ7Nrܠc3~M\J6YMJەoʰ}oe+7~|W:,M~m.l#<716-jv1#IxPƵ|H.Ϗ\3lz֪i)˩Pˎcg:>Lvxѷхe: cU,Plx zgjͰ>⯪ds}* |4C~-o`}Mx2sP&Y+R7ߛ=Zbuk q9OE`eu o[M')r|<4q:yaW;-8Yc1G{opY  `VAA)Q;>lPqLu,ۿp]dk.!:P-X}Ԍr4"O'rͶ^< K "|}u]aUOI~7NZ;_C{[%f:vT}dWaKJS cVlh+Uw)]ZN v~3x5va֨3MĵHϧ.'J@ i5& ΈW;,fg.?eOKAAoAAAp 5rsrRne*OJD|-:ĵG5\@ZK\AdKsj'̀~jR/ ,ݿ^Z }`nKv/ 5\{*m; i eOKw,Թ7ꮕ￵"mdw<`aP)d>阖3c LYrc vJ~%t3C|q  A+$  srn1Y-ɳ:;b1S2CNbyrqo07<ÓSyЭM}&SiJ}%-'\jv$:6+ăL}.tZ!)mVk ;]9Ke(r.Gg혰l4\`9KnP95,0dba.|P^<ǜ7)Etx@Vw ,}8 ñs~cX N\f7㮂[ɴ`s#ovۛX Pvǘ<Cnu:0Rjc8AAc/  膱 nN)yEfc6Җv_YL!mLcpJHP+=\|9_oW/@ƩR'  g%wͫyѮb|9>q=Hɰ9 e44 %5o ƅ״C? }'RmXڢ;7"_XeG]ɶ9gO岮-8~ύm/|}XQ3PcxDwW1f袙i|tx"eF́r}yÚkɳ~)/Pʓwz)+ ),ǚb ߊV99XvfZ/C.-5pLvHH ?t>']\X~ƹg#R%}]6e|'PTcEqKَy*̫ /t<L=.4g0lƱ G\AA   >lz/2;\߮Q ik:S1ڱmنv9p'#`}iu#(O[7mc+~ e̖ }\0K(}a[;Z.[9khb…r i.nd_N ]K5J > 4ދzr5&|\WޞҷvK2oe{8LVZΞI[_hq[YC· 5 pop!LZ6?-ҼΗL;Kô4/sx;[}詑 J{m͎^=A,rx2v(?Wvq?xk&rLAA(  #6uYۑ%YonJ9v\!=>*=Q٦׀`yl""lQ+ 1}&qKn22]v3AAIDp*  xTn= ;t. n۞m~3ucZ~;hM?ȭ8v+l//M!˜=kY?yc& Ԡ9XWg5hu4 kGõx{c R,~g7g }ͷr+ҷW:O`'Ƨ}\|FdLe#k#ǂH,.\B}Tf64XUjC3{6=28j: sFC7w; (2l/j} }ž\MGY5^~K#  NAAŰ#WB 5U ^Ɲ~m={}w锄h+o.O[5 sv-h x@}Ƶnnu#L)ų잲˴jټMz!ѥ{wf"o6g9~!~39{YY<<MK%9ޛReK^\ޞ_)= {L4ϡ  X"8AApZuU O,es8 7vYb z(F= RMn>W}zVnOz MkF7^űJ eyݬOhF_Fj}J;s~n R/3KzU-_ utH#ZaB. 6 &:Ӫ 6‹4K6ZǐQ8P,6<FqAZMs;¶\7Sfmk)JYRYShhV^V}T?sj޸`n0)̭5ǵyJںczgOlZo.)7+&iW;4gS1@GȳOM͞L A߰fOF:]>OߴOJi5#b9rI@F;ɏzC>yTdpum+O7_J/Zk^u|e~ϕڕ W=QȮ27S>]׊gL2\{([0uGqʠk`YAxQLeV`G~~c~0 g,}<;\G|l:Jzߠ1Mus }} ),Zg6G`AAm6  C|qtR7ه:0 0^c.̤mEJDe99fSbǯL֘cV]8F 7u}B=.yÒXL֏SXbA6l6w)I_6fe^kz?T7׷Y+e6=RnBqIOq2idz.QgϤ0mTt͹TgX3sWNj>|HG'PC7a]l(DmMm]ڕi9<2ke xrA+j4m䌚WfW,/)O4W2;~A Bf*ֻ›ȨvRB?^"2RZo*xגy/S1foj[XNqr|kBLs.1bivO Js)ܛAk!I1e  ,  >BtC F0f ]M<^)zn;;SY4c)9ic_2>;̆K~v];Cm7}4.7Kr{fc9Rr`o-.Pu-+鮴$Uԍl^aP±i3i-X-jƽ+Tn>:B,1'yz6 JaycGw6qq~zfcװlR`\{S,N1aZ혔sr{X݅ey@~??}/ I0>SP<v ~pOj>|\p#&CLAA7AAAb:M= $ob7SuCQ[wϒ,/ez5iR:hʖn{)=3"pJۺz}[> twr'zKTp<|َN%u?xr*<6Qk>|_= ,AA? nwAAp4=!79oF=vc'^[?9敕hԫf;7uцs 'װ:RҢQ>O޿c`tj^IW ,&^ 5PuG>/s,%e$xM KƖՅΟ\&u (\c!ѧ*S3 N= <1p ==`2H+v?h'eG~Ҹ>,g]rAAy EAA|,l&X2}R|Mwfb'mU=$Kj_u eJ6>2ۀbAj؄_Ѧf1` FPTW p:zg2 3^xT:ި)%h}6J}])S- ghLkg5 <bgBZdS9:> f񾸆 {Vdm0-n/٧vN۸Ƕ^sDy }sOfK+S9H]aKks8Tz/rIA9cO-ߏqa}pLxtWWRͧޖ}Az8Xk]lٵ J-3LkgL1!rx쫘"U5y/H?Qq..j}1-@|:ZcݪxQK:SϤ9:n{71Q_SZg '>=  8oAAٷS6ʲh1F~}n97 6=x0"]Z\gshǐ7V;_O,Æ[ph+ai5T2ثjrVxԊUz\JTwdlh!>r7kz#LR=J|PT jxi4h X+g6&蜯p׀ %=Ol8ɺj6c#M ,|PM@BkUCSa`q; VØ0>x]`uG\g8!Y7msn}9&[S\Pgw n ^–>neAASAA܂l=j^2GG&32zWa.c8IэkݨE 4 eOtm>Z- ieXWr %RO2e:eNq%,E7[\M+Btyt_w[iN~JlpO?93`rNQpZȄ{M8\W U:Ez ; f}00e.~|XP'^ƎAǣ?  TAApC 7Vgp0q<|xtOo~3aSj&Vק->d^>&=F.;ou lo|Aau-eSߪ4Tʍv On+XE1Dצk[ Že\2p$^?οe'P9 Yn^69䨠{j |9?X@AAGB  [2$< RDƶ=~\n&;y<6<æ.)5*g6AoRNn#e6E1) ntZr{ę~}' PhWLbipb)CP\a7a΀]$8w*c5<=VCuN*A4G|  nJ  @%owMq;^I6H3V7hT&RHx "mfgfڎNVyG2.eo%yjsu13!ƐTy=:6ARB-ZJ3ONxPbVж7{S3kFA] y1j ʰ*a9|^hKD s?itJ}>wjr=r2V-wm?eY  n@  c6C :.ZuMClzLSaf)Id֚ovV}k~:]o Px07pbkVClԚ߽9|kL;W޿"{+wܺGVi:_sTX;pI5\o/ &i5ve[>6.J o5x{ I,-&    CFE:ȑp7CffyJ)ێmٿG۪C=J|5`->txkCM~Pڪg>ST.tm2xjlK܄X\>/5g4\op`[ms䬞 & ,Q|,Э4-d6󸡥eau͠Rz6ǵ0t&$\O΅?kXςu0>Rѱ]Wݣ6f@T9Ϸ=>xP-}|."md;ScD=*Ips»Xc:dVg#UBRA;ټ{#g `nik0{Ӻ/SBIi eE}M|vUCAiW#)oM؂s9<ZH'3P e~q5̅դi25*ho"f r|t_y\2约0>}vyB)ZLz8@ 0>S:m0a\K);*N1,654;AAAA, \ nc{ta62, $Q9MaC/Ԯc H=LTE.u迢_V@)^~Tb:8;H (XS~LD*+ɠ]\mnuY$CM'æ;lT=t>>]yTT {2ސkZ4=[oZ=O  q{:n.nOި=8G6mm .>uwYw9}MlO=RwI¾=8m{93n2)Xz^=UaS:>wNK,uIC[\ %f%7W߆kg? & B '{b$|r7aa>t8[na̎@蘑'SYfXt-s>$So6M<'N.Tx;ƴ j薭9LFK4|ٳo;rd/I!i/b߁uh 1Yh)3k#^|Sz w \tؗF`g;XwGN`p# : {'j=Lw#> OLt}AAw  >B]Vnіv' భQ8Bs5s{[7P%A]Xap]>D0A" v<[/;:n}TYꜶFH8sFuiWO3a(y/@zoZEK0מzn;/9SsA7߻`*PAA| "08]LSyc:7ejW;n!M c;StƷT{\Vl`l?u=pAAAsOAAwνYAfcA3wb>[7݊)[j%D7Gα޷VE{/ZZKGI6{u|m=M*| X+gliJ55!H \tS=`GcNFuZ?ao&]I;FXhYX5)1-I+ET=1U=EIv?^"&7Ij)?jX7[K{C uSx-bSZ=%rԾq-=1g$AAm+%  -[ȔQotqX7|'mٶq'MҔJ6-{wC,3' Elǡ;;,"h4wɨnBt{y}.Qx~$[ܠ}gNTG^uۙ?,s6M^ CB}Ly||6&pgP9X:݈{Y5`4P핧ʦ%fN96.Cǭ;LJ~ KlnNH eYDҼqt}q뱨sEp1gGA3CǜR#t^P0 ;f Pe=6{d=/Q,? ۠76(0_\9L^֘X_댙B)[ØF5g,umR,ۘsKAAp[  Gb.y*P&ovҏo]WfI|r-J<@E=KQ/57Psyt,1I>XN`YMC`UD19n3;q~<*qrVCT4=Ӵ JfnXz޿|䯖ajXFEkK0vr$3۷[K&:v'JrocT7M >eWgJ*e TeGJ8K|NmGzeVK@ݱAho*C:L#Y{D tB8sbShZ̍{ti z{^AA0%SAA-iG҆6 otcq | χW6o±",@Z΃mA=ΗopؓJ%~'L `cX1/T| fFYNG[ O(UUtЃק"JmP@A5|[; SV.K7m,30m8f@*aݔUAAq  r5aMV<zaa.7a~2muoxHvSH_V ݒ%O{9/(Xr;ھK XǺ*[ۉtZ“p.)&nn<ָ ~??ᕃRc~o?ޓ&vPSg7sqq5=u  q  GfR)9i~ɜJLI lߌ2v6EʿF VW˨~,Wa~,3ǜhjl)]4ݬ~+;qR{d" "3잛UO)XގWXߊrs멷 z9  R  dlr&*{m chq9V/yuuO?oN|:fue-4qKSAAqDp* AXު}$V}2,ʏ$̧/mqiX}H ,-ǨnC1{`ngW%7lAγT[5З~rp%vϥu[|ظLF9Ã.SrΧ4/#=V֞f< \]9hqEy,#/WҠes|ә |uQ)?O$ &w:yY`WqcI?̮\cBU X{fmN} :8׵rhx%z+o3җM t^VNRo'kAAps"8AAp|̅SAŰI+nknơn|EYt5zK'Mi'*ةn*-57+M#_ 7!}#=K#9Ԥ<7h2ci}c93ee{؜N%-„MQQtkCĵpf+aɎ ePoI'u¶LS!hiMR)PY)ںڤLm=@`aֆ2dEqki sAzqp% [c~cHC;Օ^_ 1\9yvd-erI^B߃jYP#RO ZcϼѼ$;}01xg Uy4w srH{ߥ~H¹+G/c&|B_ug~,-]$6C̆l}WXSD   2  Gt+orXaf ,Hr> l#6!ɹSh1~8+P}ԟl8η/7*] K0=n+- b6S\n'3BלY;0wȆ25_ܬf7R\W$s`)P|AYF&z#ƾ}5S{NR* r =Gw5k ^S^2ձk?E3_):!o5HY *07,Pp/(u<՟!f믟eg1ۜ`:,oc1Ls>Yd%O_R#A}} MP6H1  NAAM͵1f&O0QQ}S7=x8|uy鸴 7lo3SܠFqMev_?/Hm'4 bw ?^ޢHpxa=53pP8^އ~}C}Pc ѓ7KB=6=s=K)5 "xe\l=&ev%5svkmg}m}@pi 1|Y3G+]o[S%zOwAۨ  TA}-yr,s?M‡v2gDg6f!<`r  (O˩ u_,x4K ? ί=RFX{}+Quچj9w^[\wN ?5O| m 4j.jiy&Z2P\8ŒCY?3q6,Ll K̍sɜsž- DIp),RB9p@:@=ZﲄwKYhk\5%iᇮ}Uģs\WTK9xfj?^N}b@*d,j{:4?93Y^0Jɧ_@A5HtZ `agd q~\2]%N'|=r]x a  /  ^uq#󛕾=><7g~/}N'M[]7lPiOyE Z`CvGcT7Zй<(~N|ŵpQ]~QAn4:bp@:?*$84X\pnOGs)3~ɰ)8$z}Г4ڥRdG K)::S]4PLŘ\q@jg܏}N z6%;;ՙ¾:fiYVn5]*g:8~Z0VAA=  lf"7_ͧ d/oL R G޴ {Wgnl+nN=i.3B?} : w,:~rR1mAA<$5  nLE1_X6PGv$tjSqE3BO.-ϗ2ם,v#3yt[>>Ю Xߵ|\J)^Ɵ#k?hYu^5x6h?T>zԟ{(-Z<>u10g5e1R QOFM*|ܙ't1cOM# $|=[{zqgac73t6QXj:ͩ^d}ٴ~n5K̿р102 ;ٶ PJCsS =} U)Dox/ z 됃H7YBzBWaWuW{RZZ^޾  >oqAA[Kf`qm7%iMIqz7冴͊iLw7Te;>H~OeǟZ+~MS8ӱr]BeXþWfLٵoc9fR[EW In1Z*H6m5,Hfc\{sh00f&e>"m+Zя'؏8C|;N~˘dzF=G:?c2*c:gu+kOY5C+֬}]۴<5llXyϗݓ7]ߧ±qZӻc뛗̶/սP`6'~Y67 -o7 ?cY8AA<'~i  M1%2Mf#uWlY6P~'XktU~?:)70+,ËD$XZfհ:a7Oƾ`Tj)j5d_n"xaNi͒WdFslXgL7mHT ~*%t\W:L]zٚgM%s9u_?YVfR~/\.Oekn?Mq/>4W7ANNʐazxkz9ix6kAAB)ːg'W_1/oI:7rr.庮.eݿev1iװݣ.I_BCl ۢM7oVuxxwDy pWnz*Ou+YW1ʊyC n/ \)ilo\6K٬~"O?OhSF/\}+caؿ |rkr췩i"a)Hr 9y*^G?]=vy!|2%{y;?NAe!L8`Fl|&AABxAA fm\nܨonϠrõ\S)Ehr'y[}\OFHCR9nkNlHS듾kQFB9ʜE\Cn ݾugI %65ֹ+Xczj2>ޣҪ״G :E߶rBAJdկ7A<)mX7_,kH; mC:>^]3=R`[yz d9GT"?s#|Wz6-<ٗdh TU\>C>}kvmEYe@?Gq X*/q W疟Ō1r]gs cA%e2gڮ{;cYQ`3  0Dp*  ܮ-˅Ϳ9lc7ƵӘtʍ2 Λ} iC.nԗbUQ>V5lX)/ 橼j>ͧ_3TZI &+AyԠҢ4Ki#zRÏk9ɬZSwh^*0T%k&'V|T| Y5lT>}KFޣ=tZюIA8^5%S_/^e& g_㥾~+c_ xc`jqt?z,i nڂ[ <17K9n(q?i1c=c͘awvټ    x@J _<-N52֕+/3ܾVYIe冣n 2Y0[:Ϳ?(뭜V2ץ tK(褌ta|DŽz>,S.g5 &2-WmmBs>:jiSO?χؐn1uȬ3yyr~!]˓Zknd?g ȹ~'66v: .dSLx /W*+֐[O~"_J3L'|nx+yrR'-ڢk~g6d2]LϐO| 1]k>ҿ*[?y.3_c9?է?+;Mι` O}wRZְG* x^o>={2'k0P3=S"7^`KyJqjk?kd ϶cm=.7*}V:יg+5QQ5D1;&w˴nUZPiN1  oW3AA 7tM7ZzNm/liX4yAhT.GD9u4X6Vgm:_Xǩ]An3ޟSi@h cJVn0(CE\gtُ9ۍu,sٛٚ h?SH0CY?*7Rm~珞%W\ZQ|}/YɻK?7YǟROü=t-įۖ0c; S\Eg'rOeS'4_HOF~??ee]+aZ*}|.C=yqL՞,sAysc=}0굉nSٞcY-W f J<]_2iC}:gl7HTYa{zz$6P2eT{ށ|Δ2e -Qq.R^6l~m柢WvrHld_ɪPț$"/?fin!hj5_苏clX nY(L+^sZ77)fc t{yj.D/` fm[w޼<~urޕ)LVl l9mt減Ϥ]cqvPXwz ַDegQ)>?O~lWb}׃5;:<2[>'H  >oW  &t֍t˻HY7] z+7y=2 X70zjh!"k|Bol;Ee+њqU: pS߂ އ1NaP(}1wmSd8߼=:76n1a5OmX9~'EU%B>9?"[~vKtWW;QǒƅWnbj{aI'; x"~2H[QXlJC8ʍ~†ё{*3g=eR^O~#Q$gL#S8Po12s)|9z ºq{KӡoV|Eukuͬwf&ZevXζ~NcS:>L86wRˠfz;wjpJ4*7N@ۧ|A9y  ClAA pxfSziZ_m pn  >rpH6طc>79hQ)v fXvԞi#[nm- Zn첄v :\3[Nt<>ݿ9/RvrtCaU)G q^TEBjFǩ 00i@]KE0_ ce\uu(g?>+%NKn:` eo=?ٝ+E(/! NͶӠ]kpR08gJ8yG39h]Fb}W^a)~V)ۈͦYW"D~wCY^)v S ( .3);UFihPƢA)mG)UN%z/OF?R^S8_>g^}1\C/V'_ɧO00 }瀛p N<$蟏I,EHA5$.y-hT)Lq 9   x'_Z6  x=Xnd}Ye6z)-T<ǰHQ{.BCO3sHޘ%,hpS//0„j2憾iaT\ToW%RupJt1kbxphఎ8)7m]st-\u*꽎X6x/wM2JT12<5֥{{)[͕OAS%΃kn ʐAWׇ 1%:3 ԹJ:,`M(۹E޳Wro{i_E W\OaacYػqnlv飢3utd^Og_Ζ+9'9slsK M;tǑ͒!̯}Y0(;.!5krȖuv˰mfFo3  ;"8AA&vr`b uuu-fhQBs~q?-u5dR>FqM'^Bdoן1s,5.Ckn UF1귀%^yh柢MYo'O^4_5W5HG#u'Fnuz0jnE|/oE^>;9 p A)̓!KO,>.R!zשRR^ҶQ}ￗտ_O\V^:YU[|#M i< -Q< /vaF;߲WӠ뱽 נuR?#,r+ʱv%vSH7,QǽqSWl۰؉vz}|1l6۸Zmcvr˲y`O9PïWԊKRey-lX*rI)~֞~B_Ufshjb Z;6*( -ײzZ>LG?y#H?AeOP@Oxp.SWSNs@e κz~r fGC}i[^SFʛ_ȫ/!D|%<\5^]5ڶ0=9ng NY[jv=L]{mG ?.u3`kz^}:21o{9{Kq)DL+4XnvZDۢL<ҞFa 3--Reؐb.U4彖pwd{y+QtLOӉ߆AAg  !8 ߠ3+Q U5A2B_*b.fz.ٵٲ=R;OUcRI1xrpj ʰ_0W-2s_s;&Sw>ͪeA ? p0Z`5f+< -(c۩?&^03מJvb;u4u˖$^Cfy3^GiI!NC?'όa)Xj(}#&D-mye뮿*X3lp}oX +Z WWϾR]I$dvme1Cx~zhͣ6B,m̌4  xhүzAAC/[Wn0y(oscTӔu؆mPեj }9vmښ˟c[c">.nfXRnώ=c98EXu~ $ 2?G9G9O.ΉzGc6H~,(ac3,Eom|}cv$5p#}~l?,}+S6&*CpjR35OSk}, +d*/g }:N-h,m'0|hv  !}?\,ԤWK&pU  C࿱AA̾ \rp~6`$qngymQ~SL ~b)Ǥ> N=8qTGj[ O>QQӒ9998U􁟹ut|̹g1/V6fmIO6K-ݪKehpxnМclxr8: ?5MCXx2W@K;KӲ@S_=lcit`7Ti{1$)aE9>GR_5v841{úi/ y9/컷,sZp*|(N۸컻fu9865(qMe. 3އ()  aAACA$5i+}`mӒ6s%>8ao)@7qͶy(l o[Q90MWיeP?Xq>!h<[ t 澞)Ƥe{h7Q?jYJ(g-D&~>Xf xUݿ̷l_ΐMHCۤvՃ4ǵ"lu:i$ښk18~={.l{$]ġu:fyϔZAA?ljAA8 2ɩX{9o+//mft󳜃SnNp-r + u4Lpxu+;-V#ιb5ia{r Qeԡcz5{x@zxm ^{uPDb} =Gj e:עOinuN%L`#ڎ?ڴݢ"s ONF5_x~u~(,2͡h7ܖPCM  AA<Wnav3ܷ O훞%^|˷(6&6Vm33>u32`v]i͞fo ۖbcXA* TIbKqXQ ZhzHl S,[jBkvI*6,Y"SQbTWI2FL&bk')ߥ\g& 轞J}bמk8Vgy(P=5ZҜjn,nF!Zvʱ9|AA]]7  G}GܪMZ HfWOf:sf8ulcwME OMAfvRBU1=i1]ϻ戯{y2nCy7o4YE+M}-s ?lme9ޜ}c8!o:*7O Sߋ5p|ͦ5ړ`A|ݏTA4 fBU VAmk@t"Ahu\oO`}M1{3\/^ͼn[e {K}Jecz'bjbzSc=JF1Ig Y-SP%>O N ب"y|eGѺꜨ ۻfs*fuom78UnӢ^;z[Ϙs NJj%oꟊ΀e _GO^N_K+[}],!MaM$_\O{غ@SdYFDR{!zE>ck=syڌۚ=Cr,c.A8ٰֆkI9]҂j%x%*%~=bgzzp>~Mf(S*f[wk}<(e^%mO_Uꙇ]s>)s;Zݯ^V= `\7KrW}U/[];c$e mͤ_}~)01҇*շax1oCB򇎰~.,}Ͳ~^eILbգ8>>(6tz|/mcؖqA"8AA<4_  džosk~rRؔvmȴ]-)x [w"Mccǵ}dֆ~F& 0 >:^c[^Ox /;Gn(sW籌|/gIናyvY5`x#7&6ͩmg|:GUm z/{ά^͎m];pd^DZ7ㇶI}ӹ52 N1wchSV2G;EITʂ(נh~hIU NM禼 Q5G)ڱq%n`d4nfY  >_  džosOM3Shf3I -57ܹ񼾐[-|3Ma5y\HkAF:>z{xƞI$GxٴOt)\?K'M%~#OpzH-&S-Z98,| Q}fXm͛jӷ΢O`N-Gyum4L)Sx֭e@gK, _Y;QRW#Hno-dRjCDZkd_Ժ81b}\^hU9\RwZNІ)Yb}>]o' LoA-KYp|.NkA1mB)S;\?-:[9]  ǂAA`gFmVۖ^W\V7.i Nb_SscVaG##Xcۜت6Ϻ}5Ĉ MҧIgXqZm˾2;mq=/R0ح-eڂLAA  !2ba3"(mi2c!m R|PU9a[}ɘac5T0ᾄKI S{Aߡ\)ۻ x`=JΦYG&7{9a?s-w^oVSY_+^hP ~锳 L!7+\ݫG7>9o] Bv0`gґy|1L%  xlDp* #gy-oO__w_F&5vb4Z01rG421n_7 碏p^k>"ڦd}q&͋"Orxg:2WOJK\] ѴüwrviY^4x^ mΉzC'C=ݢ^oX;=T—ӗa }v׹q  K  >rlt)7hCʺXK~"V~S-m#8eTNm7&´`r 6c]JVm%]-m/oRO }R\!qK\] ar7owD.*3%N7v'1rӖ~.S)>:S_k')޲dݿ=摁R}Zsk7оT<4 59vo)$AA2575Sny6 L2Sk;^~6J%Ktm3¤hcgNaڳLFޞz:?^CSy0׆esIa%KMa}%NF  G  > *@G :/udҪC- _5l2=3;߯c4Z_&'aH%mog51>mVkIp,ܨu'9mu+kc:ǙӗbOya>s Y97;Wj'؞D]C\~/,W׎ma:\o\kەg!E>(}1g,KT+L;/礓O/|Nګwr~qf@;&)> ӃZ`OEaQ'\2~:A=zT3uvG;q#sDǢq}6az|\JHHb+zmϴmϤmZc kǰfm/9YO#2ô\KRY'  xﮖ  7,= bLuq&8UW=خ ٢1C5ۺɺ237:/X /g Nmzj׭ܑLڅf-/毣m'6K,8eO828e77FY1m?_{88qo43-u,Vrլdj-/D>1#&(?HiΧ=~ěQpД y7Rov>Z5RM<@cꪦ۪:/ tu}#,0oPgA%,O{V, cS!( Lh%ˀ*4ٱ_qLp.Sei޳ap UۻC NAA|ﾖ  77 /udSD7MC,8enoq״r?mpʮ+}T o6bxt:9Hl5y;ݰsak\cq8>Oˍfoi4F-7d-[3-hc=ڞޗ:wmThVKzk%wj/]UժWLql{A k WO^ `h8vm*IfoP}|Hڳbeo[C:wl:y)wV4shBvr382"=͍])>dAAGh  qc%epCF%;%85&ۛMKݼeڢ秏X^b[OBԧ 8E<@k ->r||'cq8xʼm7[^Wn9^MI>@O7i낼ޛ]A|6\*&3Op6zŹ75wk y PۣΡ[ ;[d4Y'Lm.ps<8Egg.857'㿡TR+d;]r`)^TpJCqa}\l7\Lb- 57?W$lY]Ƽ]/u, <0gjGݣ%&gJ V+R?̛S\3uc\ȹmpj)(4.@h̏yFvH鋕BxJi08nC~9t깁X6Ѧo:.kvo^K[zW;,  h  JFPn/udC)¼o{;SdU3 Բrjk7ы-zSSbA>2Ioj# N^.M,dC)NDTQ|J9ޤM8k4ZjrאYBlѓ~FH}Jۛ`^BMX~ _1AsaKZkE ԧM50鴨V?U:t FK+=Lv)?'謥q=U~F ;}̗6ɪJ  >>EAAbcF_+nCV ק: 6xpkz7[ZrnPK7mPP|? 8#kq6>qf? 2H1mo.M0k% gC#<(4#Ҽn0Zm:&c؎2sx=-Js}3(|$os,\'ֻ^Hߝ ']VߦZ5\豖UsFgS?<t@SCguꦖ x£&]qIŅ9Xe:n^Wry+=_ɓu+޾9>ǜ 1.:q\?ΕA?+ӂֆ]˓osCن_Fɓ$clF~-(EJҘ{ j>Ru>cxuNR_ |13Kvl#6x_^s[`?`_'eToAAqAA!/(㛆rů|Lʃ`S0 PyЊjoMM?]cbA6B- ă,dܷÍLIZsTVE;zyuaB;R\YǞ`ݶNcχ>tSdòy-=T9di `[3(3i#}6}.˟WҿLZ\c ci09}mw<7o ׄtn(pբsL?ueoWruWrn ʅpiuISpă6^˧6UWMC-ۃ6K``҆٩7;96{K5gL9t3]C}DL2y#f ֞HвmbGp9\Xuce r̠81AAZ6  Ȥ@Ӎ/{mݔG} zDRlko~RŒB:4ၚr< 8m}F0r.W&">/61>\px)7<wuU5J޻dv3FYT-\Vޭ_HGD.H6ۍq޴ Ɋeq=~ < .GQ[ ~VV>ˋw_7?ț_+yoDZJ#HW'yZ#qOG:-O-))?nxmiCl2 u9&}1ř L(\=i]Z wI`|lݞ)kfzk6[> uM^$Kz5a YT)j[OAA|_  ϏLL/wyn=ՃSo#jbq:ܸ<58E+4LrsygW]o/< Tt =A9}vW2wH:u˻#"% iЖjVbSd馗۷/뿓uI}~WշR[nS|<A,06 ٶa)Hq]t>~AAAav9?Ѓ~P&$w'SLXpe nnΌc0 X걯(lǍ7y/Iu-5t\_H(*Ҽi9 !<͏>NuҼ,.RgO%ɲLF#L=WT=q>T;9v>va.?ɝSrcs"Gܖ{C¬,M t  Fa1_38Ν#:uL՛Ø֠No3x}o{*/:mq5GϕnK s  QwAA#ޛ-iD ѦH}==<3v~Sڶ jiwzMަ^=hF\Ղ:Yr2,.qW"Eϲq|>b_u㗅@?[mo ";L݅(4VTЖIo*\-_8^>̫S`-DOݡ\c=8wڂ;3pҍOh2-"9vjWaZ|n~uvGmǯ+w.|yr   w  ,͘J$̓NVB1 HJ>5,eTmaTleȮNa:l3xYzb`}57 R @m*%]@&=A۹2I88DMl,fC^))FȁGUmPը}O֢]o]fyyI3]}b`|Fk.kf>scJqe6kˑ[9CyG-G% r*{wV5B^+G/IDATmU(b814ޕGʃSVQyRf.AAh;nAAM2aCa1ԡ3FA_Y!:S=mX}2R95Wy>j/וA53 cee>/[} Y-(dQt_63ϰ~1}3s=rc7%Lq-2>i5 {j _ zt -~NϾ,3́ AGA8M"۽+XW,]5:`8ra\_d8G2 cR86.ciJ#!&Wѩ9+u']Kk=o:19E391_jgs!D:s47.d~ZAa^2WCyѼLs"`loCtLq5ъw:Ne=Wݾ)o.rVUivMRKB[e5CZ`]Zױl`ֻ[:xC|һySFsdxo4q-3hdöTj:}sò >Z\}:t^m|g&KGUMugO6<>AAA |  )SFtP5 ucv;쏦4wڷ豨V*q3 :7P3#+-!Ȩݎ:z\՗qo{R _|_G"ñu`1q}]wZ|ժYuBms:e-ӻ^>~}9ػI":ai[>݁M}[`9mqKx,mߚj|m5Wmcά|iJpSsִ#,HwܷckM1pIyi,aop4ڱ*-c阕_/uR9'2?Aq x_ƣ-)6/ .<%c:Ev9hpQ9:AǓ@az 򫟉c}$;֓ EG7nIbryP^sGO̹ Gբ+r>,tiWǝivepiimPo镾,il#"zy˖:l$ {e}G9E/1  x}]AA<M~s)s8Hy\ y0S&wst9MrNy=sQ//~SpCsq{d^}ͱ8Lnܵ鱪s7IM ƻ Grw[X Y帢H6:ZUA.DD.v4;7cuuٜʺq^e2!A`#VwN!&9΍9+*C^:= &wN-u<~:5nͷT7Tudus*  n. lι/1rA2Z|ݟۃ]+S 3TT&܍s*7> sK@^)ˈ~vT,f{rw̔y3L#3!3A<Ǭ5AI&qG84x L"ExvsyuLdSd{ЇȞ#B;D RF3,9AUc!gΩh/Sнbɺы8FSt_lnoE2o:x՜SGAy7P\z_ռs5:7^9u6\95&Mg30O&m)w,Toq}0P  \A#us_b9ei3iL :`*^yEM_oN$79Hr9As&9r/l=[)ɮfnHz\綕SyIo!s̥4hӟ,4ۯ~׭Ua *t<<,u1pݢHs/;fXvԿDz\3@6Q:â'ddjF,O#uQ2l򥺡&6lnA;L vk"qܟoz|_1B;R2Dcqb"= o/QHt ]tJ~> gtփ9Eڜ$vVPawq4-Tz \9U9-4I񐑏;xZs&'Mڠc@kM~7H( ?dȩ?% + AAAA<M=Hux5skk3a^IsTn-mVʠDɝ jM56DyʃG&BBu2kT[- Yu3֡ˋaW*w]U,i8f:F QS`1&B)c0>jW$')t12)<E0msԑMj|F#11)S~)R+Ӥ%+l+X7RM\1A5>L6ʥYA%YoOOr'" bg9HHc~u|  $maAAB<691:iMN;z7O͑B5C]kN-ɩ9jwˏ۝Su=BflTJLVΩA\S,>!@xF_ Oeﯺ򷑿61h;FDZ1}^ɯ@?;Q1͂+2TR16@4=_sb }i}*KS\ESگ󟯽DM|fY?p_jErWeb|em R ѪE^2tT|eY\v im4֕N<0\SɩX9RbtLsytQXZ2+ʢPYIe1INAAСAA׿Yo<&Q;1Cɏs$՗d|ߩd1BSu kEOcGa96 u:%e+<6uQݷS t^AŠN:ũ#[s8^uKN3T3ݶ+ϣ㚍u5,Z}u ,.NJy9Xv,**~]Nr bU;)>vN^mT^ɶ"~L -7  x@  I`[3Jv"Syݚ 7Nq'a^-//KRzo´0^ә|tmKnւo ܲβ9Au@*OjsLʱRhU0]?68g 27tmtTu2^0Q9Usv X=/O֪z [U9X,CbS63UhK49"/(y_s0rPR 29fΣq5=`= Ω  G%  k5b7(-= `rrx<)VG!$'7,ykA[Y9Kyd%4>dF39SM4I,4>W9ٓڛje:ʩuk$1yD^gX,l╼-5?^.T|~:oƶh$ӍM Oȩ_.oAu,o}Ї.h D*ƲџJUeƧ2ٿ#] m¡زD)sMkYO(ZhTaN=F"S戙/oi8-SedҰ(eW)+e ҴWtNU/-!h?`kΫRJB^a:-k_ ټUm?&b̲צ҈>wD& H y|39T`sRe7|"w^L>~"wa.e8h|DwN:r*&|y e󂳰]2e &cd3Kc:F2*XޗPц_ ߖ3t9֑ 7l'Wt~-us #JtG}$ɞ ?W_':41hw(XAiI9a0+Yvj.o]Qp<ƫHqkaTN2؆Σs$~]YAZD jZ1# 9LsG`96),~>^|U>ʷ8i߳`#8*'/=leAw vK*?KkӏAA/Z$j\N̝U( )ͷ9r)y0˹Zo>t:vX +b:Qa?>yO #㭥_ܲ 썂Kl^3"O 7Et4eB<ӼIx)76OY1_H/:'-ݧt%rsy@uDf|u:l[>^WCT7?uU{ZGZhP58/#0qyF[ՉvR0!  xX}qAA<R7Λ) hӈQEnȮN~9b:lE,glfe:g)C7BOA e 锇a Lgȏ=Wd*X|ގ:G1Pn@|\To2ax4E w#}ECwL"waB:ʱC8rץ?>5SHض9)4%4~X.1:L6@|K']BC'b Yu~Vz{B26K~4M/jAAAA<@crSP_hh7L3gi<[QWJoٌkou0,^j}33?mbac<乩w֪+ayzsEuIrzc*}_fO[g GX7-!3/M 0Ʈ3Efy_-%c֣|4 鞜۲~-yOHweC2,>}WYsǐ"o9?'S0'Ol^ՙ^W ͣz83B[ג\FQף;Bw q UqT{ ے2SoKs//R_׶iG!8Ka ԩè/:\/[iGYzr0  xqAA(C7N2@S7@&oK5N3Y2+h~ky\#AVoP.<|4߂U2<*&j[7W8ssP1hO^w۝.q1noA\b"S2EL2Y"ry/~[gt•2^?u=ED"/;՟hl3 Z?-6yq7is-MW/YT:ܫߕ \Ȯ1IfsP3 Z <`h8/R Qjta}Q돪\njs=dKw[yylqy_^ϽrN5A~n C%)y}Z60) VuNXN _G 3oa*<z>ڔCMNjAY&BJu{I=?74JY0 $0o%US>U:2r8vLb"o 5ђ@}M#Z[&iWRIr*; 6/cqt Vyr5٫8ZS]iAAWnAAyÌ%ww)R3.gqb7kuUhn AL*rN2MN&bkRɤ~_90edce9]SۼU8|ZwWjOuU;^Ǣq_KcW@7zvQe,PDSKWV3gZ979"֫M,C쨣;/Bs uXkQ2ևp\TYt4QJٻkYzdΩ|Lx|%W*I*iSR_bB,s*  AA3㖐jΩ8aa7C3,Q&cy2ƒU^5Š*:T8BϟcuZߨU]JW+EG 5Tz{MQWZ6h9y^ceŐfYx+mG3GWqLS^fmj}Ƣ9ȩEG&t^+A嫈,XwA~s>tvWTs뚏hq1 ;L=7qvYhMj}Z;٪A3]U ΃SuM}[Գj3CnK3G;<Q+^aot27t1Ȧ02|)'m2,uAA՟&  3 4v4_CM;GwZwJn4z4 Ͱ#̓m~ӛmC=|6eԡs5 PYdSjйKV]?I./'  V#SAACOQpAOlC5OkwNy3źc|N`u1oq̏AM?Umjtԉ 쪠nkU'Ojh]Km!?W  awqwAA<e+:@ Z֧)ͫ&sAo_G<}Vh+|G?gy-?jե9y>]oŘױ[庱2l<鬬`|V́Zˡhwt4S(#IBq^72HANfRgՁ*4BPASJ%YV}2h+tdr ԿA/_jkk8Vuq|S۔_o9)&/+51Y6fAA~J  >?m.j(O#7Afa&Zz .ύuC<iEd%̲y.Gsx&_OW Z[e.T~7q*"5ͬ+Tܤ4hx̐-69;K\SM'Օ^_X9U[SW4j:Vkؚs *=^Hm+IσimtJ[ʯ26Ѹ.@E?k4R=6eAA"[   (r295:jxl\p&H׶r ‹SKGP:vLdeo:-L*ypqԽsl'CjT^ѢSq+NVSD(e$> mM#vJ>.u\ ׋t_ Uc:Ѷk-\=ZFr5Sb|7|\C]xyXrApN٪$'ui|t%VwNy~4cCuk;,g{|S9sWfykhcR#S42Mn  чwqAAfdoR: V#uӛLn*+6Q6+61 _e3C}+|ܼܤ'ίQyŒJ&3#{)Ae!̐eMR :(S*+ԏQ$̗+/Ӿa<+H0viKRDU>"*)0"\1o[n4(B]m9Mf+s]UJ.eXj/YXi y; c?:ZD露[z R99B[έcjl/McE)Wx=`T5|Ȝէ^,ۇmf VTڼkϱʭZrPU+`hZ.STAAҼE  N9 s*7 ooiv}O ;6Y+!֤Y~-a:z uve-m4or`J%?眲zw}Q5`]H笎X|f$<(+BǗh?qu\_s$>ȝT䨕St(o{spY8ֶ{X.ӵ m&cpy]F;4/kT U)f;e=gXqy*y7*~1?#w,n,?uA~9ZWbQ京xIj̽|qgfs2w=o>˺zG8,~UgYAA3  Xe9; fz3wL~ s(r+٬sk o#:Zo好$+y奃+U?#J%1AHK1O:?7&WDP-B[$ɥσ3?9긜Uq=:)Uf-E)u*Ꝧ^2L*ӞJ!Y/18d:. M atVc=|dz$c|Ͷ+^&LSE -]92:ݦBAA[ɸ}  055} KSEe`nOS))6QAVK%, / ={Q9rƚ.ˍ?v Z 1mp -!Yխ0,NgZi>֙0'A mjw,MvϏ.6dHBևVkʘَ@-9VmHrT97#ڸU&=0?>vNS/WK\Č8H_ӣ-p|<%c Ӵe5Ks}xl1ḄzjMuwR8my#j̏1t|Y].[_fi[vY=pSPGD`^Ue|{AAA5  Mi'n= V< +Nv'sECUWC7)ЁP֓K@>:vXbaZVkpPJ|V^n1e5}-c p4?b6(1w>zCOi:+Z-7B=Z~.qrNaM^riGļN]@Rjټrv2;=oE[U/*WV_+ߤn  sO]fAALe&xk5CnQdd;ӥrvÛQ ?{%Zea\lk︎x.eaO o`}qc5O~ar*ϣuCCCO!:w&ɟǬiaf9J0CI\=w$GMtK}Ց7呕_sYw`?kZ%Ȍ4o|~çR{*:Z^Ce}O!!  xwwAA]ߘmWRѾmێɅR wX++ FFM|ff|b*gjn_ה-hp~ws\|1[jsTZojhT;tPatp~`,րCt%4Pz_-oN+Q:k1(+Q9:itՇ tpp唵S\'h җ&i?.s=ԃ:6e~WcSrٞ~9w ج3_,,ytv R6ʵiˎM(Q92m䶎9Қcd:R\d%{xA[R ]9,աhC0//?B! qw"oUT+g0.,y:v}*C*wpk&Z'_WՃغ>\sNGu:.U^l .aMt$ rڔu-cp #'\ᘟsh|:ws u4=)ʧK¿JNL жhAOZqJC}/;s{Y,~It  67  V ЛJGqS[Æyy(ksʌ†GώsϲΩx->Q甓՛6KQduJ+e@ w='Z/8S:NJQiwԑ?6CKΝ>' u4 f*B͗sJ,*  s;  `eԻK-psͫ:4ykd4): Lh;Z8? 5検Sϵg3 w,S:9E5$"sn2ݎ1992΄\)rylΩZv h]5wu}(lQ ˧l3K9Ϭi1v Qi[yu1Geb-Ωї)ѝd,y.;TޓA0g#jg=_ a}U{꺐5ƀ!kf ^[UsKꄫJX@]H;w$ڂƜi󶥼ͺ*%0mkv\~BJiV5-ᐲ>H,=NeSpԱ{[ɯrrn1dk {Zڧϵ1  3   ͵eHr(l̐UFҔOC~錛%k T:Η:0`VvITWTvgV6y|kU(y=c79.nѹ 2Vcͨ 5qn~C=z-^eުEyu6#s8VgU,fTXZPUD]cXlSFnBC>j(UÔ6G`K;>(ڥa[b՗$˫4AA cwAAAph[RyU6.\N SI6}U7@NV8`Z=F)_-dmmմ8Mwףjg:75ژ'jC]X&Tm}jn+mb>.iߕL|i f 4`IO)MEex:;.Ѡ\6//pH[=$B}-Q)5Vt9*.zTKv^T>Ny8ԙ>"T2Lhct/˃-tNaK$\rߠ w<  AA}B2M~ _>#wN@iJE['wc3 7NWMY:zk:W-@`mUWM~Er4`]胺>Lkʷknq2X%-~Fk wJ1oW6 Y w9P8wC*'mA1,-_NʲG?1E9ȣPQ'^Wm:q*;YQf-bGy+P3Kh=<Lψc]GAAA+8   ]&zZ_|@;_6esElC'كH[0P]/3#8sRQj)´=9~qY6B=6%  NƭiAAp8z7yjUYu_WESɴtu|uryK[^o`:/jc~^`Q9oq1-KOVe~3(=*o>0=ǎ("{괽:ToW)9fhGX]6j{4VQxu;d MgʹǕCj*KcZe*9hmӟ9s у-ctgmwNٱWܤP!FYeTjmr#]SF-8gt  {n4  x`rsBjYgybN]L"s9Ԝ˱rU'SwNU:f+ס)wLV": hRRT%kmV˸l!i,1bF<71.qYk)jЄFۂ  ո  8wsfvYT^A6z.n%: 5I_VtʃG{!y>/硎9Xy?o?˺%_e^kөs)dh@:dphΉNS#=-/9[6,[h:,9D~|cYWS/߅::+l[;56ql1IiC9\M8hKER_-[ƴI;Y*\   sAA<`4 'ҝ#AG0nHB &NgQN>Oe,P޼4{N ;:G9^AS2Ω>i*m~ rYh/ >:8B,YùNIqs\IJp1"o_#@+0 L5br)ii1Zj噟<<.(V&dAA  p'ݐyrՍb'a]nYZ8ciTEΕ|UG`[HڭEǽ 7Grpcr=1u wNA벇w0-W 1yT=Itd%ŸuzT2/嘳"\4T2O%g>J ڜPNmQMT&󈻥Sqlb産:?(Ĝ>]ym:v`e^o-ZDMn}I[L^9Aڗ`AAASsAA*J똇pKsKZHۂ﯊g.ib+ht4Te4P r6#yT<1)BKb꿦~d^婿Q9s+>  V9AAیK1VΣh.$f|W.V_6(g>. p>+(RLe(VwBzU1TS Yw_{}\2ޙ0eVrqwa7,hSsx ZAAw=AAMGuh ֶ_*$wmrS4cߜҺJ7#keWV1nf:!ضNo5ժr&+zvunGߕZ:5i8.tn2;eOGK3A:Yڱs吭3-ZcY_{0ҕZj:jUR!k:]aNSY{Ҷ e#7:[v^2< S}K#&rj9AAAp{`  vg;tvk[95cZ:gwܱYqNYGN[8l,pf:fU{zWGO{}rrgR 7FMq8;I+飯~_DtrtCjlokGΩ46ts7=zp"OU/OJ̊,9kc 0S_JRGAAk  6M:L64.cN߳Aڟg{".LrHWoQ{YA^G˶cuR1YzMo1[0gFԝSezj^6}ŭbN)̼zR]N\ծ\m!?w.Q|m7UyT\iimyNzUf\[|AA|  ͩΠc:eTәRt;fxɺSe]LJ/: h|`Vu4l7:v.K_}TWׅJmMrG9rW.'2|r7EJt)q>K0lNy@yFT2taw9-R>VuN5 suO8Zd yGs*  xD[  .c8MwjC2b8ȜYjX틝S@sRu],ȸz> ZoZD.휚XqΩ<K曶b:x( Eձ8l7]XNׁz :+ț]l]Y༘Wv_#wX}"]uc(% ;׷-rtTuLɴ`rVJU~ZS2/dQuoY2SAA#F  NC='v ~rN2P Ә9VrԜS8VwXȭbs,kxӿK&uQ>I+t;79+W™bj3:Vr#sڷ̥PFG2ZnӇڮrƱҮ:Q@8:OAUߪSZDuԝat3IөO q&;  4v  ѠL8!:wѼ"?lԀ<N IVj9P*Nj;rVuK `$'&qJW\NӉ+X_~Xk#fƅyWAA7  AAqLfYsfޤʩvrEx]fvن֐~MuNa_nu&uIfz٧rayk+\ֻHϊzruɀHG>UZq?Xřvܝs}R9_({:z˜SLǺ~M\<r9ܯO3 ᜬ;L*3ZztoHF]sP7"s(2]   x;   xdisS;HA c:!!ȴCTWt݂QDL UꎪsIԲ|n˛#%]IE&W_?cPnybtE-tjRݬ?)ΚEnG!M">י2j7=muAެ+x.hmyMҖڔщs SFe@l 52J?/̻h~tQZآIdw4'ɭB :j׆+MZ~B btWApP|AXl75C{61sv<᣹Ld ,7#B eLT݉XӳK`$qzsdTdz)6aL-.jI8>V؜SԴ">:\|ΕC)l{%myfo ͡Rm7~@|UssB|̪s-CsU.ނzN!#SjFoy*[ApZy Yp9; - zJ}W\ AAp,ܠ[j|^%mF'}Qb( >\ٰ=D"톙hCjŒO﫥8fO9EJ&9E|-qYMEh;VNz`Ǿcm &:5kLn:x!L #Z|ɣOsdsYJ 6sgfQ]Zjhhе"kc]rPo5r2ujsyw"vTaqN!nAt_!x *+)0>/}as>%lSFC]p 7KWisXbӊeH~\ă"} slv̗aḶ\)?f2,\f?5o~]*j`. jNνT2 uF2o:D촿#wR~b&ܚT9v~$37<5w94',rNE.ٷN1bZekZgӽ<vT;m3Qmcj>#>Nۜ64;Q MqACAPm'&&VTo?!xm4C>ao8~43P ؕ]>f>6k5Ω͝w3F裁LJG_hر]a@8̱gUÆRRf|y0. fi6#Nt *s:vNQ^/|>e׵ṡrѪʗl5sk+cis>!Nb ylNHs?:ں9]ߎkQrNQ^`:T~e?ᶛ^-.gcMgH vJA)A'rÏ>%y;IMń3X>1^ם'aM?i?ؾױlDixh|,-\u7Hd &~Z[didK`z2Pz0?G7E6E6e-rP;AP(nN)r(@8_'ݛ+fhe'?tBpGǃTN)3׍Lh>/}vmlj묍^pCUQN wey"4ӹˈY9U(a#ExA3֮#NTzPq6ի#Њ,j^Kr9%ry9uz8_b19ɥceo;ߑXv>xM2qSc!ϋxp1C]z&;kܙ)_cX\21:1s:w4y}S)Y̷?8rp&ZY#xqY_Py[҈u`Ovnݐmh\o6`lp{8yǵyZĶS qN|=/-/GΞgj/: a˵cLBh#7ޕ{UٻsCn޼%@.s(/T8.)q9sf]!жy ߔb~>}oE .ZTc(6^w\B*rmTex㠺A0itpE6~^c%r O~32MG? Fo*{Wߗ\ pe=Oy1L=&|Z\Or=romM._.>pn!pPܹ 1ykq+]E.) ?Ղ >ۖ<ã&3ecv(P?_!!>lmN&J=lQ7AwKf.ʥo}yK_o{HOd0>Ӄk7lЦj42Zlʗr{CÙlQLɛ;3Gn]ij5GG󳿉1Ŝ\AQs@yX raLz}`k2[>ڶuI" O\O>%`i%ńFPnVl ~}|U74gwv_%>˟LЯ d 8]c+KUgZ_ Ъ74|W%<8.ȕYXQ<-? V*6**v(Ea'yms hl<{D=VfÛ䓟w&zJKr8ǂ_h/xmaشоs^ᜁ>O}A.>%O=LO]1_&j<Õb[=y.Qo,rnrK}|6˧+SWBp [?@PV lu14tZ"c3qcљ'dABoGSo~75_Rn]H7>MdshNk_^r-]|^CU~TxA:Sgdʓrǥ-/^0_jDXn}ܒ|G"7'xlph+{1. "}AI>Av6fOe2d6IQ<=8O⿓]ʥr$?hvd'>v dM}<1 /UvE⸐S<&"nSOZO_E1AKB?"md2?TI1|^d7pp3{ ߓoY1t|'7ԽWQMh `8yɸ]1n^<<&pc] o(h IQ"ШJÄ6Ԙ}lB֓Ml*ݛҿKGrtZb( u][ PΫ@$YD+P7oPVCX_6WaӝJl\$S\SǸ|:>=/!p״\֟zo_&7?5oe''kTy8{I&3ܷ ص$5$KxV/e2m" :H@h>߆=Ln|nȇo"759}V~ڤa. X~s &ʈePFoWgD^L!xCҘƯ@v~LʎQ*{֥$8 f )yY &_Z9lOl axxz/FwfJ1' uTgy0/L02¸m?ȴ!;[+rSh#H%MUPkY:Ns<\e~g=L Oҗk櫠f})SqAO~A,2'ϵtk3"C|n>~];AYk}yϥk2|=LMi\ߊ'43SǜUn,5Ǚ??-XY  [ ^0yVZ}7O.|e7e|9<Ś{wZv #\yMpϾ;>^ȅcܣL74sJ17ޯ3[?*z:8ɗ+g~?3_~ e)ʝmӸ;%3reg.qKgWdm3W:v}k _A<:}A]%/B#~ -njqkf]dѫ#\;-C2ۢ+iۃF2GhTpo>iKl5ۃY>t9rAd GL_Y?-6\CV3%g>÷o:q͌dΊ|;D.?g\#v8wDh95ls _Սsh i@:hFq-2oJn}Z.|'=1~*|x8^;9r "iK0+L& f`^- Gvzqѣs:k>0sֽHtN =;\c0E2t$}Sr8>+_˿+g^d8A8_{DF7p>Z__CA!~?t$}ԝ25B~~V 6d(#L~A-zk"/+p]PK,U[@ -?籝Ț hʫ@f m3g2O]?=}р ^ˠ/~C6puF78۸`6׵%S1qm>\hp<8.pRl˝zN_M};o+zR^R|yt m({I/3:ڮ *Щ}\w3a q8 Q' exiY{+"~&u"@A|SA߭3 ӘLJH6OmhDJF3G 0FgGe{d\kENӈGt tpFo]ysr-Rtp`xQJC2_9mFzYio8ִиL4<؍Ticz7l_^xYv2#+UޠGAhhz5 .Uvku( U\1|S_*lǃ&ֶ t5\4j@Ax"g4-ϓb)R|s]ԍ>L$NDEt%Z'^z^z/?Uz;$;)6kf=;x{rvrqyc~o(cb>6cҹsr/w>kɦL1$} g+;Sl;#*GѦEQ4]97<[>y]F>gJտv4|QB*oěR*s7zq~r7zR\|NUT(f=KR\pı}Zu/LqږO7p%C`l_uXsfcI-З#vWS~*:OFoz xqmg zP~95'}BOmDoC?G&ڍpWA TApbY|OSM6L!s/C`IDEfDWloxWrg|ĦɽP^y1s+rA5D?dm'9n}xsNj]];x4Ue 8ok.yΛoA|qxWNcPb-ɍ$ CKi)gE<-O7~[]]J *C ;9ۗ2̮/ߐ{ ᣷E>F]_\H5od,}vpn 9{5d9 ķ$Ǽo\f.Q@83} MT~_sk/lz*d e3eS3:Kh`Łwd МSd{[{ґ. nzҗe|Y|%Sg5 |?9bZ(>!b4ĵ'#mt!u `YΩ 0sk•Sb)˕SX0xʩTS?DDa0msRTV5=\ "/,K9d_6n-7=5fthml\u׵9VuNa9u})g2<2@Y?3_wy P>)BP?yGn3a֌%mS"Ԉ+f!riOrߔGǪz%M4_W-MvEn|L~rߗ##۾RÏ;2۹`OBCdN4z@hMַqreѻײ'إ{%zAz5Qs&Dk`)aNx;NsaG8FA+m g5p2i_ey7f{q%o&=ѕS{o S}I\95`g imIqKߐ-\f_Ǥ #=?y` \)u#[8FzG-{q'8's_&6/[]j?ٽv-V\6p|iɝ۷ev5&hu3tT,U3ݜSt}`{ƜS*UDnOis*WΩH6|fJ:E `4Ω 1R }Gۢ6oRW@!0SO)LdW۬@umP8Ϋ/eƆaDz>ݓ̓U7e?yE~E~Lj_ySp OG;[/D>zSu^Z11_M*u6dg5ٹ~Cti#yTXhHWI6k/R-r=rKN8*|A|~ee0*Ns-_(ʽa}"gAv#.S]=fխ+ a$p!]|^9wS3:-4pzs6vomgB_Oe }8?y>}8Ec^?og7F7qu\y:iA膌2<#Ξ%!U=lFuSgOH/龜MODzήZ귛:*ag|Ax; :Vpi/ŵΩgdoq4gkrfL'[s\_uC_p\+friq p]ឝy&0:/\MVz*ƫz!UO9ҋ"}=u٥Sj8~ͦ37O+π/1v"Ϗ;}zwS)٠We-ۛEuk  X> s* 8AғZ&dDisN=ṗMfMP'3!:-"}:5\ xfzp{8nO`mz+ |4}oHh;oX0Zw~aW}7:ZtǘoZѸW/>-kPי_B\3ߑ׾'1>cޓh+qqq>q^q~ coAʷUpI96/h&p`6Z=ٿo{_yjDcskW3TZ?BɮOОOߐ`t_GfPjzQf0^6nQ~~=XP]˿.'_s==_sr\Ϧ7!ozc>M%?U]-4CS=Rµj}kWm'o7ptޣؙNR6^Wv~yoe-pw6ّ7̍wߢG]7~{Ơ?v?@ސbsCq9-d`CnMec'J)u^yY U@A8G#[-M#Rx>͠@?5g)ߋ g"B^WG߄:[r~Q+2|?BN'q~G3ïvUyl'Y^)T8?OKqE۹j|0\1E}UfgiM j)ٿ)]Pߐݟ|k9#7ix ٷ ԹŽc7q. dϱ~O n~٠]OdxAnY)W-kg.l&cԏkTDOjS~>><84 :l1ND]<ES ˗ pD. 7; _7 }]Sn'"Vld}|[š}{ת59=:hzW_(e8\ۘQeaCjv5䞀ZSs"W^C. zO{k2 H6－v_u\C:j2_g@G?[{鱗vHgIaeuI>o1F ~uRq CAV=uOʙr O4Oh;ħ'>>i䪡5s[> OO[/5!{[l}:U*,Kk7'ЕV:`3ѕCG+Ԅit>m_׾+3ssS?v/kˇ=,{w(Sb=(qo cN @ a=ySNnIorryް eMn~YmǴ&Cw3TU=y'G].fn9f m%`?Of?~SVYINZ]8q%2Lk"ω|eY)$" [~+~m$xWvnAe2Y5ecw>ߏ{"N:)tQ'uy@4:]K!QkQas]7w,/,$u57TYwPo M8!8.N^EtiWp| tL!'Ϸ>͆ٿ|OZ:D6xRK ׬u9xk?<\ u#c]:^6NSA/\e : K@WV+."B!q{Y6.MU:AO  8!){j VM݃C8\i0a:Vw*aSNծ$߈/EU'gfeޫX{\j竁t1n1[h௙Jғap +0ynBT荥?ۓm.x~|lkeK`iXN)p8_#&w,z/e4,9ǟBO?/~ML.ԗwMNwgH:,4|s ɍ:) :<|92(G2_9r@aQhǜA]H8|_Qesg^_[}櫓kraÏ~.[?>+A8g* 9sϗ?QY:52fst~?+ijzĹېdW _Q#T H.{Z^ L}k2CG)Mǂ5XKks؈t%q4r_mj>{t|[u>ТRڰyQԳd H\Q:iO'r|M)өZ4G<K {6|S/Q(Hgu:3] q49T cXZ M҅+xvyfv]ǤVzXWÏ^ VkV4]$g*[h&ڮc#U#n Ӳ?W7 OqZ:m5~[ߔri|=.4pRn{8G|CU{KWskR(Ư g7=\oC0,2˜息877o_9CC:4nцe[hھ33P?uNVj1ۈ-Ƴ6 i9PHP'a?srD55|)#Ot 'ث8}UgVckDҮ%~NGC)[vo/q޾=HOH t9<#??^V+pioٞYikq{uHw1O q#so$ZߕE+c~:3CO&VX<˭U(ޯ;eч8F}?u/G5P=r?Lʛ׮=c {VH`WWq{qP+QJLΩc*eok"(a[ߐb뜬>OR `%)A{Dx>S ew)Zxh!z-Uyk @W=967PHpx>w &MPYíY8 r!G#7iEtDa>P8}ԏhJ>.R?f-@o (T23i2dZliF-4@?uFѸv,hnjul7̡@t,‚pxJ־mm_ &CIbM#'!:e'P;(Ǧ $~dbks8LCёD0J5ԅKHìM骒)>t|SI±lq1MXwK"YuXeW IZ2 ??8o|; 0Clh6;P8f\=~f!Lh(PѱsB׽1'cž!mQqt}Յf}<'Ӿ<כHmg"9Bn%0>1n;DcS:q#f啕Y/5H:C0^{K2kpΪcǯA8onʭw.{m۲9QwBC+ڳqSG'WPȻw "M*L +W m98} 7vS6'ǂ#UGH>&}2p&l,Atu"J98Q>t5i)̸c9_r^Zx@4nGiO?s|W6]GuU9Jb&w :q\lTz]IMaMxM% }nym%/=]klO{ 8sg@?cjRf^(l[(up2eL d{qJ[gHkޏ' cqOǝË93i7u:>z }-2B fD,)Q`:YnmD< _ HRT  X|A}{(W #&O/JA A|6b>J o9 n= + B K4ܣ1Whfu\>Y{B8+{:u[uc leznx_u4gCr6N#@d`=\v${@x94ø3A'ꋱJ9 tGQde,i$*'o^{pO]F_>C;1Wtc Lg8_mR`;km~C6>̘TnyXidFaAUv6@|G"}{8 \?+z }׎2 to Bgb]s5鍹_0fPa^2`S+l%ҦoS13WR6׵=CY:nj6%xd}>g Fh\<׸Wh Q֠'q.=E]fSǶ.x ơ9'G{it7)-Cܧ{uw= 'S,&3(y[γ_3;ub5/Rt26]~Y>q嵜A6l{N0>ƸMq*EtE nA/ ry˃=N([asp pVdk!.󇘿uozb,pnŲ!לS'k*Q> ?bN%Sl}iLqg+Itk4+Վ^B1 Wq8tbgxz^n|k!W#WapoO!Й~X`Mp\*˳V'? @E)e/ ߐ_S_S"[H?uE-|VUhrS&k3:b >tԓh,о^"4LUJx@Xs<h>fkRА؃돋mg%EWepe=΢=k֞)ӘP gP!i" @FAiXLo`_@acI!Bv(|>Svwi' $Tdsl8zߒ/|Y ^ϱA gdoGN]S/O4CUb=QpcFƲoKoG.CC/QF8wt\ ߣasZ bf sl1+wyfme9}Nd "<@ԣ-g]|d?t@ݔ.K:0eJ'.1mQoY;O"kO*+J;\7qLzmfk=kǶXΣ':n{(?oz1\Pj4ǃװeKߖ_g*O|:>)ř'dk7t5 kRnlyv#+0>̠!m#C:jq}a?yZ6_M9e2|%^xז'DhM@k f/zgrf+ӏޒw~iGB3U^3y큶t@ھ"ߗ/W9k/B&_ٸ1ݓ?'?Sq|7EqN-Pd#('ڮ/8tfmq}_8ꘄy=-lw_ F>@yc 2la~`bLOXnO)`e|R4r}JC}R) 3Jk:iП3\ :8.RI_gqȋ_uGxK n~aʘf}B+w%GЦ^,hq_:4cz|j4yN^<,_k!LB̃:W~ P֐\6u Jl<ܧ|QO~IzOIf8r9{5)p'9؇EboqVG6p/@p 8GYKK!SIlgcZ8qxumj &tɾo4bx@`ۇMub~Oq5t}},OE|UFW^dpl⺺}8pS7S=ESk4k(׷qo:iЛq:J;ra8ݟ@~ U_|7jpp L u\3^s ԋp͙N˹]~K}etv2S1>ߧ3 A}SF.ng1x=C,壿7"ijӌ+wKn]6m6+͓߻/^y }l\Y>Hsac&W6Je$y `9ϑ  8yS߬1s8:zO"3{C<;}3~xȕWwC6h_?Ku| Oi|*6$W]9f}L7z>,yepQnIudj5s綮P8CVfu %ze/‡L}ǎ|"Pw2㡔Il Fd ˹#7fqc+m'rO{xH=Ci:.>'Cl?%xI@քOC ٻ^@OНQϾ 6P11k45qtn{ZpLD<["/c,Jcߘ*۲Oo堲bMS9sp wxS|6~*cU}IwșBCZC}?{F|?}uDqMx]?Di.- lzٸܻkry"/gc;ɭOdvxf>G32r8^b*7W?9 ND5v)\Mt~+x[vfΞʙM Y/d&!71Ɖ+ؿt-nj1Ua ِO#"=#&eEY>s>qܖ#𚲿sG ~Ӝygp6n2㿮2ڥqNʬwZ8|YE2{r+?o)7?D2Yy~|˲h96Lq. MyMo`^;6{T6Vɝ+DpY)ty1p]Op}KΟ;'k|-Wt"}4{_n\O)>GVчK"^BK߁vB=3%;7r׼@ugH3k8Q45Hk4WC6aHZ _uHGr[.Cu71w6ǟJq=~"X>_:mΩk5g)\_'TXGŸ?3-7g?ˮ:SE"D::e|D3~ c+yyE9_8<ےgОn4U/f9uFS?l-[7d{Svo_O?x u5+.}M~u?k 0>֟}>'8l5_meml_K<ൖ;SUw\I,k| "WZN='Ϟǵ a|oM ʸlnɵ$|+#M |7>K|R79\9ՂAAC>-.>&#\O_3œJ7d=I^30Ʒ>k}"7>G>Uu0]Tԇ5G3NuMmf{dpE\^h:#?p-?}ٽySn}*5sg}$fݡ\lR^\{+<\6qj?l7?7"1wѳ6ȴ$@ҟQNR=ma`s#_9t\Y8 w!*(quN1{& :;"OE ~qi{?Dfc#A?*0`bY|f>/sg>}޿q(ټk;  Pi+ {?!>r|U/㘦kM ';rv8VDWNMbƞUcϋ|[2|R\yF?%.?-/=!=8Pv:hx{<# &R~[FOx2;E.9mɝPv9gdz'ph;hDUkd[\ߕWd3O>. =a'O|ڥ/_C iHP;˘+n37/ȋ!2|ynno({{k o]sWS/٧!zU/ԅ[ $?T^x"}׾-WC VGhbjmCN$/=)Ǟѓ/&8,>&w>yOͺ#uC'pxt]r7dd4xm|ߓٝf%]t=W4kLhܣm\~2suw]w.\r벶s O4o@g#8#_lY{~a=v)9yZ^7 dW7 ;ɍUGO"}S_5>%]yI6.?#gŋ|2; I+1י%~Y! ^,K3ڲ|f[ h@[,bٮnURK-GRZo̚Ya4[H]'@0Hs;ߎsL0wqavر'"\CFeNkjBj3jɩWjOͨ;3vvUeU;xl٪ZrCf 82@#Klvq(9xӾ^mWifuaevN+KKZ[Z`v4}@:U`̶Ԗ}Z-LtAUnw.w5e}ڟ\][=j袞Q0M=4z¬cFL{- wH[ 6p>ò߬jUf6jfQÅ]?xuʲQG ܤ$]O uϙ^ aF׷ƬW]{#oQ5羣{}{j1igb盶܏#anB*Ehq>.76dŧUu58}\}>_OV.1eaM7؋,f7/<[w?Ϝ*iTN|Sȁgm>Ylawqj\w;uTgb9Y4B/Ǝώ5Y*좊lu_Z}r_v -ZFjGwPSP5ˊiZFgtGF݇ڧ魻ՖN?e53CήSpT nz'4}mb-{Պ}Ϳ> ìyVri9i3K;Y)3ÚVyfӰ~bBu^sWYή+r>Ta{ȹLqJu0Z!fU`f~{5Tz6:ݫiͺiaC)3۾=b{.t\jя Kn {咜2 BqL@f1]­Ю}Ro՜W`.}j]Zk<3~\klUY햵غfxT^H{ݲLcSiMӹ^h%կrN_eOJ~_}IK5A(O_9Jt>ƌ4,Zq6eYn!7n7]jUa3TiGQbs! j58`֮_Fj }Ul9Sߛޢ6nq{>깝vU*8`z]{,_'mvpN~e\sKڭW5zupEڛZXN:qe.Q׺i[֡,ܞC&feK&#AM͜%ꀥhPcݟ̗zo4t{4p?,fZxصiݺfYZChf~,Mچ=/Hb?$d7 +?yvi{(Ytw׷~FjQM_N:ύVu-,L] ^[vcF12r9uf6u~ZoGǗ֤Uf[2;і`!] 硍ș֥~ga#f{g7AވR#fJ^ :7OH,ꖏhݟ+UW'fnhYSbnZ'Ֆz~H4q8n_}'ᄎ=bDTMg}5::D?4j#iޏcwq߷B9nSōxoRO+c&0 L~z&0Q\9?+Ú"03k)!4-6}q.VU,2<%9lYg n:x>7Oj5l6!}u6}Ι ><ޮ^j\k~[ieZӪˆqN00!~2IFæpy=K]#Sޥ~4hpxΧ}ty?yY91lV=8^pAzs:9ܦڪڮn0c3C Vdicnԛq݃†C1.#mH 0V̈́S`Tz,sx0 A1d!Fgu}5=Q# ^ {}5N-Cs*ȏ圂Q4=W7^:oZϨ S0 )$i\ I=Ѳ/TQ.U-4ƴxUsR} e偶VWiz媺33X.ͧJ  cR]د>' Qk-yF;bĉ icHOK7爍UКS;tzA5ݦܴeÒl쫓KG, \c_tq_lSӪuj4wYܮjW}l0xp1 |쟁[.VG}_[&L:KaϲWߦ?lRhڜ0ct$? aFlQ|^r]ݬY"y4eJJGGhQI{Ry4C"yӜ̼yiLO`l]wrzżxG;]~<+<'5_Ujy]b[UX꒽*5cΨSLH܁A=,'m|Jә-f3d,dY}>pt {-甶9uS:>S[>qniNr4-G'XG^4/K22m XS2ZENBg8Ş1AƋK8ucPV:TM9)ĉjj1Ai&,c9#SkYv6_F,-8L)~ew5/Vvu|޶5w'ϫuc]s$7)AC/2]y?qha]. ~PWZ K@}Rx'(KxgsΨ  qN9H{?c.>9}}Ο}Ѭ㊦=3y )KK>L WW}[K2Gln?vh8y.udӂ̗|5Hk>-]{1ۊ%-Ƒ83Fdy}cp̍ 1+|7@:.Uח烚Ձa>R@n+ R\c6|]wz~{,蛊sXSk-@_Tn}Q:9zAO[4~WZD}U׳<⁠=4]3Iho|Do s;TGxǝ*o8_^#{]V}^񳺟AwSFJ5cz `^w{*34*R[@Ƌ/RI jl|nfe|dCor>jj8Δ52|NH(kg*epPX h]2=lQ cyKTnV҂bbBclcS"%ǥ3oH^^Nx5;9x8U|AvǒFSMm<_-W\1 Z V4[ ,Vt|vf{V7 ej28Gj]=4_t]0T]SqпdM{a-UK*wU0Mp48M]$Qw< .inazƯ<ݨ/bvTwQQ+N~lP>b0/]zy<*=s qHZ&iMz s%w:/sHad# :')L}oєߩZJn-cTm 5~D99d9_ b͸oxrWt]uߙ~$w㘟rȋ'*>=i/PӌOVR}qL`&95 L`xo Ϗsj'#YSIۥX^8 +GöǵTDz[C׎Q/b+;S#_Ru ڈ%0:?fj`(hT_ͷ!I~SW.=Uo^R}vFm JUz-U4ƘBZ^=j*@xft\ΫTVuX><j [Th̹ohǨzG2|Mz+3~Y4;n~;T8P:A}o5tݡ I^™cRأ$ʁ# /S] Ң벃t@3Nt䰺= s8xj^|qE8)9#.]RfVO Kn -n?Z~a7}Ի{')CvjC?_F@M2&Gm&d_\QSSZ}q Ĥ!\)/̱afR'I 8p0LtUs;9_j̨#Y-~:u0,]UcUޒy uMGJ0> 6Z;OeWZ8UJ_D-HPqjt)XK+1b-̙׫F|uno*/TsWKwTW~KކnuF݁z/J,KGT  \nmUPOiZ,I =T0.Tw]33_zT݇YB:I _O[<= 1hZP,%m**/TXe=Ps1XWījf[s\fӊ0c1>BPzUݦZv*:[oS"F{}0/ijްoo5K m[\PX=dL_ q\gv]bA"@Eu*~JextC:U{XjY=ۈl"H+GӖ(?;H=_l W}Yl߅N2gȺ S)w¥qU*a~ /_k6i܇v rL`& MS&01J<09rNm/xv甯 W9U[yKgy8o GtSĬɘwI|J)c3wW}F3oAgeҙ=0^UyxRҪOJ+Gw,L^x0_vޭBI*t>,+x`C1.5@^,-cw^U7{0X13l(t*W5u Γ)BZ}QZ]VoEb&/:,3;2NXMwqZtKk53.\qPm$-u/97zq O}m)zKZt:mRfVJ̾0+Nᰙ˃%ޭ$k9O}3Tm}p9:i%]yy! x Lɔdz:0S }6r_a\O3.wm^~L3G-ٴ1\2?rHgt㇬ IQT]ͣ/ho: fL#fRmT5hPak㑯k?K-* WU+4coJAg2vtmbY0,lvc_v3úzd6a"5< Y*$;ؐ ̢B?bD[?6Nj_!3%km:=֑:9z>7WTwq*ֻ-ͩ_n}v4uEE8KZ{Z=gR4z]52 'N\YѠ!KvZ Nzy뙚}cʏAp|7Z=JoC dNn}=YFޢ{+pMY`X\?Ϊa忴QeN] "sH# rt GIKnSӲy{OR?H êy wra*.Q*:x*n3j_fO8VIV['\]n/Zm :7BR,<۵Kknq Β†Gp[0)8ݖ1tcNܶgWs>w-ìWK#*v%Xf;zbYXQYt#,Mw r<B>a_ߠni8_WViamZN#֦L`&pY&0 L<+Si Njp[| #I 3/0J#%=00h| mV;+'c9#R14ttU\z!XWףܥ!{5%wNP`@>2>FI·gaAyJQ>#j=oZ\\--=um|'-1G!4?| Ywy_PDžo,.:^̓y@Ia4e>$NbI:!ǡk~gGcHz,Hz8z3٦1̂Y=|KCEpLQH4r~!̞qzaNQC\!@8ԭ _)yYemzeaH҅8c&==^hxƜN8 *7|ξ*v g7[8m1O& G9t:H2XV̫Z7_Y?e+Fi5uT*xά}ص[C,Q֏<eNze'2e?tmycI똍CZ9n;=tKO1 8csktȽdMͲ<`D$z$֝uYK (ipc1tؐ#wa٪98@svM,&KDZ,S>@D?g g%ިj"CDaDP.[龃=SHpru?~v5}l{ E1Ɨ?'@T Qp[s߼U-[}/eE8FcVq<7rT E@?Yb&^̴y|0R=Z//j!(\Bv3|`{eJ;QuޓY2",j}IAU7hQYC>rTrUW}+QZ >;H$,q%f)3eNZwT>z.j>l׫qȷہ>X @97>]newڒ6 ӺiUf3^JxX)9Exah~1vQ{Rpimʛ&1,8DTJlq]*-j`y_Ϩ,2{85W-#~foWzR;+Ŭpd4}DFoiۘɎgzE: 1ts,iX1m,i&0z L`&p1uO1hKCRO@9j ԌJ3P'b@sƒV}@~]zei}<8p1HȐ1Aj8aN?Ӵ` |VhƘM%LtU-.16" 5dyd0مOm*ft}DfcB2ϗ=x-AX r~[pxöfm=f2702"wa$Qf8TLN1$֋O+*vB..{נZ{G|C$1C 1ROYtjs!iyRaگ}úX7/.,s\9ӳf<2 ˘Ōn/VU+.դ1ktmm"}Rx@a;J7'ugIu"^;9$0Us9oҮ|V'J3Zcd(I*5_Poߕ>w)>p02WPQl*S##Orggņ%uT+%lT2C*L[qPVgzM5θ?{Vp،wbh >ZKj]̂-mi}ӏ }/})>92 $1TkG:;7X 3NνeAewpBiqÖm".nF#}~!ǒB軘}S L`гL`&0 B>B4=,z1!, ca.djZ7=߹|2Ja@JJX}G a)8A/n0*~RUנ4cc;]2^~V3O8  M0M-p^LW!2sFqt zXdvEUJ\Y1ܴG0DS/88xjJkxS"dbM✍^r:.@oS@(yZK$(DF6p {35̮=br˒SdB,nHVnH#Iiro1TFۈRk_Rw ~0>#eͰ=U82=Q}E]8Y008yִNQXv~nmtےshAi Qg Ui)I%LG&AY݃kA= cy{ )3e QfdpnY3/|Y¾a}Y>Opnǐ|m 7yWHt@i8lz-_QQ՟]T{@;9/Y+kG?t%˙ S>\ĉvcn`h[;Î+#v;vsݏ0 % GvGQg87<@I;K?3s=k^tJUj۬: kh3ވXT+nc؋ukcV~=tC];{VW9iCGjzٹܷaS"eGҠr^* W[,[w.w13yU+C&itCB:2Pmh[{{~os(oM?l_1rn-#I r72[U^If!YUY7OK5O 8bZ/\^m5GG52,x4C!:YFY޿w8v}Q8S&Yq)#r8ihiS~Veڲ]K/X^^}ٌ6y#O m:z:,Ǭ#wQnL'Cj&0 L`M!e&0 L` ٠ R,\W,I6:;~Q{,TwM.,W|9UT,wU"8|id2`p th{XB+~ןXhaX˘a|{fDH.e'\/MWz aU8F%\?uȊeȳ`Ȍ/ uzS"q*6IDATNE0:5 s༒FVy"0Q^28f=82ˣvAOVKmF02^ (1-kY*q_ Xz~1PKh,n/nCr3U쪷zL75\gE_>6 Lj@p|[k,X/f p d5 M~BnCtUp)A\e¤W1I*$h`H85;%1Nr3DLg>CHe)4(8˝{9]\ssVeQ5Umn:EB3g\QN-ўPBWtUY_V'beb:T }N^*5h}]~{᭿aٝ7Dx_t`d8NTO>B!>` 'fpz~GcJ$[d&!y ̜=uzH|.65]\;v4IgB?#L<31oMWݤҜj5tmUˤyD;?Gk}FZf7xl-/)61 '0 L`ߘ&0 L`1 @0AY:/?5'Yk?Vu!0I $alciAO1ahJ!ƄaܨxHbwZOHo>Fwo`XQgzD 'Y,]5<8LXQ g`C#xi ~v;, l<Ȑe{p[ʾ 7_Ue .IRVXU2 ˣ=H #cS*g9KB|>@;e0Ϝ=1HetfRzAgיL#R5 qD.k'>N縡"p^ej`jJ:KGc;6Nƚy#*|3[FMG[Htӆ+䩏,qo0ed(Q8n8kfUh룖sfRmqcc񶳤Hs(qв_70O*3܎p,Wa+y w,fH ~PB7t,*lk_XFbY5ݱr6>nu1xW֝*laߙnc&M,QTҬuٔ ]à.ݲ}M;/齬3g^^{G=狆:8MxJ[)H,;T|cVs^Dp(Eb2CP35u|\z4sLcІ/s{)HטArA ֫kit~Œv{89!7TaT> >>7 uɐc9=Fʑ&뇅rLrYDjҿd st';IHu_6%6߿ҭ(͟/d=5 ?7>e}?KFf02AzqY Q@zq% ,U3q@^t8v˳y~SO7!='>5-^{kj1G34aD'pH{y1ì Ym薗c '_ʓ~^vS'\oF1zL*.3n͵&3yXdJ4 1*CqoSdiCH3,rV׵w|+t]5??ua?f ˋY6CkϪL::%ˈi( v!|9pq欬bf, mf^o&seANg3xFG,_Y;1!RҐ#N D=9q,)L z:̀{=> FD,X_ٍ .R u:,+Y%1;i;fq/Tof^Қt)e&8cv$T`dQ|nH>K!kKo>-9$P;~IYF?}D-r~V.s{I}lh`6j7"aP#*)a8)ϴNK=1 ;E huwXΓ6ĐSd#U99-K:Sq:=y4b<0#rBYi'03m=s_ߤ?Kߺ=wW?'E\4F@&c yđ2-=L?r@OÒ3j|Iayp2Ӷ*5Զ޲'/-)KgT#X(K?>PٻjҊD/8|<6EFd,@5^;)&0 L.M`&0 @Ł-NaWzW>̊n j#oaNwgl6N䧯mIK }\Kv|Ў_kH;v=_Os>w#k:UjlOyυ9QEhM.SV1\dz/ <22nFGsɜG%T,i蟖$ۼLz?o;ÄnqģH^ף#NzL=O {V13(ڝ%8|tmJKV 2wY2 Ch!fA=;tE07lg1%wػ)6UW1[wWsl㙦u Յbɣ!X'! |Y7̣[NukjsN:Fn$)nqJb. ?0djoAy1s*xINgs1HO8VTYv ,OQG-a!:O2!'!e76,i#N>|=ޕ暄ꉯI|Uï3-~?)3|@=@MdYX%*/n9pYw@>!-˛sR4^L#݁)_G0Q/mT8>y97Pٷ!s_;K/Zp(Qbr:^}w/TQ=fF-+#lfYbݣ*aQ|1'c Mpǖբ|S~:(TI١!e*:wUkI8)*L@NSMҵ(W0wd[:Vjm >\p"#tYffxEŃߐKsvEMhW$*3˰β|'1MukpTţ.V}*>/\x1yiLgajbyt=ڍk^v:ayNfxZ ˚nӪl {>=r-+"H™rw8AMo˥2j> >%O`&p9.&0 L ^>bKFn #@C Clb.8xVm bvR a aib@Ae\:Dʸ-5 Xxnx}FDҠ~|Ӏ>B8x~w|X* T cx9GKKAP˓P BTt5)橤c.( C7+60Ќ3dca΅H&qHܭΨU9d:) }PU냊@?_UE˃zEt[IOݢNwZjuzecg[]m[vhQ|[&p ˲׹ח oMf 3e9bR ioaY⪵*-gm ?!X%si9Ei|cI4sQB05g2a 38̘lK Ke'(HS)B8}+jX_Bo>C3x֏p^7U~+vrbVXqN ᘣ '† /1յ.=pb̄uGx1Ցa9sf]s/ީOvD]C,N1KR > *ΪMymb҃^9_NtnDEɞgcw8\ü׮A#vt8bdߟ 3o|V9~ 23ļ.;]Hm!"-NevNv?7a}k"^sBnrE8+˂ԒI4(v Qu)aɥS:LgF\NC7hi՚D7BFrAfL0S%kILVȀ@ y!Ԉ~p,@ϖ-ZطϲSxr \^SGՓ*UŁ䤘U:C3rνj uTf=>nJM/KK7ƑC)]Rˢ[]?EwN뽮^-c 9xEO)Tzle4`VJ!2ey[Gq⺛y렪WyU^4o]81Y2=Jcm}A%za=̉o[;@`"Ƞ~fVI_/ȗ (t8@!gϒy9N`Ǚ&0 L`Yh1hcp㷡0@dsry f5wGHblvxw ?)|OO7G4&ȍNh5tNEsL#,9"`)a4ˉdyƽ}e!ρ1k~EmUuOI~ k״+h,32>N̟ 4q&#Uu꒴tTjQ́qW.Wl2~v!G!:}J6i6cΰF:+9i1CgV)oEh;&dk:B׎|\ohvU9xs{ԟZT:A~r2 %.N8vAzc"3D pu,Kѐg|}1uV<)ؓ} *.W\MxBF*fzX;Y\Y8K=h3 L`e&0 L``1h+T|}ѡ+ZM:_tfPAV,Kݎ'9k AKAZY w#;B*oB'%O 3 w.qxQ̒K3ލ |0TdLu~c@vNjyN{PPPU/cO#{}ryZ$ru na+uz%7TCb\s?]&dل(.-x3,n-g0`fep?qĺ7gǡ:8&94]R*iViqoj⵷[~ZNy[//f&@:R[uS0_璘 iñtΙM8hzD>i-O0Myy~,K‘08o>Zm7d]`1'RRM!q3`fW!i⣑\7Br6 %x> ϩϼN/D!,2>* TgnF2a.FD1YX߫[7v-[rEy^mXOYG5}7K~AM_;ju #@>Σda+fYXt bKZR -3%`;ÏF"Kڰ_ڮhxZS/i/vot=.?[ثvjZw|~Fwr¸yA&AqvM S&Ojry0'*@+BTfQJ3MigZhۺ#hHoaXU _*276TRs|rBY㥆V|}_Ӷ}5/~gU~i-g3!A/g yC̶[9x5o)$3#2.@SȦ Xp}^R/[SiD]((?36Z*.iSK85twė9z0{蓢})vDI&0 L`4 L`.bh8˰`|={5 :S킛!lߪ {ο017s/sHȋDO?;n vy$ їqG%#[h xp~,;9gб_ǒy,j4cY90Nuj}UHk;26MIu]'幌OFM40ahۮgs,}c2'UQ>(URmT_pj4_ZIҭ>YU?4L_I55qDr`wc.7Зz=uZe:?7HE@ʽVq?pSX|Ea)|oM/<f/9FNЏ.1] f"YPI/7^fᑏgCy+,ZŘLCd$r3y-iD}p%A~td<3,)ĘREqbo'6/mF:|ZO-U?K*miOpfuQCȄLI DzNaT^CnRo^]+CM}Դq ~p s>;?!$[?C mFFzlXs՜f6C-1[!, 葖0W+p~ߥ{U*E-|y#_Ҏ{>5JHS1>ӄq\X) S}m4{}Z٭¬3 =3KZQsGh3QhT|O1=d e!~]BI8xim& ?#o&0 qc2Bhp 690puGq l/`F̢RN%|͓n 1(zx 3H 8%xkkUpTā0#nFՎI"FV5Sb4 7F.r\qgf{}$\Kpdĝha*L煵,Zs vK*@bUmմ10Ny^N^ž;T<Un}7?/vhǾڝQ{6vߨZ/ŦZ4* HoDqlwqTŬ{<Kl2#G&Bղ<:rO],Gw"/ 94c6ɿ{[*_YW}Lm7xa^KNsPjuUkZoWk wݬ~uc~Aq[jS>[L99faSRXg7\͝K! 9lnx4WSݥReN]sa[omxF1e ~5Y1^?]pd9I4P.CLv0[>ޝ2RDR@b2xY6B&0 L`mO`&P2x_2cy ,-q<@Ā0f0#piC=lXW߃˘ un \*O`@NÇƂ ̤c 0gC Ɏ9$ oSy&8BaCUoh7W#uKW˾ʷUx*-}=o|{Ӿ~!sܞ15%UHvr]nX%ۥAiF郿Ov~hm&]AmZ}VʋZ6F8||7&cRx҃Yg鰁e9#cΎ5ދ]ٛ< \Mĵd0B¬1@b8ڭ6 /$[ }cLi#>6xyUpJ 캜X Re*;-b'E#i i713_^ǹ<)ѧ9ЄoL*"/썕k3#Jn+}k>{G;_kWYŻ~K[ᵟRoߠ!uխQ]24ejOf,#c8Ϯ!HLbv2ӶH7rnSǫ'\wUTc 0;t8U}96+ jLqQ+=jmAwicϝoioW:k.] gi[0ě*2>]Unj3ŬD`b/8\UEۡay"<^9a<{#v*sV 9^ y}\s-*گN e@J82OPxmTfEO$ҋ% IǼg ဈZ?a3i?#-h]$G?oF/җc q_I{cߕ|Xd1Ś)7 i41.}*}z/kڏLUOߤ#tvTiz@k}jۼ{PAvN;z702R"G{Bac"|Vq/r=:^|TWq}83]7]|z' z,d`xtMfbp01;C*9c 6<;u&'˘ƒZ% 2̗ɗbPrAˀc6TML)̦]ZBY0fw%dI} 8!(+f Uq^j앮OWUԾ:}z}Q֯ӫn+׮[:YڧmYޫvq,n53aG5eDGy'++ yhd?#̲`Ol7ONS|8SgJ8oHKOI/Yw?5_K|P ^7a,iT~uVzP5Z^37mP_g>[]zsCv # _'AIh¸)m1λjO;Ȱ_w NWր%WѱSi/x:`yH&)'$=,VN=+=ǏHg׷֤ew,gDf&, 7Lü[uS{tWG7ؖۢoj1[Wչ=j3iãrCXGo"0gy xΞq[,/7-|Vv\SS{[,ɻzeü3ձ!v;"uC0 9@(q 8˩Ij& yxAGCo]s}kc:i;Isʋ^KY6?1J>OZQeΑk24XG?9X3 UTSiRSsakkQԟ.e}//MLDpN.r,G3MwxҮ2>~RT-u45T'ߍSV /$4SV|bėsg%K^ K)RNb9P~Y>;֑=Sܷ9 L`@M`&~B>p. t2e@6it yͯeFm( b̬4҇gyM {xI1Lb(i-cvq⹑/y=#5_wc 0Q4{#Dj= iWaČ1L%l`$+F~l@3xq]楝w_W힏ki1P1#n9*S:h^jVUT ᇤDzJ]KÚ#ѝ|Af:y1iEm11=H3=xv9tŐ=`yhqJqXR Y왊~ p {.%l3d\83rQky')67, GnKk8u?t3r}JJьY14 yF' ҆'A,=Xqu%~'U*K”C`UU9KE);c4y]"ǐ, 'ݪ}RQo!-Mmr& y8=JmMUښ)9[jzJ'TK o}YZyK"QGaQ 4Ց~sGyy1Mx<<(uy#*WzUMtAsSW:\cdBX ƩJ KڦUtԔ|LedZ29nV*#֣cCO;*}jw.gwKFBgCK)ʇBEw wk_}D_ b=JT@"%sH3W/232QGuN91~?j{_{>$d^e|Vf?|ZvVs0 0[k<ݳ[=闑'(jhyiog}}]T&0Ksz L`~V %dAXacH&G;2fCpAAwT:]\R8'ܚh/qQ$42ƨs3^oSnV?btӧ{R1&TUٶqD`P)$ȏ QcHD08fQ'/+뺏XwܰdՓl*P8I!0Ѐ}~yM{[x<3ro8$L_26 eQ6NoWc_P骻֬Yb?̈֌s)O\XQRJ7ÏH/> =u忔_%ԃ$=ՇA.3CXQ'#O<tEG* yKDYyː"gLD$F ,Dȟl3kIؤ{ik{e?ߢ ڽQh>̞Xp~>ɻKH&MT8 i,t[7퓿-F*[+YfC$ #ʃ <2?{|BսשE,Uyp +l6Kz>hidԲjg^Tԓ*}Dk?Z_Z?WD"=\)10!6.DgWl\pv?pA'Qc_8f\ τ̶H9AX:C_c ZjU*wO j>U\Gf1fQQ jYN[Ҿ뮏h{9:2yQʅ@6U)lu{j?Zk?w=o;ZQ#̿w5toc s j= WWuz+syTttǟҺ_&=mׅ16NXVWgp֎w'^zu^K3;48pfnAn1%SW:s;,Gput]R}%# &l([J,ƷaJq̓ֆJ,EƷ$Zhu1 vArZ&f F9>4s! #McVvuܠ἟l18 Axcdvպ˶L3NVs.}_H?INw׵up^΢/R.Sc^PQnH6ޏt-=`~*0[Utj˯j܃j=B+O?U%~Yբɔu$PJcQK~{77 2=R?#H7"屸㰣JoUIQaҏbe wS_5oN:)]9-j9mC;N)%-Wu^ohev|=3ڬt:)ggfVTX{Sפo+Ao/>_wϿO}4~G%sÀ>i;,}/}Gk~Tn50_#$S{ /ڵc6uG>VK<<\<-ǏO[:lL,P^vnd0ZkݚNtVi~Q”΀Z$I|? )M)ƺh}S.o?S{V:`]*P+M~^o}GzY͕;m-kJ8Xl(*u)Y=D=0s>k}X~,H)wX4:xrr&0 {&0 @2lC.6|iL1 ǒJG|IZ;2 KQj{{jdh`4 vud6(4,} rff%(~)8!8sjG XP\Eǣ] LG:oA%]8#\@c>G # r*>U{f m󾂐(x ߩ7]5_}++nnm*I3I" (\ _;}A?ǵ|;USϛf;O3^/'!_L(0.]7q;,|=: Cc14O6ibY&D9ܮ yoUuAgYoUѭ.zj\VmxFz)/ߗG_҃1?_zIZ{O;u7NSJ-xofL ȏ9i,UwΕs.n9 E? c|x=>-}k`]JeM4([̻p!D 6z Jqz!oK2 G~ afטr<Ū:amV3{VB(y8 zJ<|}Y8T\hdBR.h]YЁtM)9F뭪,Eڡi[oWynնns|N8,Is|( i[I;eSԱnSy}; :QkAVomԃ(=gS)=M7$xҪ ϨXm*F`g|s }= Yt=D5{e14B|Q(Z6y, +g!d5jžNF:O*3.ȿ)6bVl {|HHwĄI8]O>}W#Z?}Ww$-U_~MjnrX L7ƮmWԩiEK(Qt~LooMlE _ 8_ϾJ8JȉkVyTEc}x>eC|#A6ݳf_{M=qߜļƢFQ3zsНr9N<Y-'kMs^UWsBa֛ip٨ͫ* _\rsH*/5,׷|H[?u~]ͬ#p];QwWT :kNoLo) |{6KEĬ0s n>TXb @2xG!'ņUy6cfh^3 L` O`&3 hsۛ`tINsbGJh0TcaFXxnT*֋_>"HK45w|z6;%?H!!#scK2A%"y9L6iٜMH$"u)XJq+~!{&46N-᠛aaE`(v`cy1Z^44hdN^|DYJ;f1 fuAߡ|HFF HMOLv?x97h9` )'?p _yN"% YD;,S!Qv $.?];n<+)<+ ?F\-i3꓃!; 8 FFțn)#-_1!<8\k0C:Uh:)??.xF:sZq[vޕ|R /E#u -%sŹݾ07@1s":VK=0GI~7%L-˜'ߞnr.1_Em9pPzpa{; 'Fnd68fG!S}eiAe ˴mJK> ם gi/Էwi}T"MG8,2YpQ| uy06jϔoh81]s+Ŭf~fIq25[q'8l $b;LMR֏jP[} 8q󠩆Kg|;-c3Nk mv˾95eD]UbL7`tYgE g.F48N"P,Ք_Z8hH?- 6\r7dw™Ԭi7r2bh "뾏i#'?Z38mՈ|Y+=U7;hUy 78ów힙Azz}}5`+EC׵49e[G}u僫6?\J~[,/-{@<ˆw0Id2"J!8>Y/hxӁ܃J'^bb3oYliRڎr\c<#-H` 7Z8^ QGs(eecW DXyf٭OSNQ_м+iXi3*\7Ѥt a 3Tg3ЗNd\}A@]81'hZ61A\'^PKXjДElf|EwጅA!Q+ Y޲7C)f\]kժl/XhΩ؟VePW+~H(+KA~n;0 Sm7`"c.SN_ScUПJG3iLQL %Z^wv;Y\&K;Ypck%#;6 /S pPN T,e2ąqNJqpjt6tq*2ˎ ˥q~!g۸5UL9m~YԬWOZ֙e[/Z&'|@~EzGn.n f *,h[խY6 ʮGzi2m B)8dGz$į>ɚNA~Ѳqa,;"ө}v}}|J!cwMs1&d*܆reIܪqZ3:wȽwng7.PͿ#ų3 BO-/Tqc6g? I,rLe7gbҭj}5ZUb:mΊi+Z?~{#gUt !#= Z2AJ0Fd׼0kpfC >-,MܦUS9rf7.'qnvp)v ix)sێR&0 LR`&0 L|2>xIFuXW4չ|paND aGͯeJ YhmY檆̢<a\Bcn ɘ*%=~eWٱm8q``mR]w3 OH˅#z/D :~00N}sLfW_r8+?i|LWT{òik2= tv[-5\&Rl saX|g_'0?ڍo2pu#8I3be0Pr@Yq9K4UyH WffS.#iSY:ꌴ{",m m {8꓾Ticɜ5-Fn U¡!sвd'{%;f!ۙo $G'ׄ3٨Ly! LhQs3<,f}Vܔw>9 BF\2h%M%v'QCׇIlk$Gq1wN^AzBo*`[In;ӋvɁI*8G/B%$(h $N`F89,V_PmǾXF+JDdVjS천"v! G]r 1tU]kK徏QGD,t~; f '8!r1wΡ=N槾FAaC/w򒂩6J=1#0=") yBTż?ڤ0RYRd S̬$'Pdܡ΀:AOd||vz;yqM5|;ŀ%!e)~ʖ +u=.+qJzpuqi7AeJ8Ryn>'R U"sځoFGb4 t*2 wRTqUfoF1e4粮|S/ ^tv tPqr^U.zrW}26AR|E*I]By U2nCn`#Z2a!5&0 Lr}}&0 L n~2 #-i̽Y^ xH3O7wφ4gY4I-ѕ0(\wj-+KĴ 4ȠېG{[7[dı1S)ϪzCc6|0p,=x0`; y8ŒOWa_V^^}\#fN1tZ-{Ը#Re"̨Ƭ\l}1@KXBt+ $ ذyzv 9✢|Uɛsbػ81 ^Xk˼}?ig8VAb5=E"?W5i^ƸΪ/1Gm01kְK Ȩq'a t7SҎGܔYv!O},1uv6%~HNx)23n2ڑP\)c; BoeZHRX>uWqa9CS,c-,3?5Bb?8VujF9N!*s:3L7׫oU_TcpXn躟Z:QOK7~V dO3w(#IS\>pYo p?G_zMyCFuSw#~~~tK{oTjìp˜8Yn-|Og#Qծy@.rFK$I+8ȡO]cjA'aM=ƹ-8mGj#NtuѮh)~g4b"' fJ}wk^s\&0 c&=åq0I&~|QX |g<>F(z% ڭ& {-Wi'ɳ͛v [1]>yA&mݧ}xgxR~}Ro2gROYK&wʔRJX!'~ [ W64ʶCuý*]oY"z 8ŷqCB^Om +<7ado 1;?|rb<9dN’߹mm8S7I&X04 8}8#+O$ҊD8(;5F@YQs΢O9j:m@2F9+?g)] o ycQ;gfn 2C옗i ,+ʉ#+݌Lif.Kcᘹs2J#`Pǝ*xSsE;y[H:KyK0J'1C%S/fˮr!Ř9^ߪ{Uڔ@~HiCwTlo+r 9駺f}#ϨҏSr?ᘓ|N kk679F ֎g;;bT2CV`MWE&dmj̶Aw^] xJ+O,p9]}v2BN#L-)D>+DӌwgQ 3P8-/hsUտ=u5s]&llFq樂iL,_:uDzIKn#\ :̣nQ)(qV_|2 KPI={^mY2[QB[lM,>Hggo~wt೿Em~I>TwŸE4_v|w3?ۺsS;ebmQu sɀAk\=e_U~ȚyiW*oH=$fBۯ=*~1}0A*Vhv;_^ey9 Huƌby&$8%Kk M^py9=؜wm;4|2JJk$;P$0Ug$`JE}~,7"w&0 CL`&>0 b`AD=c\F4|Dq`pXaonh< 019ם]w~%[Yا}WE d_.ƕs؟UZ~-F<y߹?@R $.&}NKb9qT.ϥ7sRro]o( ޚj Jo`@8`NU׉ޔjh-F-(b%dLIyx.ArLe2GHRU3S3Ҏ74^Kif0MHRd xp!q:6@70lv,͢Is \L|R@c ň XK_2=.5fq C߶WF^ДSCSſ8B|92N6at8 !*ֺ] ֯ӗYhZUmN̾-Gm˹1h,:IHϘtVD+u^uZR2KWDL[pUKY΢lYFdyyْ#Wb Ã7K{oZyZ#%hlj^F^{HjM~(s`7n/ӭ Zf@%!#sPAR%` [4sQ%m'Ni3|R.o^|ML_p|?ULOZv0 EP$ HEˊ5d5Ŭ:NCЍN2K8o^r#WS殾I=7!\ߥgzO1j ]" C7lbVsk*r c~e(+ u%c_Һ&i]Y㜦v/\^5v]4>KOG$dF?$)XG\sV_Δp^Mwjm9Sz.m3ZqݦK`hTe4b^ϝS4e9C)O|ҷ*,Ƈ, au}w z%!iUz(25}E3^s{H_QyBW~uiu׽HVHq]+.QeK Z!Q s6AЋBk1q ۗ}FIAت8srL9">iaެ&~ 7w#y˓2/WȐ0^U޺7Kȅe92=V[oB ڧq]y6 L`&0 L`@ .ǵk0Dx?CCNm#X\ ֵo5e1 ;sLr,dv_{9~i=-b>.A1Pm*!U],3g5|";h9p1Ns1@ˏ;!r"Ǖ6dpG0T)W/Oi4ʼοwR1;H= 'v1|0oOTaTHcĘc˅ QP#p<> gFڲC©aae68>^aE0tǁ'}<(oeWP1j9qp9&HtF wiMϒ<j<1#uQbGKX }CoQ>GuPxʐg&T<˜=E,ӻáKTCZ-K^LgǪim*V8jM4a6CFb G'U?rD#Mv(M ߀vh䣄gSs5?0,v5v]]h8˭2ia0ԙOIE‘W3*m{n,[1G;t5FffDw$qO]TKhAG0' ^\,Cd޲KuPm hOU%fAGη!>Ģ#iSv*5yWͻU0GӡӛkZ;}JZ=ZII|ҙc'*[>Ψ_ۦIC84Gqt=QO5!,grD C*s/?#+MDt&yR_m2~;4vW4=XS}ZS+֭K~f('TdZkmLvx5)F* fl |?-G3 ҋ:I)ɨJ{NswXﲪq5]֒vj$k^͑k Waဦ֠|"á/M/[o>SZq&0Kz L`?`ȏ4qۘuM!1:a@A*?,2s¹a%NZ0x7t97KK'Ŧa,8zE9(k=_G ՉF~/i@~NtGո:Rn_Rcl7%y*:nG|,ahȬ ?3bP%8)Fq_eiPDOPSoF*8 9&8]ӇoKO~MMت}6/ϨY]Pkfw[~oJ7}XDWVZ-i05Z2|Xit# ;|*]SkNMTG>i~]ں_!9N(#`pPeP€Ƀf)5!Yf[^v7J;nr;fqbEvfss2q`]2ps^aD9{U/rZGM z-Cs);iCi!3?KS@pγK %DZz)jڙ5}=l[X7,>>952{ gNWɁ~]~&!L 'au;yZ 3Ѷ|MtcHܢv+θz\NW7|i T[#3TN ) RWwCwۿ~c> ZBAsr*nc۴%] EtKZҩh U7$I. $㰼s*Zh?,w=1qбzjjyJSo|Õ,rhu[,n4Jha*dz u#݂}$nJ-)Գl\n=fT_(zbSoI/=׳ % oOz؂tƯN=ݐcd 6h#jC]mvT^y]מi陯 u.M'0 L`x8O&0 L=pd0S0N_p17V887 ȏyrm1 6  ?D(st6 ,+i#k AUt4Z*\?\r4ys ~YfoZAqM|7-Ypyq9x{ K}}l  A%lZdvEP8!B~^$ZI2e !@`uf̂=[ݵowwܺuNu}*f<;{9ԨYg*z\كcxL2@̺N]$TC\';h܈5c(](0*QK{txMW xFU⠒;66WF8+~X笟1+mz`ze?Q!$z:BgP܅L b<\ǖ2CC=ß m5xpA rȤ*VlV,,^'=w7f~D>4H~G>PH% gpin9sX4h{ӌKfЮ 3>7(F6Lq+o VjXm):˳M%g .&YI\F~vfD;#3̑Gęf=}ٱCyBp$mWYoK_<f2|`8} X Cs8p@Z/(g#*[4Tn2!(j;A.aʞ{xa=9eld^.8VE΅Ŏ`L8y?~ʓ>Ozɚ3YyU4 {8:S?7 YV+aw w?h !ײqR%^(C{#Vfx=_dRx94oeoGvPfuo`hޔe֒2o"Xw{8cNO[VjÏi_f-Hk6^4\{Kxŵbq3J%Mɘ;+1meIc#ӑ/!{Kw- ҆˪})^=rod{R=t "aڒU(ZA/:)F6΃Ԑ8Ҳfav.zjq%8^Aeg;ڡ|oO ߴ]7 ̆w} '*)G  .g̞Ϳπ@ nE3E+_X5vWٮV d#~rsƸHULZtzH[Z)3C6_S;~rPR(ha:ޗlhU.u81thi|XLo-@A{o_tצЎ ; =!: }tDA= Ct^6d.@)Z ލ{c&cfZuej>4dD}6xK*bzݠ\1kUYW HLL2q n$Jv9Ce# O=C˳33\6bnu>@YSiNea!$rrC[nh=أ䃨'PXgC0Z 9 ੬#IzFI`q)|B&|r+o_c(b%&qk:8fЯ=nql kGQÅ&=pd9h_5L'X ڑuAOΆ%u!MUчއ±~h4,7.V8Ga_HY&uaxcS7gvě}Tׂ4:<xzQS*t]'c$)hm衏Ro$'l,^lspKHz2r646h.b3kKm.X__U[B/p|2x\-*Omitf;2ۇ=$qKc{q>:K9anwsj{/'ۃ笆J.nd|0w}ew:W-+b+72k-"bL4˕m6k3>m6}ǐ&]|y}GOY_&3*_`~jwC_P2:¨)4<;Nr'QfC`͉Ӷxgm.i)q|tҨ4"iMԚ|? ҇zY3ߠ2 C%7<zGz8*;Z96fo䥤6%*jy檿[_Lf%wY$P2 eհ>kf}i١=6~~I#79~D~fv310 7F>dv/X,/}YjC6Ī0Q_tjP}3o«?YkqXCZpTrʗALQĜ IuU>ׂUYE˖gpNO~rA>!M'kk'ҏŷitE zOQ6_=siE*6iz)N%g5 ߅axlON֪<%kVyӪEfj3xELy˦Sͦ@3=ZAWμt 0m梍Tmm?J2 Zé<K::}g9 }r• o}P չ\>;d]V,sbKͥ}e![Z }iTBhC5++R3Jp-9cҩECt ̓6q-}CUYr4&D!q\ʌM~lc?<2C ?r 7kNu/}è#'i=llۍk 6Vl7Mջ8$p,ɺ|fG.7yp)y]CUg<[0(FMlJ2y|>D_Aa}2g$y<ʬ }K?piK na|)"dci3d6B-_h-"Z w~ $Dž|Bu#CVܹcqxpژ 3*>(=zq6ؖ.2,=?nErC.2~yW)[m(ǭ5rXjaknF{c}>l]ڍs;e ww[zQp\>b|pZ| y–i\,]o >=n}ƪ[}Əe܄-\`9.ʿ/BeŘ˾ea>/bߏe:Jܫ^k$6Ƞ1.{\~K~vl*}c[U6p^}Zo>řxZBqp]u B!n8ۏx/2{߂8G$k6L bwÏHaPij4HTq,|ܜ'FECj_s~sSfV8Ua-5l1cW~h3_C• ="^ҟIxZ8΋|Ζ23a +^t/[8`i*v[sSJVei~$G~i_z^cOg*̪]ڿJ[58|JZ6[?9U*\*]9tSKfAvCv7lOl}tKo71mfm;mɯ c816VʪWl-^eeԟ_}}؂XnM;2hP8^A،eюGsVīvZj tu|a i *@gOYnQ %T-kY%WCqvrz|.f&bikr }&x?҃:zB7^CI 6ؘy2a%3gX!b? pP@{-7w"lG#=8ۤ`{ ej]_=d53 H{:$i?6?~i?i;]sO-_Z[fݏKsrPfq-7bcr%=c?sZ() /uN BViJ֖V,B&23V"/v/O ?>fD WѠE:.wFFNbXG{(dWMeQy3!|Fvч,7DE;t(71E+Dbm/eo< ޕ*H=zewݖRd9CCx ?ƚя؏S.r<﵁#l\/Z2c7?qԿ*íB9 7[G3oH9}sYtg4uf_1/@ݴ ʚyZ8"C=FX#wSa-`0 ʼn_'O#|ʖv)β=33/Omg֧1ޤ/ò7Hv͐u#w􍸓}.yMt_ vA x8Ŏ 47Mq1^&y5`lW*8.gy QBy}yf@ }k6qPej8D9Ǩ\,cIKϜ敷l'm 1hs plw2_Oq]7pp6S2s4!kYcBCesn-A<oQ>mk4Zxt K|"|.yqE<Fw-K*p-[|?鏀 W-7N!fVV[6uJ#Ƭ f!"ӂxN](P5y-FR1,eR8N}dk•%<\/Zvg.!좥 <7l6{ǸgQa)IƩ_6ITv[62ֿ1{8f\&9fg.-r*BCة dVeY?c?MKQƯ4!7=k"-w!:`}qnI;z^ڿ~j7ITN$9]R$64,DАor +v@,gOuofSn-M%O&c)36 _a58.Be/ɠ-3}pT@3nmQTa]^3A=y~QO'2~>{~[*3{F;BYJ_xZK6Z$\RbJ, Vcij8ed-lHOn_'~DTb =kílS }@~6WdC)MYcjf^RiK,JO cl~h|F%T(7|# yQ_7Qn])֮`w#7QGSe_y&xEta%t!I~\& P8;4pViױ_D_ 8FJIQA4.Wfl:mZzX- ]Dխܐem]7j ҒA-Y:Ƒ:8hzv_Cd*v̤ny%Qay琗,'{{lzf(VBETQѷfP.t`$T!+agڰ&ǚ v#%`4 sBҵ9K_OEM̊V2C3蕃DbCOG*€7Py;'_NS),) \y>wOb#X4Ϟ*@a˯ܹW-z%nwyKk:5䥁SeM*% )gZqj{/o<?44I-ӱ r,D:g)U&Q5)I}r+hqfSgmk6,-"$+ava xx2|R3Ol9:sD{.M _ayF'PPkU9;EDXZQ@lE_gGQV*36tegf/Y7OL;*͒4| yK m!/6v&s:n&1y9tJlvҩ0m}mV_֏{1dg|4[hsZWN?a9&!:Q@=7v5ہ|.MPA3L Z (*. x>g9 bjQf 'G,ge4oP)6oc-. SM^D]jy qO*-z>gϙDݱ3ST,ZȌjT$_x iB\z:X [mp馜UZ92V?.F-^lJ-O7" ooĸ$dv8V梿d1IL'ai? gSh0;p Yv4Q)PO};ܿj{5rRc5;Yn~:M *־t^xӑ눧׳>ZڹWr!xb@_r,wY~|5=}\sykYvhIx}IPICXaeڀH5gPwEˌ|wڮV{N3t#VPYhՉ֘4120(5/fsoe|/t\*8LӍ`6qZ e`4Ƈ,Ck=R-q˚zZNXsd? }&/yy-2g4;pp<ҖG?562ϭ9yΫj9oU('MQ.l[6\ʠ<ƭ*ˑaQGglԝ7+[i܈6'[B),{Ǘ*bu/7؀k}lSݸ׆!CJupvPlG!e ch4b0}:¿a>qOMzEʎük=pl+C;m3;z²[qˎW@LB`?a +Ӏ8jBN)![FP/@@aGS0RޤX͕Fx>>3`8>[mtmц V9νo~u|y7!׮Ö%4&fXT>.CxޖxZ6bH#cQB"oƥe7Ƥ5&OW C21\igCwyG}A/ KA*%ɥlazZ˒K"! XN#-sT<kPڼYi+O^4N^VWLBS53͌[fq u2t o(3?CT>g q%s  zpMW$Ltml~r%+N< /߆<Ϙ]9. EنD =$q* d.4H92 }I)[V JhU4Qls6Zd!M!/5sF^46ޜ:_W]ݳƥza&2PKKy. Zʋ|ehH?m ¨-/+eFA#M̫OOspC{w7oZ #?u d$SY'Б,*eF ўK6V_*W  1gli3׍sVZ}QLʨӥ|7||JY%W޲X6ԇGq(GVuy@pJT/= tTffEz{C91>.wJz+Z?zf/=B )(r_2~"`d=}c+[l0֎J6Ѧ^򢎲1?[QI3qe"Ӂro TJhl.>kfkq,.+﫠^4ї7nc,e7oKB.!,c̬ Uf!.,mGʇe:ö,r%)y}*ju2ec6[ɿ2_mA;z!Qǟ5Y.RL(8ZFޣ=73V 됇/;tU*!7769-!px/ED1֫g=3aY]0FJA>#Ԯ[H៳!{1e}y>b :Z%yz0.Գa`͢M٠Fl}B`\L;§\i˖/›6o=rO)+r%BG=Y3Yxl~ !Q#+5~mmna:gSצp22F!Kف` K5hҜpr~fS~#-!w;sIj; 'ç,uVba#8D,6G斎ظa=%)+wƷ8Ͼ} W^koap8@xq[Ȅ^xh]nNA.6-=(b:οq+`!5LdgUQYצGXcg~2ۼH@ǸԕI+hKբ-ꇄw4.&;U/f=0rnمBU)![UGnl#f{Oǭ*/pxyk<E[⎇L %]c˘qWJ# 4.d2;5wo*ăZk>,1wɖ gh q sDƄsff07/T6>S Q|PJ(6mK]xf5^z*(h:f"~7Qi@eCڳ#t4xJo`)?T^'ԟ,2"@>d-sױVqTFԫV}I+On @V.!ȧ`0- *8h<@wZ8@2)3wK aTsoYEcE:ɺ9v$3IRxkN? TN N(Z"t`ATH67[B}avFa KYqZ, m߷ b3%nq=A騼bY3oW86لe3sц^ 姾ff/>^%4=t&݉N63a6-d?|c%4at18*Y,mN9d6_]FR<6j{5%?kcљ\ovFE0xyH??~ku ?n<}( I[J<_0 @s6pޮ<6ΡٷBaKCp/WmX5E-ƿ9PW#..>+8Jy:Pť6Z9)OS0v0B`8p*LY3[Bm؇ yW{ h!'>]W`լa?OM>ѐ}=2>m+oX-PE0VI"%K^hⲙL#-(()n/P>g}WבD>0bY 3txȇ>T\eFjS6pƦ+h3/&gVrq?ݸē:,}ȿT%͢y0.ˈku (sx ##id*OL7 q1lM.WYt(x1F;;`LXu}[|0fA9#wJuJk*gmШViр u{U o c2)8BqF+_a<28fPkq>Z2Ͽk7<>RFx'6gs>}sˋn O83mlM8ԍ]R&ꞷ6Jدq0\Vߵ#'oxo^Ipq"sSqԿO{e3,eH;d[@8rK/8F 8;M?f/Kc\50}e1&˚mЧ?* C0b`ٮ8Z Ԣ^'?3!99e1DN2q_rU{lhk!Wumu߿"޾X\f\#IX~[gSlO2}Pi/X Ξc ,}?űn?QhO3,8wMi+/`Լ-eomeuKR_A9}x}_p{#3 wqe[2T S* iYaw\9?`'ݧƷ :kS^=[n?k~~ Kئ6AHSTP @e g G=wYͯL2Um-py֦}I囒@DCC3TDL%م3fSȇKD%aPd25.P*X*jsY}MU~59&-ȇ':>7pjS6XfF藅H{X=_4?Ў[E9*wC#olQiO7S>mhg44ϼdW^|ڪ?gkpΎ=6zVh\&1Cq EA)buBH밡•X_eՠ~6q9(%RNn*F4Ba֭膡 73 QQ813b=mltSSj=k`n/n,?n1\Mysn)6˶z[kq2` i?spr73(Ҙqe|{9st0 pLR/߷kM.1p'"_8jG|+QVƆƒͽ$9 O00tVm>zI-z8Oq6dh,Z5w+?#3!g8Qv*]Aø-pjF8v,?epr1鏰 8c禭ui/A^ч`?]1'kx0l>ƾUirV=M? 쐩 MuSCǰ LMYujWlllo3~{/^ӎ_6&rM_Ƹ'm} ?hdC'qX3(dzoYmvꬳפCs8G?u~u߱~gh_:oyMnkhG|5ERwr‚#snC8psm Om>->q* YΞhb7gY=~m$q-ہvX9ϽD 9^GqM/lphE-y4UᩄUÍsqtIi}@ oYmo:ko|E8tB!t#B^8pdyoжv|l9 2 iKq޸Fh}؆?]lo"h\ʋx`U /ǃ*SŽG쀥Uy c-ʈL ng=X߀*gxn\h67t .E|%KխяZ_RC)46vp鴽l9*6>cT$M#﵅LRȪQhCap挝7]aCHy> \l9sŷ6_VɎYoTŊYY}YJȇD|^-VOcSKeFpt>b62f}}r| Oe\e;o<1?du{=VoY0zUW:h \D>M] {;ɦμk[8EF򩓵RKpJ`p%H5;l{M-kP'lDAr2*S,ZeQw eMe_Z 3ʷ` / M,Rdig%@!$1$\oelleQG(OHHkieiyRX9+.^974#]^.u~߰++K6V~);c"3u2?Tx2{2OCV/_xlS_T~UfU.W]byږ^y"\;.Y94g}{lݶ<qfZhKsϾc#%Ts~mCjFA7̏i-~[a̷eyY%*)E0vݶN[2ԺZogJ欯1osZQAݮwY]8bfۚWj??WӵL' c|~ggɡ~pvmpav ܠRe /Kp)B.uf8mIc<Ɗ~#a4L=4YycR6\mﳁ_忹\o(_%{O-A醁a];2H߅}+۷E3>yn@~p6WeiɲK.5OdxTk#/)_h=`F򣾗8_erKDz)2$ 89;A[#Ǭ +!!-~FW{?ryeKSo=2r' ʐפ-Їm}%̾|j)y{\j,ƩWoFpT`xf}K߆}O9 p7uBĘlP?hZR|yu}f;XjQcAGlqp T*7a{l/,3g0žOc= p'8O#~s;_=__"Qظӑ?nQ+WUqdq?1P |qُ/$ѣO{풳?i;%ԡ}0lE8Deӽޠ\i59g?ײɟO"K%@,_V!1|l B!VOKphPi8au<?oC SkqZ1GI<<[? *$1 W᳌q* i)dh)TT`K%E!Ɖs. 6>SIa~Q s:s\ƍ%Ʃq-7IsRhBCo;PDvKPM}W.?pͥϸT*yK7|9&~WǕ;*(;Vav1f#!ɀrVZ@,Kil,):AZP6~KQIJʄS@_q-gn 3!#`=~@yG8nyO’΁"'h, 8򈆳,- B?n~(VF:W^d6Bzs*=vKtm4\׌ߓ4^?1t[^: {{Eee90]\qxuc?s'q>ߜ Ǐ* y d{9?yK8oQ͆ cž̍( 7T",خsiϢoeff.08˞q6Ie{%~g`96qy2`guhs ^ <s uGDhjL#cD_!c`;XRh- h %.FlUP?~ n<43{k 8!( ic1m:Ң+(;J9gy!_.xFJA"L@̼} m vL ǻNԙs#1XxQC h7($Ρ׹ ߬4Kt eFkZ ď&Цx>V>s/3xGj`N2Ro\rW)3hi^,c k=QftlLft|6L+`ED),/Okg~!SFʐipm9`>H[;O;mb]gGבεclq#S3}&#s V{ZfQKoDU證{gME=ǽ{8n-! !741B!-+®j-*;,ōl-^!}Ϛ׺ߎă~ﺊr?fA XzXxq ~J/>6שj5~J o\"RM$0d^p?,eQ4Wq̍p42]|)%^A^w4f1r' (Qnpp9 xoP?w:F&`V8e;r9ܧVQyǽldG7Yث;r0t!B Suo[뵈m:}ɼehX پ?Jxș<ޙ8.Ka5axIl3r )}6[Xm |1`P?}SmIoȱecB!0![>p3IE(PO^'k% l|jsjD2>FA;8ȇy.DLJl._DF:a8\C\j+P!!IFc/~jjimyVްgj*\IˇYʌ_TtRglUYy} #yMb7]`bN3pe3&c-+(p. %_Q# )>e_ώE([X1^PAD7 "mrv$TQ y*xu,*\!pBcv[pp-t#ۍ+'q̍o'u3Xǘ:β[ZEƶ¶& ":\{ۄRS9wnzٸ\ qECߐp2[kgThQiϓlL{dڨiI^AZ[Z-a1hl*Q^ѓ~0OgM^S/Kxc 51̅t 풃nO2 "-ng87pǰwdX9["r ~uHߍ}}qsQ? 0m0Se՗*&3|68o7̳iiyҁk}.~<ʵWA Fy8 /h(qpM K z`Y^AئN>*ᘊHK6d86)!siU@9;x# _l3|ÉWx avcHB P.FBHYnd>a8Zؗӱo*zKamC40x|KY\ζ)q"D g RW BTbej qqb.7nLa˸܁xöM07Ap #~Q ^ym9E }l%`Rr|`ǯ~o!mX jBqF!pNnʏ]l6@./D?\:clx8d|/W\/=LLqؗa|}\BGƏYN|AW5~цCɅ,4ӱnSqsϺr&k׏sXw3܏.osBT1 ]8: >Q|y,&κo5 qFedd~+W#Af*9_*0zj$WC u%%3 ;ut\6:b'm<fe̝ޣQr< ֯ oˆ2GpWh'B_M%r&brvm؞iHa_cߘ# Kx~É?n [[i!_@3| R1Հ/zºZHp.q$:[di U MqٮOp SnOF<2y+93(_4gsJJ6~;wu(N\@Xְ +: 8>ƺ\k=&2ư}g ?"jx=eckG{3I(OtJ{~:nt<.BPNUfuIбǘb] ~[Wx,䰍_a]F)^~I!78 ![ 8I$ۏ;+x6Muk])WTxS+E>k.+X_bK|E{e+jn:Tem\V-!#O|"M׸h?Z'n$Û0( h4wGc2j b O6[[hC0vzvee<%;nXJ׮u[ 蔄"a? #o9'*xs%Q|kn.)2i MC\o=a<˃`8.I >o[r{9?GgwOQ iK;hnNDA:bbRQ3?S)>aFBuWx+~>"Nbu51xv: BD-3XvHLJBB؋ q?ҖcGHR6NgYXy: 8bn D?q{} (1c\5^BE:{gVj%Igaǻ8pOFN>]g u帖C.\H30ev?cY_tqA #YNgt(8GW?>N|J7EV{0#G:SchFiũ_P4;f[}~Fq2C6c܆mYIZT\ #0т?̰o*u߻md)dSG~>n=·QŸ:mh օ3.n7c;5vJ1]1lczX(e_/EW\~\$7$4%X<˹03 (}Yґ/]6c E]7JNIHlɥ_Use~[~ȳgZ!8)iq#!֐3HڝՉyѝ7t$lYCB6NOGߠo:L!s\Ά6P1T c5Tl '}o.|mo?ZJe M,ݬZQ”YiB*CV3̓1XIƤx;{ukpP1 tǴ.Dt#H{N?ˎB GS]̊zAwM".&Y=0Ep~tV՛LgyY(Qx}LZu;Bo|F_:26R"tzuݍNJ[HĆp/@]0m&GfGppa~8ꇒcn9p]~X;ˆ\$f m=1:GXFˀ0 ɷquVTrA?yJw!SLϵ\D֐b9ӶQk$U:3}o#u*lFts_!5w+B!M1(G\lJ1 fSfXVL:o+ڹ;׬^Y1Js&ZƍS~x4mw:n3 F`%T2K6qu3l]59m}U%Ce- n>!eF\qF>Eo]LD[T#l+ǰY8YYCwΣke Ysݡ:Y| akȮcCfg ZtZI\u0.: z`vF'DL B!n2N !7(H?zlj*fq2ktmr޿1}ye7liCئG߬{lq[Z8lpmV\+kg-ϰtmX]fQY1۰n bf~[XImwn9h6Ag]^ !wEB!b:p5e2MrMZzZ6zyVuW "V1öjEgp=Igf}5hfegx{Ȳ6=_z 7_m݆p-gL]ug5RZXvnk|**x),?R#{hSVae-,_KV~[fS5fR*}?sHۯS JV(W! œ//+}m U?xvku8:qgz@=zX7Zƻ.j5ufA7˗lxx`WiB!nAY BO#3lș=+feYMV4jYzdk.UhClβ~?b{X5UfƖk5zeyo,WdY;_3{ ~R[+1!=-Gf7-K3o,m64׫Vk[-Ur-˒é,_挥f^ O}썧qeKN|ſnzx8HDS͝/F5F q-HgLAL͵$oZt(fG3rB!v+-'B؍t֬\3b?mk Y+a&οᐶf+cFպ-UkVlaL~A+ QOeL ֜x.=MKqbV7^х+t"r[bmRb=tݎ^鼞[|uyB;B!z0 c3 3۹ϲ;,V3RlsT.|oc$U$U8\g K-ZYqqcV?hUhh7h`hJJqXuR+֚9cvU pg͖&*[2kTZ.P"F7B!B!f"BC8qTrְY,;Gkvf};{hЬg|r0фժYl6slװ=ߝe˦jaFV<2J !B!B^!BC1T47  2۱p,_4wp1gTioWνfV2k,5pU>.5-Ӫ׬ݲDA!B!B!n62N !o+`.D9i8hq.0*쓎RE{m oSn Z)B!B!7iB¡7pѾi@mJYO[?#Ieus+M5ZpAlM+)ny]+EÕ~!B!BAm4TB!Dψd]7uߔ.x̧ V B!B!oTIK%B$#27)`7 ~-v.L꫄B!B!=/!BFbr|=m\O!B!B[~B!ok" S{+B!B!ĭK| [!|wՌQM8͜B!B!.2N !ێՌRhB!B!.2N !B!B!BoN !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!Bkݭc{e{ɞB!TO$B!B!۝֢SB!B!B!g8%B!B!B!zSB!B!B!g8%B!B!B!zSB!B!B!gZaW!B!B!BfN !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!B!B!B!2N !B!B!B!odO!B!B!sH®;wηsg>-B!B!B)L_lV8+ߪ !B!Bq3Ν;_f? ܿN~ČəNt}ǁ ~G|x;ac]C*B!B!ĭCalw&{Bܚ3:-Z:Mt-ײx>C/!B!B!~*JA/})XɗHn.kLmnSլK7c㸜_',B!B!VBCe"ԗQN?dOSn ,[WrXr7jks-CfP !B!Bz/SEZvϜ|{w7k̩v/Z}Sݰ`qXo&+Vp旸>icAŲ]?MMM}sK|l͆yᱭfOz\m}mE<[[nF$B!B[bn.Ft !w̩N4tVխj]֛N.=dzɓɯWZ M~]K/d>hkЈs}ٱcǒ#ׇFOɯHQ`GZ/~ɯy쓟dK!B!#՗[A/ZQG<Μ]#/߮Sowmwrw̩N43h0h<ь٪7%8{?R]lhD?SwG AZƢո0qx-! w+fP DF8qoyFkBcW4L}_uÈeǣ,ZCfP !B!B,:]B8;;^~8Qyf Sʿ/^y] F}YM36bl_* Tԧ|Y8[˾(r%hP>aL_g '3K!B!Na+^D3:Z|yN`YTCƼf S$ֵՌN\oΞN#R'3f||wލ| +V4xO<zrD#S4bE63}J!B!N@zO!n.2N \NеyLߵf Setڎ3m!ߔm'7zfDe!kYH]ү̎,ӧOgkEֳ^4E#Vd=3b!K!B!w|Iz36f$nqf#4,EStk K܈lfp !B!/IS<"5u۝o|8~K3LrTq-dZw젭D#v6ҭZ{d/] 4>^r`Ku.ǙKfEh|S#B!B^q-Sd5?nC5Qj=[RߦL[7^ǷU8 _ֆF/}KRo O}KcG}W췣7sk5ndI/| v1hAO~F\~;{UB!B!zu΀ⲄC32Nmd|>ZODC E3h~46q𢁊36kHB!B!lAu($Z3z3qjh<uMlgntjl6|ӊ363kj=vٙW7m-!B!B;Or!֏S7-k@y$nEr{7Xi<\P!B!B^5x털qj݊4q]VX4ft=n${,:~\fYY͵YdB!B!:xdo%|b&ٻy"!n&2NmhpчwgigmzǓ٨F\R}1zP7sIO${ki=B!B!n_ͥ6fNP73$ߑ19c'_zcǮZqq+#QJk#< lul?%{o} ]kYе$klk#B!B!n_:J1,m /}߀?z=θ~q'!:RF6n5ZS.${kfԧ>n${-'{+ht#K}_ZM+xOӾ6k:eG!B!wf5?nC#G>׵j-ΙW n+9w wu|[S E\͖1V;jofl<`=?Agۿ^~y~Q a8Ѩ]PsKH4}k_㈆x8+W/||g.tp,Ѡ&B!B; QV!;7A4DQG̼{%%!nWRp{q#Vµf܉\+iۨ;[}zߤNgVmv4]k)=g*MMMƤG};LFM~]Z74(Ps#3 ?__WC'?WKΑ(ZЀ"B!Bۋї ^ƥnn_|=?B37O\NuyQ\z ^o4X2{km7 뾖36b"4Ps)B#E3>f 9:aF^0ExرcڵdB!B!S򗿜ŝfN%PGK|ѼU-zs{v&.B!B!ї y%^˷c-4s @2L]lvU72V+ω'|+ÔB!B!/wڱi֔ӸgNi`>ne^ݪIjkr$B!B!n;JV ~/}KG72[?뷻zzVzUwqߕQj}poK)ttr?=}K!B!Bl8uխV6S3NI/zEZQ !B!B$* 뱞Z!B!B!ݑqJ ~,Q)!B!B!w2N !B!B!Bq[sJ!B!B!Bl/dB!B!B!=C)!B!B!B3dB!B!B!=C)!B!B!B3dB!B!B!=C)!B!B!B3dB!B!B!=C)!B!B!B3dB!B!B!=C)!B!B!B3dB!B!B!=C)!B!B!B3dB!B!B!=36g2IENDB`Light.GuardClauses-12.0.0/Images/xunit-DeserializeTestCaseError-TestExplorer.PNG000066400000000000000000004711011470750352700275240ustar00rootroot00000000000000PNG  IHDR!q.sRGBgAMA a pHYseIDATx^ tU,,,_47i#1&ʕ+ ^I+lx LadF$ "D S  apzV}N:u$dxgaԼw߽_=l6f6Cf쐘!flvHfl6;$fal63l6Bl6f !l6fCb6f!O>oflG1'3l6ͮ1'!=fl6 !l6fCb6f!1Cf쐘!flvHfl6;$fal63l6Bl6f !l6fCb6f!1Cf!WfuWBl6f= 8lm]7Cf!; !ʭax_/O`OMalv2b{Uv`}o[zfuҾŵB-*I(}+kgen[SfamY[:N!3XV l;3l6_ rwWr$@Ë}3K0Á!ј|vT !l6]-+uw^]Dj@ !&faic돫5ZrwW=HM! !l6]1-w{u Dj@uBzz{Y% !'l6yFpu!_8nr࿐q?]kO6ͮ"5 dyw^t_j>Y16ni}n0!퀢 bu Yi B앿A c~d/ RBr5eRS!`_@78*{ҿ+V}j c%-p oNejg8qT֎}8WusA3(V9ہA l6f5eO  ![ NM-JwpJլ;`A\]Z t Ew뺹d;$6f5`m<6Wu @kD$x {ū핮Mm^J[e:u(3ݟ#O6ͮiA$- l_a T#U79ڠy+ 68@l^!&/l6XVf7Y!M+F-nB<[q0acƌQ=e^'N0&خc\|[v,] r5" !l67n)t? iH٢ATS0?Ŧ}'NیXamTwizbpuCͮ DnݺeϚvGo!mX>tDϜ@˳ Bo|Kl b>GkXfauc ={-$/^ոz .4gMN@pABpa\0\}9C]0fMmhfդH0\ BCnBH_QlCoЛou%xO6Hu4=s;Cͮ^S((l=Dom^MNAH׷0!GHAwW7ݥu;&Q_gL[>fR_f>P[=P\|t=i4~#GWSBq BzuU8zf٬C* >jÌ2}x2C]l쎡Q0f}m&Ol;S ~{OvoR  Ϯ.0&Adg +Tx$6WmK':c%d78@m̺h[{b dS%3 y N]B=3ͮ~\a4 l]i1U l=OD< ɥoؠaŸB!r 70.m\ ]gLÓŒV9|3}fƖql=Ӂ=9[[f1>4bl]2߻w D<N@"65䭷Ž̩`C  @3+so"z0io][찡NjSw'-2/x;ysg4 åQ0J1 clW7!WB d;R@\G?ܓ*?OX+`.AT@$5S`[fq)`<ࠇ,ӮafWQ1W^5ݷ?փ/Bs nb@(ZE'Sl"Umnh3aļ=핺;H1HA;vz{ 5ė]K&@uB%ϘfVޠ!PB1ۮ6NCfGE 4RF d l1ߥ빳ٶS B$4yW!z3١s}r=fkUx6f&U$|ԖS>@U_9Jo0#K./֥s0 ! !lv0]\/ lDYEmd̚5i?aq uT٢z8`>d:}iB`>@F 1Vf_~<˸@m<7S- F{Z8|"Uߘ%@mrfR^BJ^jxL6f&Sl6&l"u@ BjCoq]ڸ;m[,c>ʌl6]փH]r`~m<ߥ7Sl6:MQ $XzOq` uT6f;@H[?6…ٺݲK aT6f; $zl݆3l6Bl6f !l6fC*@H?fl6۝Bl6f !l6fCb6f!1Cf8(//[o^y9/弜7Ay@o'y9/弜<b<6f Al6nfal63l6eCf:"fv"l6fBl6fAl6nfal63l6eFP bX,K*"bX,%bX,+$ X,bbX,+$baX,T0 bXAUP!DbX,K*`y@@73X,r@bX,Q !,bB"bXA ӨEg3X,2 /;cX,ŒbaX,BX,bbaX,1X, dCbX*"bX,%bX,+$ X,bbX,+$baX,T0 WkNf5,qXVP!DU7ŕP?Ū)1+-NUS 궸jgX5%:͠=жDӹs6h/^ضzĕPVmKaOּؖN:(}ے#EfO8DZW: !rÿ^7~}/a{bUUU=>Yr÷߳-5W}3ksT\1-ÆEG0"ԡo(MҾ01Ya5}m;d?^DQJ$+nƴv/۶dG0: !aj:bbrP- އn Q+}qmq\pB,o8e9h$ A(f j2%tѥ}Ks,ҾWqW Bkظ:( pY^_+mZ 3{$}ްmYRJna< 6q NHT.9 ĵUpdaDl`J5dS[=]_!$n+vC[ {mL !fE>+qaׯ*^*{;F9u]=\"Eyy|.Z'~vmcMuk7M˞)wBYm[Z{U7A]]Yykn[q H?-.2!PM;!)J%}{<B.&Arxo7͏ª)B[ D253+&ǵ[;KPvAMmCeOxcFibAl7Q:dڶT BHxZ5u4CHUyVΌGRөkFZb \-BoP#ٖ[X4Vd< M5ݾ|T'Ƙ}hFD>=w?Q 4Qyȹ@E~ B~A { Nkl6ږ8>#x[a7>k^zop%p &j^-kH[fTCE)QaP9d=BGߝ oxe@C/u]˨`ɟ+UM7)=+Ow"[ċAcH7kZ*w9$QI5T2h?~EH@r*~$ q>`۹Xf;o9LӦZD*M^~*\,8y]1m:am]oe?λ+BeyHRi}Z0s1?JE1ܧǖ?KH r*=Śm?zzt- QK}NA/lo mu%4T޾uL3H7;eu˗+XUMǘQlО;bB|wy7GyXϜK(qdHJULML:f{.[˓`M wZ,Ks(AsZC^Na9h94r<ӷzZr.C3Л\I{OT*uBIQncOGvqTSI!ں9xnM BFooҵHBP/2tiK_;Bo:hNՖ纶NCU$F=gTBv tqw391 smQT$cBKZr@ݧ?nGoM=2+]PdˊC|]ܲ B 5C I T>{5>'BO;?=-A5:tnKq->p[^5]kQ!DE$=Å'UUmxk!hxyuˬ;>]ޠLxSU0Uvܾ1/|6Ƶ{w:?ޓH} i|F D L5[+UMɪ9"kyB*/A5(^x[kr@eź#hu?TŞsB ( NH}';"=BlilvnzӃwGLzҽg;91x{P?׵EBH <\ajȹA]zѸĄXO!XRZ4!Q!&SL;A\ ]J `RHY/_ HBo飷v^. Qi^iTC!Nie l:I؇Ϻ)~' f Wb|k;ؒIA좋NS}Ṡ^]sq LU*FBXmCP&ӿ 66~BC8'H)wqtm뇐9X)C*q 6<-{bu={c/{A+y`Ii;!U^*`[o0.4@q#r5 !rٕBLRTsT BH? 8%@ we|" 1&ӿ ~*ϟ@0QpuiR!$EˇaAGIrdӰ`C"J_hCB*GNB5 !tnro.z9p!$_?DGrPrE,Yq+NmKC{"Y]rf ދkv=ǐzw7xQPMu y f?n@A+_|u hT*naU{OE ѵCu${Ƃ !${p#s %nsN`s.\ cRmsˎ͂p/]`{!N X^BIWydA9U_?d>~i3sah"'û4ʥ&!D~Nf>O<|%r7#" \?ZRj2 BtU3jk,äi|VPY;ؖQ?hҬ8L_gqIW鏯MuϥDA磞i/_^>Or\$BqtU.yj{N@&)X-b2R[e=~q'ayNLDeij빘}̶Vu((RBH%G-,8kyK3"f#7((397ȌOh&UƏ44!)7 I}/Dsm=z B Fޛ-$![Bv-!2G(7/Cj &7k.!)cCje>ע黤'Wz7!>7L}tUy2*:ZOqoӶ;6'"3 ؕ#qR_s/nhmK o贞uW%*V/e:O|IөYUSVpU!o,zP ܫx U=a !,AK/bGAy0ŪMޏ0b&tmGz|rϽ0XaXQY˝X,VmҍGfE9;cX5'bX!CbXJi0X, !`,bXRCH ofaX,NAbX,BX,bD !,b*bX,+ *ȃX,bI1X, !,bXF1X, BX,bU2L!bX,VPTcX,Œ  !,b>]|V8(bX, Bab̀ faX, ibX,VAy0bX !,b50A(aX,U{d0CbX Lf@ 3X,d `aX, B:y"y"nv2~?aQp팽bXP ll_f ɑ0yO pHT : uvj;ݲ{v:^^<3Q2 epQ W0_[S0č;N/ο5,E(GwabgE)^MqJlKY 0|پ8tu Bp7B~Do&k_@YEJF̔D55qNw8?5DƲ%ɛuC ![5Q%[Zaڋ0âB#0p`eD5൸XQsARUD|TS ktZuqߞϫmlz3Q+Np]U`xDt$b&bﹽ֍"3^AԤ)qOၙOcr^:7)`H\ bbtnL}{DD;/mm R-,!5UrYěQ B(1dvn" ;~cqUхx.JŰF/^NWzĢ9A\ptVܨy 6@lo|yfX21OdNq쎺/z;=~'?mg$K<iXͪGG98*EٍjABr O۸q8P{[ʍ{RѨ*Xr|93ݸ=RA0TwK`W&w ypugTTjPA0wˈ1Ɣ?'}RR=b !'ވMW]!jN"iGlK f]y. O&`?pM۞o6"rB{V](/ܳ ee-CHR=b BOJBAQmK̀  zg1 $gvC̈́gLrj)CwZrqI1_i`+>$3m,-ѺoRܬF% D}IRP" r`|$DNZ`?,D$\kRSn%"*zގSJc=ѦYcuᑝ:?7 15 WOlDqѶc=eafO@"l;=8L(DY8ru]:/yKhW.mK aAZOѝ* .~Z^ЍGƼs,oMoR@/pFkmQ_-ⰤMp "_(".e,6]vb:]!0k(|q*k~jzf`ut]WAToeYlq܏6hXۏ,flEfwk~1@HXXcČg[YJaLN(lWJpw#9,4jWU.QjI)i*^ߎ9vA5]1;Gt'3 BH:y !"ShT-L ϨJ}w m;oƷ BV!DKssq' d!6- >mHoG WsܷVxbDZG(t"-MQ sHKn"qpwxdrw,htV`EqbSX"w\,H|B}ľAhqk{1!\wmRڮ5 U1z/"!λ RjۥǞytja޴]VZ'\ Sւ@GhGgSG| !|u|,3=74a-GBvRZzZ=f5X=Z["#E ]}7"bELi)ƹԧ~QhLGv˫9r&#ޑbҶ OԃΕ",gr2mLpσDEPDG N= O򋛲s\xQ&V^ĺW(=[]+9mཟ \|s2 BH⹺x ~WrE|v:9- h\H/sWwTc d=avW۽e-_"*iy'? C *|swTΕh@He8ox;kVL Qc&`!= Blp`wi1VTRu˜|QZt%&b%-3uHڼ&غo}4FuA=?9ry54sWn;7]sJ&  !r?URB!'r[CW~?o)6!ع5D/vkLQV;[D~nO=sWA-2&e|AqSz ײ2[w7׋:QwclxŠ;qZ(4 HtdJhj'xMZַ[ l-Z#&Eku fI z|6Nybk;B-f6.Ѷl-]p;gy}}uCHDnr~k֎틬knGYS7v8yj#a۬5V[Fl潝NT"dRu1"h,6WwlioI2JcG5&L<Gj졻I/E9/'mBGru_n[ʽ&uUSWٍXҏҾ"D] !6QkH O@#@bCbCn8W>o_ _Bۇ9.)(/o3f)~y !x'Rl㦟h& BHúu BSevh ݍٝ8"ط*L5!ʉJy4iKnuIv˞6nbk22X}ef7FUȀXK,mn~r#"TgEmDT5!BH2~8zA0Me)!&*h[%Em&"6:W@<ҲKYvWZL}}Z"z,鋃~TS"[B"G?*p+ EVZaBlA(SǍ4Y%x!6 b(6Lbe=2(0rG?o$G먈 !8Fe 9! zڽ聗_oʿ wpf`Ә10[{>ThkhnH{ڈ3:s1qç{caX /Ơ#e8mrP` ѝ4מ BĹ؇>Æat{َ~ K[ >㔧3l-ԖhVul;p4;tolİ3"4ap=!D);Npn'幤 Ay.*dq9.uB{mX  _@ @vC멉"}2k 8 D7?iHomȗqD]!x˛hIbkHCA_B;\g=]t7^8Y1^ypbηV"\\餚@WC]$퓕&RS$yX$8:fKr <@/I)ځlF'բ4f=5v'y# EUitOnB86rB4}ڈ풢m_6t3&D [tg /踎 Y[A|'ze<1@͕xv^XqֶcuxjXX [٩3 qꐬiҖ/;;w{?~CmYZ:Q aVϭ7f` 3Deee8} Ҳ3WG~_:nv2a j2Og>o}R5*BVa/sBZy;.7MBh6%!6exd_,4ۨRQn}jiY~^qݧR !)f´ U'b ؘ=N8J"v2bX"3 'hxy]һ/H>)ŅOO$ fh?3b3~?a$~C֌nƍ;Q^N4"bX!3 B %wC|<6:"nvW<2;t3[w #Oi;f>)[DX,jA(b~>[<ں`Ɠxd{ <4)u]+܍s9FbX2L!D' @-)-S;̮D #AM8Y$}'8 t\/bPf`LBj8r+.8WV E-#aB?oCCHC`e(4QaHB#0pU@'ވh$#"} A3pP/kPz]ٳotkDYмu2F,Eec{-U :Z֘A(V j8,[S|j!S+&>/rDR05C] g2uoRίܪVgv^.P3lF"T((*\6L -Bn]:~Wa#x`Vmſ+T?B1!7522z[`9DѦ,) qz4tg AyZ+N_sSԉƌ`f- dj ԛE'6q?)ؑ{ضOC߳Kf@>D:G׎Gh(s\Prz1 #)5[Mh(q^qw0_"vp~Rq)c7vB rb,8 ҷĝ{ZBbF [A \tn9ь2>U}!-m چBПHnUlT)jEe_ KrM|BץmHoP2{RJQ&'7 RJ۹JkhJ!-tǮ<5VQ=|aYO#UrdAgH/۱_ۯKobؑxy9c|O_'aAg pJ/6)@B wb" VTDtĀoSe~W-oqm_}ʧ/& k=wu\|"i;Yې`=_Zud:i`xCz#HWxOa7-!topki# :SAj)!\GWE~x "؂cGmխ] '7be=6r)|U/=biNf@ BjD:!$a3H|O/^4z,y=YQ| >%_ZR=b(ƵU!V@łaMGUJcsM %u6-Di1n#|/`FArF|x蔂,-eq:WqVȴ,ex 7(z+}uu9 $ ݺ e[h۬>аlqRdg`GYTLJVn4*] ,QgoqoxQTEȎ҂wVs"{Ѳ%Z=(}acbЂ\^BQ=߭Ch-ȳ hC^C疒҂ld,?bo2B05\,ovb]j_S oW&1|gr~9W9t#tIH&nS&m43]k鑙Hh([Qe 9I{-50BnT Bz6\ql瀉hٲ :M;lVqomOQna@ji7+VI)%ؽCH];Y;&AH~ ZiUOWY)EӶG.RA @ZwL2fQN+-uahAT\w'1ibfRbly[sO0[uIXAx|\3D&iD-'mR9&`!踓=x 3$}Zv_=8.8;Mz7؏ 4 <g^XvqO%E"Ûyu@ ttZHcv\t UثV+y#8uPU[?GZdgu+̤X$DK^ +b!>'J $rDcvވIt GG$Bd7>^;Ņl˦6ƴqg@H|HtD(zPmf _ 2p HYwHNjWZĽnͱja.+;8 yMBrry43@7 =-(G~`Ge/@GŅl7˦m^A{|HÅz QJmԮ c卄Nv!}5mNKV?K bC)?j-$-{MǏU$3 |#3 ѥ.R;8smM`Hr\1#&CbBK%p],bݛ;Q!5thjQED eL)VRʣ(wD9?Sӑ}5ԧ|g[GL'y=Yz, ;$뺭wyp&YJ.f+ͺ&s!YWy,I S:b BI^%o{!,Cb[eZw WS]bˡ(1!$dj[8I6 ^ ~P D1Y*>]@R }\,#vA#cz_DL@ȫ_SN]HTTB":p[cxu--䈡okeNƬ B.Lx.cG1ma(.nҰ!d#bEav>;:ĞNPwVA}cŵ:Zd-0RAH19nzx7YDi]˖<.]+}nM{"+Vb h:K(lu Ba!z+8GӶ/}Si۩5$o8y-߶vٍ3;VZYRu@Se䦣x<5*pR#}liup]C<_ߺqrj]7]+HQaVEcAXyo=ˊ+a63k|R8z!$;t8ZR@L?c@bU^^3)9z!zONnikIi{=VÝj B>no< =vbõ r;aq?WFՖ3GG Ba."o_Wn?} (]9kE[NO'MCa~8Fz,_ d3+4 BDw0=A2{>RŃ^ojL=$uǶDCV.*8&*BHU7S=+0!ӱ4W%D+:tV[߂k.C6V1 =uo_QAփ<+a1szc{{l^)CI4Dw\{ !$-5"wcPr!$OCCt] ߱ݐvkVߡ),8(lMғ}Tanצhf~ +%4iK#v-n ӿ6@u؂|+gb̀ fщࠤ;NgHsMcE??%^ ?>wbq[&URMAI!~sH* }'QIZlGj&!&tA1Xɜ,`p8@ɚl,N9Śz\*tS+/&iXb_qc/c9{t IN67V+6$5 )N΢k*ZA+g V2_aJgMcTvdeCz;fmW8g]>#r:>ᚧ=3b݀tao/b[4JwMh̀ Nf1ZCK o}Q΀p3nm2d_3H솘 18H0R 2@SrY3)d94kZFa_L̨ *B纪 !$E%d2UwQn}*yJEIj{8U>☕.mq~,~1rc3 m.2N{g s*T Byi1Jym\MQ'U+D)Enz|qj]KȂc:@-!_Eyݾo|ᵨ%D9TlZlɾ&ѫv@y4g(kHm?c %Bꂨp Mxh;1Q-~!?q6:A(3q9 BX(_෮!Xu]f` 3Z+@һ8r&mgf$p#V%PwM~Hp2a&ܰu> bRBdв B@H]C]s8HQl|]?ޟw6| G7")TbZB0$M{H,V} !D-d #Ewpi?wmFoTs[:3~z n]FEUmIV}Q}hFwTYX$3 B| erY4B`E>ǭ!9ү#(@0/:s`!Ud `aX^Uo 67KxLw|LZb!/ lsy0bX !,b50A(aX,U{dpA@73X,Ud0CbX Lf@L0 b *ȃX, faX, B@bX#3 B|Lyy9*N-JW@ߋaX,VmCH /"ᣲB r+nݾ7/.yRJ0bXZ+3 eCDTX+Vky0tHlꞋ⿿7}on;`bX$30 !`uIfۏ7/G8Qwn=5vB{,%R }MWX, Ba֏ @ 1sG&OLG{<0 sZ;$"bCXaX,VA$2Q7ſNlIxd.atœg 3!>iDNzſmBDX,U+d0CAe8-="w?u6>AHىU>c޵-qE\{D7R̰HtHPPۜ["\sXX8";Ƈ돡3f`Lz+("VE \_o' dyP^ ǵWYSCu P7yc!`H\ bbtnL}DD;/mm; O(ǐٹ00]w k!b+X[XFQp`Hw{;ѶS76h_ՐO)y=۵CZh) &,̂~e !Buj7:3;{#M봝 O_ݥۗc!:a;8׋\(R204t)@\HuKhV!DMx1>o4E2CڶDaP۩L q&Ձ 5FnpyJA(Rk)&nN|>$GM|c{}Qf\su?g>~Ix~_쾀BB3< 4CHwL <;b&>J#^*=ӦW}5mXK,/~:f@ 3Y˭(Wz2![A8= IsECT4(SgOItҡYs$[51P,T!$ M'o4 B䶝0XmX~d(ar,.-(uEFBH.]B =83 rrmۥZ,ieꬪ|!mhoBt"ضOC߳Kf@>DO E&FَWs9oxt.KM4p?X7,# g/"$Hoy-qۼ#)ǿO_LP&Co{ug@}.&a.րdmHo2Ҫ#IT;t/Dۀ!zǷШEw{KGwolr\5 !obڨx44'8el6bxZ*dX}[dEh,"PkZ}N~yö :("Vk%KǑdtb<4+jt߭ym'?/BOڪ"z $f q# bAď#D)=5UӣK qym*ZbFn}_xH3Pz)Y!*K[ >tJi3:#dF_nb2aϭ@mVQhXvX68M) 3Hm 3=8zGf&1JETY۩o@Uxѣ4`/-%ֵۈ-ѺtGq qc ry-R[P>HGo[J:֒26Y}!m!sKIiA62F!D ȉ.y; HQ .5B [EfMc:9rP;9t#tIH 1)ܶZIəԉL$uwry40QΉr"i z9r Y|iIʕ\/P~ Dh4iz "fӕSipqp)XlO My[mi007vwwAS&lB~۠k\GʺDuGmW2"umevV`UF `/l=_!rz ʛBqd#X0p BeS6uƠ=>aCQ4&ij KN9R ch"Zs2R;,azZ+iVob $GXw4\$(W~Pb^  K]$3 !hxv]{}wnr%8mr)(mSl>}D̅ sMCħ=>ۀ! F)ZO B=zQ -TP61 u9 /L湓cX{u'WMm! S_i0JWJZyC(G@[bj:ls$'_ž@ bd]|jIk˽e}OȚuhWuRne!LWDsq[>؜>[@NOI-ǡfŗ7#&S]חb!#uhwyR(MX,ò f*//GYEf4Oא{!_^NH&5L/qs7-}?TTB":p[cxu--䈡okeNY%s]\z /Ż"b"QDMV7#yd@685 l{:CYs[!h1"Hkv!丽_$ g0i]˖<.]+O\;هvc>tѧD޴g` i:O2C= ?],bqO|yOA 衹W)!C}fK#G` $ B֍3V1Zw0 D*l. u{^V\ a̎xX},\/+!١?R}q~>u8灀!6{&1* !fW>zp2K!FUvy/2m*-~3`:"VE!Jn 7'֋26).:w\v?`gGEJ{lBm0S ,Q;aR)/SLcөnrOk2Q;U}M+`sm!~J˿նO;1XpάlejcBL%cZçGXRGN=~q fSi_.EGsE?NC@TgujaԢaS(>< ee%*ԺQLOІ Æd [$"S0}ch&I;})rű-!Uxi"RE ສ!&q^7SACtciv-ZK8߱9WxIQoAv5!E_S d}ঽUj CC\FYjEα&_Ae;`GqZz8&Ks(@ߍ}C< 5v u'P&n,r9)܊;4E} 054뉥'uܮMѨ @VJ-hl9W DQ.`N]Uw"^;0/} V Y>ZAH ![OLhENsKp=3 !uEeeeWv}ME{MQg?a/ߠ^Ÿl6S:"~y+͜ evFm 4TSBR7g,ɎG{=+!v4K6Ym2۱iB4SNeɒ C +Β49Z7EiOrH1zaB~G9&JEUtP([1$9ڐH,^WmHj>ٯSEUF鵂&DWtg [dtd}/fϚ$zʆvrꕯpPQ !|.G+t|5O{fL!ĺZ#yIR7 [Uh[*}5iP]!w*:"Im#{ϻ #?51mbDD!5:r34c%oTCmt~1ȝ0K<>y5̀ fщ7-SrRO4{ C@|SaOI3  5oH+4 BHjMNĵHSFaɞsni&M8e8þlQQ:jլBH\WU!:]L.ͲO%UT~V7iXry'Xe8-.܏ů=Vnt,bF}᲍a"^i,sV*A8/-&T)OBR[-@˴o`4ꤪt(EM}`;.Z_k YpL%>0ִXq-/8p;x6L)@ѫ!N>6N2-<Rf`)2P!D'J4j]-.Sn u<0: W&{d|<) Ǿ_oŪ~@*Ue4A!DAs+Bցôq.UDNNyE7ȿzҾ?V]U졵Ū2`:"VDࠎb1Lq [O@F#`Y]|鎡kAEy9^>Bi}ŪO2P!ăd k@q |ux &m]6_>~,](+$ȰXu] BRgà  eI!J ,ʭ(s 7.*rmm%UT_ $gB2RB|˫E. Ba%a&5 2BUUo 67KxLw|LZb !,b50A0-4BX,j`2`:"bX,+2P!bX&3 !,bj̀ B !,b>A(bX,V2L!bX&30 !`,bB/30BX,j`2P8(REӰ7ckJJNI{Ũ,jߘ}?FbX,VmCH obJ+n^Į3?k1wL1[l_?.Lw,b&A(Fjˆo×俐4/gvCR/Ȝnxr/+a{ŶZbX"3 eC@>KQ@3:$:d$#N:Y]%}1o\,~Y3,Ū 2`:"VH7Ē}uA/qc*xg>D#LB0򠀑aF!1TX,6 B*@H ϮkBP.ֽ[X gڂz|ݣqP{X-VC !BZ7L99=21$r⯸Uz 32]:g>2 a3j\ɟ; ;˛eaªR"Q9tGꈁ:||(Xޫ ECVdc(06X-sƍÁCHL<N'Ԕ̀ Ce,j8}:6h9Al9Eq^_󦀓XZd5dOQZVRίܪ\x7BErY/~VߪQQy>Һ`Һ+X&:7y7i2!\pmM@HqfO놔%qG`RJc۔miӄ!CP DZ%+ʱ08V[A&/VBo߹}f?> K֫jj]2 BG} UB ް9E%mо}7C7nY;ohq~Qy(sw~ !JJ Y.E[uCH!Dbb(^xl>J Vߌ_4ZNe B/o EyݤY Ă<=X|Ƽۈ!HQa]%(cg"mBA.B[6::;S7KԤוõl{ 51VIո Mb Ks;1O !W l{e?TBYUבyu]K8c59?Z#BF#e2X0&'0TBH"/tgvC>'G,^!ѿ~3K+ZN3´[rG_!EmX0K-q)bEٳ 7J*8#;!5c+ (Gv|?$Eێ/#;#u.\1ۗlÂhFuӳqkuZ :#)5/ž`DK_#tN]C%|r@DD[xX[KewNxH#2j s {kJO o$O*YSV WFS6aX8WYt)-i.#Gs)wM?Śd6@XBOr9CHUol+%8\ n,ߋJ)޿vR'}NIWyAjnu:9Z;A(ByH^!4CoLA˩0h0\}ɶ`#.}z<4;f=ĝ(z9*@# c=u҆{ |k.:w Ȅh& ^; iiѵISq)ʙf)hӬSKz0QUS:B+71J;+3PraC?X_(5P}]Pcg >ݍZ O_{鎑iѾk7Š#oW~;o1Hmf_J)9HȡX?۽Mn1)m~3*cd)evhdZ ]n=O$RJyk VaddiϽ6B "nD<BjBY; [o8Dhuz.CH8o2/E ? BiϻeM-MzXKUcBވlj藅[}`ðb $L![k)!79ŶsaO<۷Ur _t¶!W J(g7i-$m|#3 !]4DD>ѥRpۚwW`㯛&UcҴ%}]!'Ĭ>AܿY/_ו=j 4ӅTW8wvnj1M ??Bl$̎i_U_TcBH5KAݾQy樭sfH~" !UW@꼭Bb9{*JRyy>b-QDuy[OA("D@@v|=N{NVQ;,;g󈐮߹3O%jyyzj"0?{o^3#0ӝ|]W:n[5 cS.-T;O~ r ׯ1[w1I !$k^&)jz苬k !$hK"&woO$!mB8 m kIc.Lf@ 30}Ar% 5NORcC^Ϸ-eѩHT7(􆺏xsG*-kt_+tT'*Wzj5nQ[o빓A"*XD`}x!*hiv{F] œ<<DOIPdϋp ˧*BI!-4aQXI}C;iᑈ3ٗ麢RcV-[T Y1bSÇ#2.o6^^)ZOwE%-u]2 䌛tNs߿{W%!6Klxd_,<<˨^BR ﴵO7ncVrDBG"Gg|]K_usȖ6n6bjil*ئwk&-ڢ[T|{s@2@b "Vj)q*!<0 g?fwUD?L{ z,{7}*&)bX !&"V Ck/uo'"zh;~6>:끏6O@WvO5j bX%3 FkZx"=-n ~>O~MsE}թ'qXbj *ȃEVN),3WN؅_Tx 7NuwBií,Ū2P!G[F(ZAYMNӺ,bVA(aX,U{d0CbX Lf@ 3X,d BbX,VAy0bX !,b50A(aX,U{d0CbX Lf@ 3X,d `aX, BKq"67}?OœD]k_a8u$KڱX, Bai.(-+W:%U("'ߦ<3;Yn3o'>Ns{`ܖI8sJٺiUbXCf@ 3:Jxl=VƒxdNw$fjXc}H6i$nX, ̀ a !:i@JKsv!h9> OO wEUÈxYwoZN ­!, PlBjG.9„/p3x0 :d$&b?ߋ~b=bX BajU@: ӓںۦ)eqN<'e*j[F)X^Mn1|{47Jx=:J-oe[b2P8(RD1X{8[ @ L mOWO8?NL_[3oS!ė YBJ `ŔAHmfk D :>oL[?^`y/4W,aaqwĶfU((سS U34tDD#> L>[AdaKbc{6Qf@ 3D o]ƀA|sA0sg&Vu_e Vm?n]%GCěk0$.11: w*؝ 涶]-z[>z笫j[(<iR0@>C}x|٪Yc-c-VX`ϜiHˎ>E fA(0<$ Û Pv(30@ߧvD맠SFy=/9ZC óś񥲨-XY4ki~GMZgkT?WT0[ж,_J>Ŋ1 m_?4Q% =E A0M"DxZKws}Hpfjh9fTݞTTb Xf<%}Q"q nh#P1&hFwsD%yC˝6hbHNj(٦. B>FEu X#"!n,rC_1+ *hƍAqQ !,wNk$ {} 2P!$sW ԩx 9>8y [v݇gw읟ı?B5=hѾ$l)(T_=H#;!5c+ J|͖hnǓdeMplFa$MšRǾbdO1蔚&צXu(нH/ܲwHyVo3((-؄H])@_Cʑi;GOq)crm->_QϤ~H W:4嚔-xe#E ƆǓk!~IюeFaɞsxi6M쇤h]۬:v#&_b,hQ_ J,( 8ϋՊohBi;.iyx[+ܧѦJr憎eK膘Zw~s8Un[ϊՃюZ{ 0#҆w|8j0ou@ARވP-Li)w޷=_]#L%0qĉORr"Z"`q'(9@G^OIPИĦv* M/M!bVn跣g`൸XuB!2x|U1#3*Ll%'glswudۏEw@c \|@JQ%z@3q]qQɺֵ c&FU1Z5!v2sM@Q;}lb@bj:zWw},zBXX4Fmw_p:C,>=/lg! ! G LucBb9e3F \߇=lqUaG236y4P!Dl/(Ÿ#jbJ BS'@KOa]q7-`8DN|m,4A_VcZ8 Lw=^BQN`~pP{;$+ cKIBHXDG nv~ߣ[)BL+2;kf|6)jr\BH A@RavS!ʉJ=65h19V/},ۛ/y6)CMI8U?T D-"WĘb4-Esb&3 !]HWO?߂!m?/.ݾd[Y^US3LRw̴(+3j Bl}햁kLW'wE8ψ~Y(0y<3G73@۪BH סVK]4tO@b*p$-]lMhϬD׸H)\] A!zYoǪAg2UWhxv]꒹SvLEjp2: XudΙC S0S ̩$ ޳VPΘj !0^Jn*O\Yzg7cMQ%~A5uBH a&@xXĩÔb҃$A=v,:xn+,=IAm°(m>[m<հT!dqs)3 Bl"(쟺z =,șS .b?7¹s*HxMAVfuQGd2Bj]Kxa=SY  Rc   깉dql5|;c{ca1lcL%x! ,n*o߂^\Ù!XcNiT]-!^r| s .yo8PQtlK+<75[v ]cVeqݎ HL߃Yj&q{gc^,2Zt4ul=:]6F۷nݭo#=d.uQ#ش_?DYa`Btؐ{> H 4/?ǾsT}ڗr C3l[TtJ s 0wc5C(w ^pm"IЌ7!аO%ΉfLN<%gw+qhWKZicx !j@ga> [%6~´)hg.cU!y%<2N&S3FU#݋%ѹiؖ5BsDe{ū|#7\χf`LӳB ȃvQݻ{sz@d]`P9t]3QҾ HI!-+F:-ICi=I)50(18Fvt;vv7!i-,Dǧ`Ԓ=8g.$j%ISu::5$f 싅GSo9G]*,JVU8茾cVN^*5!%~c.Ӯ-amAS~S٦KZSqwm[MF [B_JC l+J:a}9 Ev-[#'Xs30B Һe*pM,޷O-襶vΨJ-#d=>dgFLIj׍Bm4 7nbKf@ BTp66؊IMNA; U>7 IYsvŢ bX,Vu Ba7"QA܍s: #pWI̮w`BRh"~+^sA* ,Ūu2P8pyZe!Q $x"~:A}gcپx]:uڞbXMf@L0 Hw.kW2ŃLrbj *ȃX, faX, B@bX#3 BX,j`2P!bX&3 eCbX Lf`LBX,b^f` 3X,dpP bX,V !,b50A(w`QiAKW@>XӵX,6 iE>1Msm,HL{11,bFA0TkUXLT2_9Շbxk{-׎?7}9K.Ӿ+`ZFX,ŪM2P!č%Z7_M㡌'~x`Vgftô2:CF2f?̮x8i7r$ yghzRRJ $aX,+2P! ܊Ņu*M ~hvW$Dp3x0IDOIK!`SBbZf@ 3T.@Ɲe*ZM3@wǹϪ2݌Uv "9,bRf@L0 hmIy >۷-'=g=Gyɋ q>kg]=,bJf`LW*@ójḨ8$paFw:al;wn=\{/| SV(mRmo v(ѫi-)JjXu)Ū2P!Ħ2*̈́v> #PVQRĮ33%Q bMmg<.Ï;|n 0!7_ui;;Q VTcXZ ڋb')J1mWFsV7:oO֪2P8(RۥN@VQ 1i`Ff<`ﹽ֍"3zQe<f>LƝ{"ޤ_!q1ѹU34 %"yonk1T*7GZL>P (8秡[d(<^*ߌiݐ2JPro]xIr҆CaepXvmͺ'3 B( 3wo'>S *@c1D<1.hܢ ߪ㋘ !$N^:BM.ShT-L ϨJ}w m;oƷ BV!DKssq' d!6Kx @ڐވƑ`a4"%gr2BWCZ@tmP >R2*ՃN<HbDkMF(E;0&MDai9pxwL=rQOAXD+ !9mq[+X"qpxd*G7ђ*6Q)_7IC|t Zsp'kj n@jEEiM:1J@,W`K= 7AbS}V?bsPr09'4Kz)o:c'uD0ߖWyU)܉9o Ϡ䰈0l*׎딗U@a“&\B!=AךzGhӝtSJ 5#;4A离^K22N`e(4Ϯҹ_p-J=0S(zn]ġ h y_Cf4 1uMXXc7 E _FڈWУR辞Xjwp2m5Ct~H&m-sA(J-! $a3kK3{b֞ۺBFicf7lk ;3/x{5y SRG" bAďA)=iK BTѸx#Qa'ġz0 pDS7YǗqȡQd_~kS[͂wx#r_Br0=uKRz3 2NhCIBc}x lI-klPnzQ[kyo֊ZYE"eԍR[vMDr3:UlVEeX >  }*h$MsS:}x­x8d~7UU?> Gpr8=JVjV #^UzhojkwD-6$!/@Wb!@אB!^|Zsמkd<30ekϚkι݂[f.E%կTV_Eeڦ#%VYpuzyABJȢ[n̥χ#׈W:0*ͿԨ BL ~6|EzJ?~S|zJ_Vڃ|?_BIZ 7ߍQ -%x=e@ҝ#Fl>fDvsOYN۽ֶ w_-xwnPo@ΪTx[yͿJ杨Vsv+h߾oz!C%!h\& JQF0oDnWvBHkꃹr)G6,OV:F(?ʒ쑙0IT3Sp&mwj/4<='=7ic|S$ rYn"( SsJ@װ=_%J[Cˆ(7~3E{w XƳ\>5zco|MM];$1A B{53Ic<{sEOZN v\J,!ssCv71k7? FE_/䏘/^јx;/+/;ﾳ Y3;Ecb9҃3@#oZz>#׈ܥ‚ ܲzLABw~99#8b$p{F. nq:/5_ * X[5 'v .,fCmZ, i?q9];'&sf4,q5OM{t ll?^ZqҔϣhOXXװzLu2k`2%ĉ] Hjш% W4@IXj|o W=$33*[H8e A5K !|wdIhUgOn#P:!4pԞ@⨸% \nW po瘀hPJ?m?+Mq+g#*!*_]+JM܎ǎ9J Ijn9^i 31ɱٰWsFKsux玩 JUXcX|PVeBețE>"DpL L CrhsJ俳$ж XlhN8 SR{*7Ku &Ulgk<,yHH5.{ۘ;K:f71>= ϽEc|JY1AGшVs_xk[c"!;1= o,bs?H㥈$!v" KH8RBe=u$Nx'(LD#K%ɈHhzC|~5oL!$"46z0hlKS6pkߵb=%4lO. gg$D61D<\nRsxd]Zq ^H a!|:e2)$tL_ p"d\#J3LlDN/?'c|iXo̎VTBͿ " pXXBBi]4FY/6W]'T)z"G  I钧)Ib:0u$Do8fNtCc?vTB` AUχS]>?ۘV+dDDg[[;0J@} B\G6x. !h_VkC[V+NRk7}bQruk>C-}vѢYhEZaIfhBkƪkY;`<_:쨁;z#e\m=XéK5},\8ZB3zFbpf9\\Z^,N^eJ<EݻX-W_x:^EŠEӍcp `\hm YG,S|78WT9߹5k1==Pxl/<ѾݗfGYBs=y Y׆ܞHkzpn رX=thq5qquT&\72\G}Z O[to_enMWEϯdaIIf-Gc-a_g/_r 1_x4\/T[6X,_U A"%Xbʚkgyc32y3-D)4f-"N# pJxr܎/}]X;ƉEތG/>wP/*PWH,go.^WVH?BsSV=Ś rHU8lZ^.wO4cLDH$|o|,}|#=Q#qcT! beG.J;+ Ǡwz ,o[d iC|4K=ٖbGN\p^TƯ!0CX90u Mߨ  }13s@)Eǹh\6׃#H^H>0$D0$#XBbDʈh΂Ƃg,Xiᖕwa4ԙK%a7*!HdP]NŒƊr`L-5f/$^XBf|DFB%DaadK0 Ì3TBH0 0 3rP A2%aa*!HF0 08C% 9Lc0 0#$2*!rg 0 $$#XBafdDB$aaJ,!1fe7a~-?}z{0~caaF"*!HFD@t>?{x ԞCacv#Bv gߐ2?0 Ì4TBȐ4XBH]ӓXWw`?Ʒׯ/o 8~BDq0 3RPA"#"w6Z?׋ڲװq.—_Z~߸ s}ߊY}W/} z * 1 0 0#$#XBޏKܳ!!7`+cޛKn·nQޭ2w]o봾MS=" 0LQ A2"!2hÏ߿Cƺo 7Y/egma&٨ b^껄]*/$ /. osx,S\^..DOki̞a& br4K~S#>~AWǟJ^Bځ=wh'?mWNѝ$* 0}4kg(дJ<5U w!Vbybߥѝ/vv8K櫑 ?3Q A"C` 1|~!nBA^hn?p~0R|~܏ƶF7$22'+Zܕ= ,!DzTν2чJ JȝTWz'NwO6މ/-zAn7n+. !}'^h>7Ř[QOH4YxhL̜iiW јN}]ģ;c %d2.a ` 苑]#6_~i>))q?tH@A|k"g7Ƈ<pҘ2~` a .@ >=jXB =俄œL{aew٧o+<5ؐP|Tx` KKp5gH+x,!C,!s=]oݍ/0D܂Ƃ\Xڊ_?m|a7z}iKH|XBXB@k:W|=%d%cKƜ .$$ } W;:͛1]qcru_c c,ɄT̾$*k53psSnĪu89 =$p'NSpw?>G]ssLLDs_};h,!5sqlF )0ҲSͼT6*j5}ᅩqOw^릘霐7a8rNTHKZ%ǷJ}k'霌)#}>kQͿm,eG)!}8Yw.O=7º1jZ}ww*ˡ%gᕆ~Uw=GQBŜiVvK\Yȹo*&^p1 |q~e%-Rx<ܿa?qf#_dMqb$=>5)gUaC+0?h&LY1oTYQ%^}/L3*ɋ^Fm"bmذ"UT@ X}L3kTߣ Ҽ!o4^4Se/+y.ɷzvz Պ mխ\)%!SW<'B{ս2`zk݆N?*[;Wr ntTy28z(r9UدaZLL9l0o,Z\;U{]|vŵIߙ'Cˆsu_jTb` !Ĺ>v@c#dg[ OgcK_nWwi W=$33*[c+$#XBrmSt M{8qI`cX!k|ۼ^!b/}n2 QUrtaEJ[:1{),uĻ܂i,qLtxpZl?>2a5QP"ZlbZB=" wR>y:rtL~T囈KB*oDs,H`/]lR }\˷S8q;3f&zL,e/X@l@ ~`j%D5CU"ߜ$]bz0q.y)oUB` +KǗ4[ޏu@Zϵu?_2hf̣O׍X3~cgB1%UB nw4-6*JKDK|ߞF=ex8z,"=k>Xz$Ǒ7Ө5r*bu|fT,ߋ$!`ê "X$$h<DFB%Dl$F}v߸ zs ޯ /vG߿ИQ vwzGC[(f= >#G#hXo̎EgVB%ar4*"Lx:}lۑ#`:z)hiyXbMi`ܷm5B=P48$D ՘ B$D V,⸆hqHY Y*AV٦=ewNȗh1*~ b?"rik/B57gEQS C|c!|GK˻>}_#q|j.ЧNY)i<'x}'D|jk(w{e R"l %y/ IiiW!WNDmsp݅+SmL2QL$t3A =7bZE]Ч{KA$ !"M}CCd $ шrKX9~/-Ed߾+#6mcSVܗK|u~->lы9(!KBYa`i,pD#i ެѿ`ޠ })gqLrra32{n[*DC.$FsA8~\)\簋 [k2u<>dBn;fN Fopti[Bp+I4 F;zɋ^[;rji%8˷M(3o5GcӿU&<̓!<0BK^8fxb[4-xLo+ˬ_!zQ7*DB>L-{2h;?FkʊA<`,!ビiᖕw?3D%a\a r0) jC5\f%1c$#XBafD0 0 $2*!rg 0 $$#XBafdDB$aaJ,! 0 3P A2%aa*!Hda,! 0 3PA"#"w0 0LQA2%$Fo|>VeEe\f ^ 0 3Q A2"!2l2>?ϟ]mzttg4afĢdKHH"B8:Y~kn,߸R|l}Oy /7dE 0 Ì$TB` qz? !<5\v*o+//߈X lB\tG8 0A% 9L%`\,AHGO^ߵ_Al|[b[(xVLi!Rܹ_gX~<0 Ì TbHȝH}8q$~kfck&X֏`p-7pX~?aaF*1HF8p4~?_o>A@d3."ʷ܂"%aaJ Tt_:^`κ_dމ{=Vƕ6X&t.!=>D;1nr&ܕ1o) wG'L;Λ0`yb%(c%**yxv%f,dK>nߏ]MMWoI@(0wz..9{0oc`yOlOg""+7ٓ-JX.<57Ec.9q328XB.փWpK)F]?z.n}׮f̽ _}ucԵ~fHEDž=ҡz$U͒a a jXBKCNj D^^yG5㔁dEB$d#0S]܂Eq}H_U[^;4wϕ/ }ru_c c,ɄT̾84?:j6g+X܈UqreH:c ,ǎh}'QN,:e>-BI2kg%$CFɏoÕ34HQͿ^W_2C#8\4{sӪ=TZ5mudLqTyS&O Mс7 ˟Spu(V1. ݹ3v??o))hee:My7aGm7Y'M32@W2$Uh\rܟ=%ĘSm>e=R Z>)0y1%.W?2dK&^=o؃/D@uf#_Q WMS˥o;e`r3qǰjVSCVaR͸z.U"+b4e_e5Nw6Ghh,f/ŪV۔ix0Uod4o=!nv|*Qj~n;=PQb5x&ϼ5;b;v'Ƌ7_m4_7wR.4`P#ڐAwbjlWw.%]1^ +,R*cV)O{zB!ȭc"B/Xj>JO!k 8kJ=hw?o=!-FKw?*۳kѶ. J'p&~GLRBٶAy0]2 t`z\j#לּߙ/׎V|G>=W̸[`A yx&]=?}̈́ W`Uh}S&a`ca,lUq}w՘{C>;V.2 kK_\ ??1 uGm-{G;⮱wBfD%t׎L%`kkv5SpXȱވ۩0l߉8& Ce㜒r%];ǾqdlAܑ*zd;N u ٺ0}G1~G qXo*^]TQMY b؊dL+s{JТWo{UZS֫fu8b5=kD~sw{ʯ۬)ǣ:w#%=Y`>p~=a/ދ%ǤZ`.M&>Z[6V]#!ΑaȷׅцoX α.q/x%L7'sG-Z\;*,02/ȹ^5B 3O;Þèk7RDOBk ! o܌h)5X($d7NgmmX2x;cJt Yw3^){.( 2|qTFVs]cr|p"mj[# sT蒎UHx,W@T`{#S o(ĵaH%!? c`{k Rn-mbR0)gUg*\#J}Gӎ`Òb5_uGI^^uG|kn hP1R/XעKh=Eյ߆lBX$sx?x~Bs5M ߶d.1ܷ|؃. %< մ2;q̑}a8w{DFB%Dl]EW;~ }2z wo'MzCވWl8#?8XX>?r@" ڱ_YIrTbF"Vk'˄DRHĽaHlLc.ydܽcNgy ߅LOemG+W!sfy>8LR'͜aKkwK7=!!v=`s޺%DAQ.%r*EBD7Stq=XuB8gt*X@._avLP[F$,iAƜ%gnvA:pC2?U]OdDr(1Z$]\'q wهJ_^¦Q!,Zε`]|k7{^ yq̀$ĥQUr\@%da2ھ3b87 i[+ߗ S#7jQy#5hq4юp+Acl~>J]8({iZsux玩.\ ->>W X͑#".')ynFwy'ϹU⩩ $!Iّ7 }D86 Q.`8w^@.aQOM8 ScVB4 !KJx΄A[溅9:׶^/'4[Ty4bx{l㎬|\Y"VpiD𾓥xw- SbǎY.UrlGJOl u Uɍ6X#H Գز#v,<У+QzhTB` |cK,|W ~qы/%%tW3kCƼu??AT*"5gf)3P"79p !x,zE-z JOڥ!!nwZ3>Q/ o9"rO(?6GDrۮ㓴Q98vʣ(4S(!`$C/!rٽȊwt!%Jt2\b~lD]p+Ͷ!$k{ÐƁJ5Հ@'rk,%cyfnww1kX1u3 q੝+#SCN]oXo峚v .-/#%"J/m`jN|fKH~u.BgKy7Ǥ`Ѻ$BB9~D;*!HdPY` 1 \諘l=P|典c_CΞ’ buK=*sf_dbwJ> >﷟/wO⍐uI"IH\4#!c SժiWaqi+6AF}nk-apLsO2)c(wo)ǡ3dOȄyϠ6Ә{%RRD^Bh{8wjvf<^7iGmw_oA)g=prsދyz77'>}y~wʟۃe@K+?D}95frRRo.{S2N||T-dÅoĦg|5y)}JDL" {=uhP6TbHȝtq݄[3\|?"N\+ {+̕Vt^7iΫ©2 G,SHXzZ~/e/_20VrZq[ )gE-P\c~S^TfiO㟑^ʋ"zZZke Eǟie9ʔn;rڴ~nEDz4Ǫ#Ya<i ˆrZ#^M;'vYkhmq_o]ZXd^K?8(,i8 ̺?:K7+C.!k} *1HFؠ :{Y1ZldQ8XO'ބ5eg܄Uk〳7&01^ !}q%×2 XFT59yV3-=qEcf)o,AGB#tI{]燗]{OJΡ lk\ oܒ9\D?.SHV#=B xt,ܲeWC;*!HF$DBF TP/=x%1 =i2hoa-,STf4M٨ lдs/M^^_} !)˸Sк"IׅMX@KÌnTB` qA"P[#/y ?N!ܨFb+h^.֭x8߰a'.|, ̘%aF7*!Hd- 3_ESd v.'bCFTݍKHaKÌnTbHȝF^-`Ϗ \Y\ͩp3a aэJ ,!1"e5 e'Ek\6)2g]o^~CBcaJ ш~8}4eW/qǢw[`?o݂O^RR}jwaaF*!HF( i ԃd|fsX,de%ީ|Z_֥af$dK.|c0tX(d$Z|CW|Cȣ9Qq" 0H@% 9L% Gn_Woqkloߊ뾏 Y!abMX+b?aaJ  `1SȂB0o37cџq޻9o܄<8>?j0 0LPA2%ĄzAHuK#P__yi6ۂb[- 7fުܠϲɏqە0ttaR+&zeqюJ Ƈ B+f6R8A S|wnWtu#@2#$__  ̚51H-JxM;⊔ix0YT ɋr%ձù]Oan Lܺ1ܻQtLzИ _|IճxyGV A2%D@Bǿ8Y|'o׾ )bp\]/~%X VސWD_%}Ngy31s-]ߍN}]ģ;eVwC ,!j8n[}CP-Ćշ`pQƲhZ#4 &,‹To%.>[YՏމ_RGxY$#XB+{~}XZ80? /⿽{1B>OSx~}jdʧ0U\ %MB*ғ0ۮ<<;Drpen,'pIDATނ;uɼgRHsi}8q^_1YA% ك"G1{0^QTor2H%湯b<͖Y'O0a :dJo+eҭxKH<1x (!7.w6R.k8݉c+ׇ[c/|q% S7 =7e0LdXB5o?^\ ʻ2` !D:y֭7Y@JVo>*{(_CпngPPu?+e{2p 9:ϯ|1dBJ*fNǥH c )7bպb`%wk\W_o=U3a kVJ>Wf2a8`C$*cNq֕1ÔPNf9^89m:Y>>Cswb)3tHpnB^e-$J]eZl?` f3߁υ':6V5'XDLhɻX|ٮJcmZ>)YAkbՏL#Ų9W Ck6S7aUt52Bw oݿ_RӮ)ެ6G7TBHxDj0 mZ!oZă^5^&Znn}a%6A7oqb$=>5)|рu}j }$ a~f\M5:+bɴɘH բQckB};aYI8;jtd=M3>MWBUƬ)vI{ɘy*,eīCǣ/ī1D>?;)?p{1%js^v4߯os5s v yIHH{e@+];b0Q;Re|;wФu REQOwUңzcUȳsztBYBRrB˺;od$}fCkb]SV`cChoF=p %Ĝ6Py<ǂ= oׅh^f*+Xjly[]=Gs=hmٺPCg~tN˔ס|q=n$ҾE|kKQ[ |Y^gވrިN c 2!ѴjjMXoWo,"8MB4-.HOR9ٽƐGx MkCkwR08(#%Js־xǜL5VSϡs k HǷE,M׽.q/ ?KB&`Q|6}K&N ;lhE}t^_#@(wxwPTi/3x ѻo y\dIWlGp؆Wv{LYN۽ֶ w_-x"_|V% x{"IB"P4 Y.Z'xݔ{e6t'*U|'vuoIp3DYh 98Rn3g]`/Juk;~<ٶi 6ҲdxOL )C'!+9vu 6Ɏ0ιZ<%n鍧k'=#u"&LYvl 9V$!!ճ-{?o(=*rQF%ɈHHt}= c7zu>63ӡh^>T%2Q_Om:|.VXs{\yTha$G!#XPFl;D*}M-όdžDĴX6BUWFHȣxWJhP3Q1&f($Dqj, yL1=q>ڊCBNoW9VyF*RBl{ ez$Nx']*HR A2%D>d}Y\oH?6zCDm޳X ?xG 3_yJ"2>.;#!0OV7۰ޜU3J4rЌ b7dxLy q3u{xiAѯ>07V}<ю| DhT5lLm;.zE1+hsm`jSN|ƙx$$HqL k0_L"$GTdK U46䋞/DS4Д~MbO^}zР|?ETx+aqQծ]O뜲b;n;Pxr{xDoQ8_Ǎ481_VDJ!Ӓ2l?a)Gze RXFjQzU4~Fm= }d\>%ZZS7]TJσۭrձNj4s߈Ib}d}Sܿ yLuxON2%Es6s]­=3/)5{ZB(};2]H IӃw)S&]?v ?\)gymk+StMx&MYݶj RRoɇ߈MφktSډ$:D7zlyLNTVCc?vTBȠ%>o }q%zO.|Ns/?!!zAnR{Ae$hjOc`Lc,~hV܅jIl' xrq.a"{rX#skF*k䨲 .V#Z0Bhvi_}rȋH)!tr=O?Gifm{v,5njݷmfh;O4^.}=X!nfy/_,i8 ̺}1xؗoWt\B&^5 =1>~UbȠ^8?)!~GaKLW,s;Ğ|eo?ZRsP#Uֿ-2$XB+dC7VrqT~]7",֣N1!o _ԍ--l=bl;xEiʒ/T/?5ƘĮn%ɩ Q^e~'L(n#~n.sOY1!ZYw@6-oJ.2$mO) !TG.x$'>ވ^ű{B~=s ϔwZQ||gzBOsm:0d˹83e\BQX<\}DLfnY2_$+XB"Ku? 1o.[2R>Wn߮:}p2suKߦhхU)p PL0 ødDB$dA"B$"_eN}ݿ}a-zF~&=&bǍ, &\쿨5l32&{iaJ шUBhׇ֮VÓ}+7݋'[[?ƲV_޽GۚpGfl\<wwe$Y0 3TB` )>O_,NCcA=6/Kk61Ъ_Ū58zQ Au e',! $20 zFhp?:;;dfpȁ@L} }`uK0A%JÌtǣjr1&ZK0A%ag  aafdK0 Ì3TB` aaqJrK0 Ì3TbHȝ1 0 |Tb` aaqJ aaF*!HF0 08C%Buo¨kgaF*!Hda,!@ r>XDaрJ  ь ~t-g}2"0 ÌtTb` K@dDFK0 0#$#▐B2hF =r$ 2|]faaF,*!HFD) :-ӅCFU{PD9DaaF*!HF y8l_^ !!"0 ÌJPDM !,P(;h :Qmӓ&t7ܛi淑Gz6BM׏>=frđnQi5 ؄^|Pf)n 'e\k9V:Te*!0,ѮG~9it=(n4KHz=He`$UZq4iT4{q\nKWx? %QEUP*[V Sr&!Z)Tn VQ.2|Ǟӡ +6?M4N9Y4eIk?ݔL/Joړw/IB4s@=|QS6D0/ PU-+ =-'ʞxoi<BPx=MߦqN$DyӴ)#/5 ͼ,Bc_V$rpEiaG%4,ovx=%h2g8jžA gvs[ՈH"#_̐׻<ʃO EFY#'s`Gqp7[~3կ)Z7ϑU.Y&#JHH~] >QA2%D0%DP.n/H8fw5Fum;uwN۩ {C$!D_.d}xkl'&ϬqY2Է^ 8TJ}* zeAN QEM[q#c BP~,t*h;>n0$Of)Pl;~;- h`Ecr6XV\ u:22 U>8;[WZr\JJ+BCOw||v4X0Ar2]k8]m4酨毦^gH3o#] \ef5"Λh ;BPQ޶XB%fCfvqoJ|T/cִ&*!HF$DBF:SB!T(D4FxQc{|cVi%{lXOB@3ŝ'ͻLI_S{b RBZ<:1{.t,vִ[*LQ+*궚zÜShY1hZ )Ky.!B1;{x/<Zgҹ̩B$D5h%D9C=-f m` :a %lHݶ/q^W[# e^cg$IAZhNs+ w!VB߳ʦ}2B\_D$de_z_PeJ  sk*|ч"? 8VK|'QWchzYm`Ďu*s!i;B06 YFqq柪n6BoE9%1uÏ4 qu4sผᒐcƌcK4XB qָx@%RDz}uqc~~ǥ3$1"V !*ZED̬8.hA.CpJ=)Ah-g>D:>zLsD=U-g UoEk`dāDZ;<9.F9㞇vB7=UDK8cBB$8Ko?r u啉$#"! )" *6&dPUZ)>6 к;((!VAES\4-$ĚI Һ;tzΜ)b b y"`OH k )jD+JU2=%,=4B_Iv쨈(*]r\d8$QDQ}iMhtgD#Z.ZNG#(q#eF&d`cJ9 \Ϗ !,dxjeߚ%)GuXC28Z8ʠ`]1*id6[iBy[5h]c3Q@먈XG%"IYh鱌B)!fF,+C\Y:\;$(!nSt)plX [~7fHVS;9kM^YI>( )"IaNreZQ_ڊ͔{˔[\ 7 ^}BpBn.W[fheGyx^EvЪ Mp8*rEGZG v؆#=@ϑRL<uL]y>wCJ,!.P.E~)"0]}?-J!ׁCUءIYYhݚHK& dN $Emq|OH3]6(!GR%ũ*Aq>*Hvؒ[^܇oX:@W*bJsEp,E.o^\j>!!5-s[9*'QWEvFp|*ۯ+12u_D&*Hӟ̝En _4z[PWb.c.Ҟ^P/lZй/Ek]#CB@*֊iYh2"!a&\?µxVljq];g{BvKj=Ԑ4XBIDT12wa& P ;*"$ NM0 ÌnTb`  KD"B+!XBaF7*!HF$DB ve7`dRǁ,! 0$#XBG-ƺ,! 0$#XB0 3Q A"C` aaqJ  3aaJ ,! 0 3P A2"!0 0A%ag 0 0 $20 ag P ;ca& 0 0 $#"!cH˶%aяJ,!;a #v9{ɏs>4 x]aftDgQއʶ`=~s," 0HE%Jh{t0 0#$#XB OHg?>uSGa  DK{;"=" 0E%@t W 4>0 3RQ A2%D ].dD :r9;6eg0 3>P A"C` A |EB(Y3>//"e&dW55vo n(u@TጁJoH ,!c뎱J,!zTKx$F|+,!K؁%dxcdKz'TJũX$!#*؁m[7BT4lY-8ފ$ӌ]^d{mcGQ uu(+hfcuDVwZ hBMGWLGkVٓoy=ZIB@wi(Bΰs"Nqf?>JPDM !,P(;h :Qmӓ&t7ܛi淑Gz6BM׏>=frđnz)j 4'S2NʸrtʖUCaY]n[@)r\{Ph 9z%6)I0 +@iҨ,xxI,Qʵ}(9j?&~TBȐ4XBUBzF6U0Bc" tԣ hҶd"(xKKP,ڟ({fɓH5B4}f9fMzp\^ :4l/4 ~}[zǧUE: ӼֲEbd˸).C5iQ(mU#:C#!닌|1C^X*"?M2feM(΁Mkݔn!9τW(jqY2 ]eoԣq*f!,W TBԃ ף؝-œ`&+RG@a=:l9R=﷡XUv}x#`4HR4vtwZ7@$q#(!l:ĹtddlAN)|Pq|w!&. 織V:OXi=`,e"8,ph Q_Mΐ$gF-!YFq}kX1E7pw]ϡRm+DZ4JZr/Jw{*98a ^<ȭi_M&6Tb` Ь3?& DŽXCZ GPh$;ǬJ)-ٰhfTe;[O>wR=};V ;@Tyu8c\>XߝimUrWTm5;9%d*h;cдTS> c#;)R]Bw5Scvb6^y$sS{qI,;kK85hszZ )V9u\*!`y,T%U=Q*˰C%ʸ}L{N/J  MYD>.3ͺqVhjdSE~.qTBD:q,G%;Q^Ѹ`_. ~ Dhm5Iw_8^|?ZmG~6LBdz4ɱ1NAQC5EW4 i1TPh(8qIG[ud{($[*\VG_ y!c #׶}1KKVU2%2>cQ A2%D@ Ij4tpoˠ 0p]QC/UBFQwlx0 ªlO]5B'gg؋X$D6HQ^iĭ"VAqۇ|}U D!UC$x~%PXem$mgM>UO ^BPy*{V٤GJHV%N)/BU*Qj?ʸ}뵨>cQ A2%$52+scRx 4ۻT$v5@D$DkGm.ȋTIg}%ݻ -Be?w nt RK*bUCHd*WIB8ZJ]z!i74@S(=ԈW ;dzrmKXzhs]q$n QiQT)两pHգ {44W9ڛxF.?d|F;8]MǡG*QRX;Fˌ$Mn~ǔns#ABdYD~ Q˾5{K\Sѱeq\hqA}!bT Z+y*Gm:ӄ,zkjgQos˱J H4Bt\ N3!b6`˲2ɕiSC6E ̆*ѰwcJX~za5>uT镋*Q@(F}*WvźhQLyLYQU0( .S.[Ur]БQ.W(:|S1,bkX(=yQYA(1{ҳ@ܚ.f[XrB=nDkW_ \7l%Th:½[Z2>mySQeNOƱ Y?Z'Qޅ,&WQe]6*qC\ ʴ\8Q>H*s("O*E(9SgϝP{dKH,GMDH4 L]@(~J WɬKkp4nMJHpVx%Em'J"w}8'$fw݇.#JoTq8ne ;lzs-ɳRUjBTLiurKKGb8$Ƽž~v7gTe$ʼ.Oer~}u%Rt=P5܄Q)zӑՍ዆Zo JeE m] :ewzudHBSZ18-MX$$ڤG68qӕ#k,`O.}9[SG;Z{BFDDAQ 92T2wa& !iĀ]Dpk }nX%aftDFB%Dl4#BȠ1 f 0 3QA2%dE-ƺ,! 0$#"!cH"2` aݨ  aэJ,! 0 3P A"C` aaqJ  3aaJ ,! 0 3P A2"!0 0A%ag 0 0 $20 ag P ;ca& 2@~xYa  +H Ϗ%a #v9-3Deaɨ R@..y:$TD," 0̈F% 9L%$ A D$"%a P ;mD9r· ~+"r)(",# 0HB%#(g' v[}*D0 0# $#"! ) 4L$ `؝MQ3_a . 4 m H4 "r&"RFJ|lٴ U}M;D! b$ħٲ {pڗ4T :#_<)E 0dK ) }~4\{"!$"g'"C'!gf"Sep%$hݧQ_UPԺP8?[YOڶEd~si}hEY#@*4Ֆ![FӺq 9%8xqJrKS@̂UB(="IH!W$6.!'v#z3b腒 u4$|ڱzFp1VQA"#"w6R"A%P="%d2"'εōƸc IiY,lC"Ӡ`B~; ʂıʲ\޷{zN߁VcG% A4EBqHHȦ FGNA)Jc~gL#!z'3Eee(+B"8O(!ZJ=8.C+CCFgo*(-+Bn)9irsn(fecІRVĕQ&wv,unO@ {7EI;$!֋SչJE؞y)E"GږLOzatECel7yr4 FCoL8L"iZה׋Aǚf^Uïo+V98\4ʣHdZHl;x4t׳s5byȠ3m; 幭jDh$p}/f]KZsS 򑿿9i8-Z?E-N*Q_D׬Lx%$L͏^ٮb "imIT􉿃$`lAĻ LN:;'MԉV!i2>< Z_vegVฬ Ey`W[/h*Y>Ul2 zC(vg|䢦-ظɊPX۱zTm(?h`eވw7 'ga?ݝg xJG419,q:[Su*pߝ+pHKBy.}';Sh>k;VCg, y.5 6BwW|h3$əAKHV.2Q\VncM4܅!Bs(oq,f!V\f!38R޷tN%NzCz>1rkWl $20  h{cUi%8B V$tL4‹H+9l#f:|Q-l=oeJJ[%$?lRmeNZl%!\A?;v/!֠ͱi14SHdhKXqDhd +STٮHDM,1D+2LxyP.wTbHȝTHh`Q40~Ǟ)Z.k 2ZEbT߹K*!llv4t QNԴWz4.ġW %;`LJ"!0Z[ v]=fE+ߏVAۑ !Mrl8xP}MBZdy̪<&Z8ʩ9q\bVAG օ aƸia%D}^X{൭~_ERqLzALEwTb` Pc#{ChL,Stz/WXh;St]QC/UBFQwlx0 ªlO]5B'gg؋X$D6HQ^iĭ"VAqۇ|}U D!UC$x~%PXem$mgM>UO ^BPy*{V٤GJHV%N)/BU*Qj?ʸ}뵨>cQ A2"!2"b-VcH,!s+ҝhH9lҽ5hw GHDkI֎\ Kw7Z.tUJ͙bnۗUnpۇ|ݭ2TP3$q j9𕄻CB+!Ye>xX`UB\/"Y2в/Q/_K^g{2G%Nl{MG?ˇ32^"Z.uD_AeM+;օwu3K:ÔۀT"f#9ř xc Iq ڎ> ?$DBш2,Q޾/rKBz31.` 1VU[㲊S$#XBHvz~W_@`{@$Ja UT*'r efqt@[ riSBxυI Bk18!c#*l9+mPx+h}X##L=ݙIuW q1N8<#p Xq"%^"$q_}c,L| !i("r1D*DS8|#l@u/v8Q PB ԓŹi[QI5@uwV_{9S@$Zd'JD>74@S(=ԈW ;dzrmKXzhs]q$n QiQT)两pHգ {44W9ڛxF.?d|F;8]MǡG*QRX;Fˌ$Mn~ǔns#ABdYD~ Q˾5{K\Sѱeq\hqA}!bT Z+y*Gm:ӄ,zkjgQos˱J  DPD.+E2.e8g F@ > EreAZ,Tp퐠Mѥ(!aJC4lݘ"-V&^XO]5Dz"g%h+++$!;Akʕk6:F}.Zj+6S^-SVnvp- ,xE ma($ĺ˖yU2ut}sTe$xF23'"!ғg[+=$2n'=;xʭ"mKً%+/N۾=̕qæ_[Lei/k-uK)h187UK^k`\QnU}BJ]ib{U%k#@274LCj5ءcJ=GJ2!Rԉ3uy܉u:*1HFD@HBD>w'q_b;B(% C_=.&.Ѱ5)!Y9Lȶ(Hݍgwl PBJ(ˋSU|U*%ρ':7JE,W_ ^sP1"8N}"C7/U.5R9ڭޜQ+";#t>eוKP/?BpFG OG"T7/Fh-+11iO/EBھ |՞Bu ]hZ+eU]ry׆㡗['nru ٥//zBrqhVrOȈHh&("?>FD HW Hd0adKH EDh. Ƹ,! 0$#XBbDꜾkeK@2,! 0$20  Eȅf8"a aݨ P ; HQ7` aݨ  aэJ aaF*!HF0 08C%ag !i0 08C%J0 0G%ag  aafdK0 Ì3TB` aaqJrKl;0 ÌtTbHȝv" afdKH׏g>+vgaaF*!HF$DBF;vBHʶMBDXDaJ,!Q HأYDaJ,!BRqя:TPPO|O4sEa !i d) g' v߯BB"0 0#$2*!rghBIB(HD c؝MQ3_a  &!ȆD Es>lڄf؆Mq1IwSlώ=8K\Fh/CyQxMaP A2"!2ZU@(b $"Ed$ăLd.$4 S*ZWJ'c+62ICo_4M(zHׁ2yќ2=hZ7NW /`Q A2%d BPqIH!W$6.!'v#z3b腒 u4$|ڱzFp1VQ A2%D` Xb BA3hHDz},",!K؁%dxcD" )PMÍ K2v`  P ;tX" $yU;mfQQ“m;%X[zQˋtt(eu{zl(*N+^uzU޼  uhm*ޣ4{Ҳ-G#IAs.x3xE9vB׉#43cg;^)phi6Jsu'qv aA@WS5 rmz2_݄Ns{{36TFq5cG#Q8M=2{!ˁJsҌ7ō!㤌k-JlYe9$f>"'εōƸc IiY,lC"Ӡ`B~; ʂıʲ\޷{zN߁VcG% A4EBq꼱{Uнw#*!9(++Amk1:Qn4f<Hh<^xw h}h*M ݖ ~J 1T 䄧MBS\d=CJYWDm~hriʒ~)?E7^'8^"hZ/NUb+mKc{l"`^&i[2Wz<饇ѥ([O= x$zM3 z3Ii=8^S.^/F^kyYVHXp=Ҍ*"Ki^kY"z2Je\ZqԔ}!δ(綪EF!wy,k&Mr3&GNnJjg«_S8o#\F}]2MF㕐2M7?zf<},dDB$d3%DP.n/H8fw5Fum;uwN۩ {C$!D_.d}xkl'&ϬqY2Է^ 8TJ}* zeAN QEM[q#c BP~,t*h;>n0$Of)Pl;~;- h`Ecr6XV\ u:22 U>8;[WZr\JJ+BCOw||v4X0Ar2]k8]m4酨毦^gH3o#] \ef5"Λh ;BPQ޶XB%fCfvqoJ|T/cִ&*!HFFCZ GPh$;ǬJ)-ٰhfTe;[O>wR=};V ;@Tyu8c\>XߝimUrWTm5;9%d*h;cдTS> c#;)R]Bw5Scvb6^y$sS{qI,;kK85hszZ )V9u\*!`y,T%U=Q*˰C%ʸ}L{;^^ǵ1 $#XB$w ߱g ~VءFx9Udw H%D* !BzT5 9qUBI!X!H! @VtWlOY:%Uvg$DGH$(5D_S$x~E#Y*O 8r*kszUGABBuEX1nezt0x Q8^?"xmWhe\,Ӫ^P"(S3$20 56$}cx${z`%tFyUTI+Gɳ À$$rD$BB2 >wAc0L) H%iV?c\[G@<[GCaqLl#MB$t}("8.g$1 he\5.!i?%1P A2"!2Z 9UDwpAT>Q\js.HsO_>!bhU$N@̊颁8 ߓB1 byhGn+. zWEd QKD3&$DQIs)RX^P A2%DE$ D5&~z@HjBUk=phG8@^pX'MsTk&H魾:sjH&N|o =!i( P{ (Uvږ }!&I"ѳ">䣨St=qIGAGiis7h=\) h wph:KCTƱvIF݂)4p=?FȲA}k6; 59c NWk(BuŨ0h#VU&tn Yl֠vG"撗c$#XB\GOG4 !Sq# RB~UU|YV" -u*vHPBܦRٰR%!tnXi+O/Ƨ.wr֚ "r|ZEQ4SE蝠BʎpX-j)/)+J ;o"Y6y0be˼*Bn :>9*s2<~#jEqqa[B̳- LG7ٓ<rt6%Œbiucl'Zm_Ğbpʸaӯ-y2D׉Һi{ț*s |%h5\0(*>!%.d4*sUqTL GzW#FyR)Də<|DM:c$20 e}s>51$! RB:p;#b2+ [)sdQlۉR}]߽- x>q%$!|@8U\8(·[E[^?xp#T}P5S+cyD݇,=tyRR !1o/zU>2/3KS,<\_~]9]"#h 7axT@td,Bucaۂss:|a[ׂ}}(=^zTV N˪@9= 6)/ C//:Nt9 0K__bVю垐FB%DlMDTaPHd0adKHH"d /d0 3Q A2"!2`v%aftdKH8{Dp6`gXBaF7*!HF X%aftD2@"Ix%aftDFB%DaadK0 Ì3TBH0 0 3rP A2%aa*!HF0 08C% 9L%aa*1Hd$TBaI>*1HF0 08C%ɈH0 0#$#XBafdKߎaaF;*!Hda,!1Br!|e^gřKWtaэJ  ь]@wPއʶ`Ԟ~aaF<*1HFDKD:"0 ÌpTBHV" 2XDaJ,!ң ~t"TDXDaJ,!.DB<a/>"0 ÌTTBȐ4XBH3J&Edsbw:6mFU|af|DFB%Dl4 W!&!C%"e&dW55vo n(! B@TጁJ}AXa XB,!c$#XB$FJTPʪ %d22x3UGie[^VqG-Ѓ]fc14;Ps3GhgvR>T"$$Dim- l/N`N%jCd" | (fmQ^Eij.tGf{+qkʴDlBb/(I372+etahףv|h?P4:7B%$ep }wL* -8P4* b4^*zrz~9}jZ叉$2*!rg#*!w#*!9(++Amk1:Qn4f<Hh<^xw h}h*M ݖ ~J 1T 䄧MBS\d=CJYWDm~hriʒ~)?E7^'8^"hZ/NUb+mKc{l"`^&i[2Wz<饇ѥ([O= x$zM3 z3Ii=8^S.^/F^kyYVHXp=Ҍ*"Ki^kY"z2Je\ZqԔ}!δ(綪EF!wy,k&Mr3&GNnJjg«_S8o#\F}]2MF㕐2M7?zf<},dK`4Jf'];P'^ԃq&j(28v:B4qS'ZHB].Oh}Mؕ!>Y2 ]eoԣq*f!,W TBԃ ף؝-œ`&+RG@a=:l9R=﷡XUv}x#`4HR4vtwZ7@$q#(!l:ĹtddlAN)|Pq|w!&. 織V:OXi=`,e"8,ph Q_Mΐ$gF-!YFq}kX1E7pw]ϡRm+DZ4JZr/Jw{*98a ^<ȭi_M&6TBHtH|BBvAJracB!T(D4FxQc{|cVi%{lXOB@3ŝ'ͻLI_S{b RBZ<:1{.t,vִ[*LQ+*궚zÜShY1hZ )Ky.!B1;{x/<Zgҹ̩B$D5h%D9C=-f m` :a #Zn \)mB(h 0 QKwc0L) H%iV?c\[G@<[GCaqLl#MB$t}("8.g$1 he\5.!i?%1PA2%A墵2.=_UBk`V8)3++jK"x~.O @$$dZxƙgDŽOUaY9nrU[Gq`q4Obg8$DQvk$s_%D-ΘE}$ ϥHcyeC%ɈHhC-#m`J@EUk=phG8@^pX'MsTk&H魾:sjH&N|o =!i( P{ (Uvږ }!&I"ѳ">䣨St=qIGAGiis7h=\) h wph:KCTƱvIF݂)4p=?FȲA}k6; 59c NWk(BuŨ0h#VU&tn Yl֠vG"撗c$#XB\&"z|j[O H {@$J 10UU}eYʂXԩ!A qKQCfJ@h1cEZLn?Yk*EJiEѨWV OqWIBw>+;mtb]Vl[(*ZYd)BPHu-e.HH|efY5NEBl '3϶Wz>*+H0e2:jC61_zeBI%g5tuTB` zO3!KcD."QJH_U`z$]Lfe]ZawkRB"s.,*m;Q/뻷=!1'>t9HPzCp(#UaKǟoyNQ*b]M)*1HF0 08C%ɈHXmgaF;*!HF ) vu#v2uYDaрJ,!1"d5_eaaF:*!Hda,!1` ?{u' 20 A`A9X$o7$`dgo= V7w nr3E+>$! #HB

jH.!K#ьPցGU݂ދu="hV<BmǣL $! S@\&"E%!$!$!.2!G"!J!`Q`8E$($!IȣI@mǣL$! mDB.FB0PDpVRܺ T'_ X(hJWېvW ?XT1tnm _՝)=V J$l 0>x\bpH$&9n/ QKdLi:Ӑ[*;6A(nM0LC.B'!Zݵi{]}'ah6ܭ#:t/%؞T" SA|ieA2\/D.Ơ'm?hfbֹ%p{w(+j$;<vN1".,痡 5e9¡./z0tD?>-cbƵ֑Lu[ǫ~=b۾mqFޅ>~n3P8zw~,Sfmz]cwr Js 05̈́Z;1Hj8~`#^A>,'}߫[ƛ}琓EdBf4 F3JC /N[=`.H.ȁ] C&Jw`,BIew;FBۆ>'lQa}?6 1dȯG4f303a;0>ՑI 05 $F`V 0gtCnxC(LP; a}~ ؗw;z20pxwz9u@(aI:X֙ܵjΕQG"$fcq$m+?g7UI;V$ ӻap} {b\>jV3w>U"lL,[k =8\ίXycw_`ٌ^ڇV`!W^vt@,~n:%a4)Н[C:` UBqÜOb5$tީGr]J;-uѱٝ ]&`>_`J'9ȅTvw֕0m61ָK\1'5"cPUrb2zE#S$e)Cm]3vfK#lYyDuHLdaUXVzѕ߈]B9c;8ҢKiIEzUB<:`~,[euʺqI@V޽W^bfV0Y^_ǵL $! |3LdQo>sB;{<gkHDY†ΝTB~dpqOᣒ.m7z4{Bo',+?$  9»bq_y)-I5"eIύqbi9E:1\&ji9qU"%7!۵]s4ƭN_ GyAc)Ck[\F` q~u\i((bɔ{F#zD(`gRӴɃ3q=]@*!Hi{b#dg&n-* CB1O]=Cң'偣>],Ƚ"!C t[C@m|euH:ίx Yj !537I}Jc9tr̺%c%""~ew_'Rį˖{F#zI\D6"Qm8mBw_[8S$Od75xx \+F^b0·ooks1M(KpgLêj N\ac6D}גP:`^x[ݝ.%s&\cIH<*l.e#zI \Dv">J"񱌸VH%jɗ3 dQ!1FNJ@ulQnLi'+.wr l$g8"GGrW%!>:sJĜ Q ',HJۚ ˷$YDpJk!!]6/4tȇ1uz2Spqcc~E{atQǍcVq[l߄K>'탫w䝱_-"613nצ pxlwnL0_Ga&Ocs8ʬXa3tjh]SݛN2em"gs8]+QG&P$~L-jaJmH%tjGd4֙,ݭq g25 ]&H[uI&݇&Jȡ 4'zHćP:nDBQual|0D[~cs|(k~L> e3Ɛ IsH0A$IJ{\ڈV_6t%u|  Ԧ#!c,<){4A⃗Ȣ҈;AQdBP @PA5f$  A4HB2aȁ\Dp&ԓ IADs#0#T kf"Ӥ߀S?<A4721GT("n BBȄ$!A͍L$!Aq A=$  N2!3xIAA0dbf*!|cAA#HB !zD(BAD zIAA0dBP ! L ABA' Jأ״'av A=$oA2!G"!ܽaWuO_% #HB ~ܸ0n`eAѨȄAsD&  5SÇՋd/\lmxvU^U`$:\蛂:I JS oUBԭIe!=O7~I #HBPpI"wvXNBb,' u)HPݞ] (v,f<a' c A'9+!Z;p'T8rdBf4  * HFa"R; 飆D4Q0 ſ[mxQ-X)bfųM.!v< UBI3* Y!"A! 9HBHBj;]dbP a࣒ # <ƞ$с$xE&P$A! 4EnP$uNht5P"ޕU!!)@~0 b; .H|m;Sw?{-d!~I.)`a|6Ė>+HaMr^va%?ɘt!UvlP܂a)X?ˇ,\OBTkOm[AGhuX_J=?D\ޱy2Wܘd(oƗ:iqam#ea<9 7w&Wc- X7 7glyR0CV̺l#zw=-7?SHD\+pyF mt0wb, I@rfcuݧ^˖޼-#HB*!{#G"~l.Xj$TC*wfJ0fB:8- c3~=mlygO쌰Je͐D>I cݗJwCјw^c(yC<:9%aaeȒ1#X:X2q,u%\&)}}Ҷ9˂yae ^\AO~<lk ŬsKX3:V%QVHvByD[&c(DyS]X /COk3r 3Cm]^`.~|ZT?Čk#f붎WimzVw!7Ķ}ڰ㌼ }fgpX ˧r1_XFơ7G$@DU7`j vcԮ)q8Gf|YOW+!:7?Z&\!'?ȄAhF Quu c#9pD%pQ蝰9nguHBAhcPg#< dža718}[Ylf&,sƧ:2 TuF\nȭ[oH @_ ±vg!}; ݲo߯N|gZXf6cN/ǴA<7, QX:V]-ع:(]Dv٬q,ĵmEl* a9ۊaz2΁t@wO GJw8UZ ]eu-YB:'z ;olB;[ ,>jˎ/_>umY$1sp(Y' : ~-]Bя|mr%ĥqr^e%SL $! lP pVӠ"2]ŏp<& 2 %FHLܾ[1T$! fc$$ 3D{|GO3G}Y{DBxb"دq됬ub_y} @Bkfnǐ?rt ߙu!JH(,K/DVEx:ˮO&_-7? pG&P$FD% 1Ko™"yY+D9X} MB ;KR9[%{jި9]BFHqk> ['u(4 6v(ܙYUB3릘<, {JKB*rY>I9a%#zI@%"2u?_[#!Gn1_ǯwnC==i4:0/$ z7$" 6;CDU p=ys0 )Rkhxd (c N _- qLaFAa09kZy9%!3?HBtl۟8 ȄA 6{8c 1Cj5L * O /J_-{BQؒV3r:>|LsS{;w㖔+چدqۆ陘#1=ym#}q/C.[u\bƹ o K<ρHH=Xy_lx.y"uJTL A"!%# "ke[(֮B3B 1P%ɹT/"M#[ƫ,*sN. r( ʨHyC)km'9 91\HGܘ&tkB Z}-vmN:^^09c e y\qXuAm"0lLІZ2J s0ԡdքk9 )Gݥ,udbf*!|c̈́9F@67b" TB |90i> NlbI+0ktXq2h|r'gΩOrߋ(N}tz$wE^8]D̉ɺpRKpꀴtk0|; MeMתabeJC|k Xǯ;--=w%&X$DXpb=„_^Ftq㘕h:|(7ab{yg,qMǧ[)Xp:}W .e|9'ce35^ ƥW.qXv%k274qXGj!6!ss`fFLFYٜ1g ~ԑA=$SDXa\ |_U~R 9(l6x1u& ewk\B9Lf H{d Vc32 EvFb=r(OHڧdžkpk()O@rhnuOC̗ˎ=I#yOPfn<#jދ;Uq*|h7:s&o:!_[D19^)_Ǎ#YHq? 4͔O{0oLc=y-܏G;!= {a~4iy#=]X|zkCƱoZ#!ts${ G;qxFB"BfƇ 9R+iD ?2!G@ 㒉>Q$  A=$$ NcG]@ F&aO QDQ$ A= xI$ A=$ F&P$  A& 8aȄABA' ! ! #HB<QV1AL AB,{P2s\LX%!  JXPxIH48dW'A'#HBoIF ADTd/\lmxvU^U`$:\蛂:I JS oUBԭIe!=O7~I #Bf 5\1HHDv@4,f>IH;w MA.4\`u@?g10{EU0?=IkT 0?>=1X NU݁;,0߼A#zIS@|ނ *!V%"R; 飆D4Q0 ſ[mxQ-X)bfųM.!v<ȄAR¤A&bT"!ڈCDBr<<:v<Ȅ i$! Ç%eA&ΨTB0ɪA! 9HBHBj;]dbf*!|c  * HnfRܺ T'_ X(hJWېvW ?XT1tnm _՝)=V J$l 0>x\bpH$&9n/ QKdLi:Ӑ[*;6A(nM0LC.B'!Zݵi{]}'ah6ܭ#:t/%؞T" SA'lQa}?6 1dȯG4f303a;0>ՑI 05 $F`V 0gtCnxC(LP; a}~ ؗw;z20pxwz9u@(aI:X֙ܵjΕQG"$fcq$m+?g7UI;V$ ӻap} {b\>jV3w>U"lL,[k =8\ίXycw_`ٌ^ڇV`!W^vt@,~n:%a4)Н[C:`ȄA@!h1f9jHX'xS$7F韕vZMc=> QK+;[&L|Fۿ+!}g(11Or6 >+anlHcq4.cNdWmkEwǠ0d F"IR(!۶f̖Fٲ󈨅sª* +9sޝuvpEH{qxtXbCu㒀p{ữ;ĜWe:$abk #HB(D{ݽ;d/HD;!l9n ~M%J6!T>*Fyy!K7 v2CH. @.+hHwt_-¿[&!|4'8(S:H eBaW%!ˆ\2{ ] IN؅ 1Gc0pt D?Q?ĺeWey"Lg;2!3xI;>oyEw}!1 u %FHLܾ[1T$! fc$$ 3D{|GO3G}Y{DBxb"دq됬ub_y} @Bkfnǐ?rt ߙu!JH(,K/DVEx:ˮO&_-7? pG&aF7p1'+ 8"$lde\zZ!84Ӑu@Hhnx7XBʧG.L޳ UFY~"&7@~[C m:C|G$#!!c}+Q2!GH"!"~< j52-JkWәGQ y\kAI&ō NH9'HdzX9wHHRyk eTN5ضדW_⑅QmJLa 4lߣ ݰp܏G;!= {a~4iy#=]X|zkCƱoZ#!ts${ G;qxFBJX3bH ?v}P;iD ?21GQ@>z! !hndBPEBdU뻺<4Q$  A=$/>/<>~` ȣ:! !hndBP ."e $!A͍L ABT IADs#0#T # ĠABA' #B  #HB !zIAA0dBf4  8a UB ?21GA C&P$  A& 񛶝  #HB*K@xAL AQ@6ar\"AML ŒP%oYC& L@Fl3#! #HB|" bT$"AD#zD(ҬpA(„ cpC+F2C 1 A=$. (N{P2s`-2!A)AL$!KB0PDn19 !5 [o =y&D&aO qD@0$٠?lMV8*; Qa x .H7[('a(V]j7>i.s:y&D&aF7 ""R^D, aycg.߅ܰa' c+ES KBtbUe`t}& i|Tu䳐J~cAaz 9 ·5ABL $!FP U*EKH;뤕 />0!:H"!![0{uqzJHQ.RHBЈ1TB| "DdBP8 +otLaD@0* Edb^bL("!86ԡaVB8cqP#q i|HBNy&#HB(pR pHPF\эN~h,-.A Sem6 YuҪ@zI4>$!'<L$! |6`T#!("tJ Y-##6\zV҈TBR< &ce7(ēpsGxxCk,zu:֣$l}غh's U,?J%DUukl4x'n@Җۢ%Np;ӐMuڿיVsm 2AؼYNōi2Q߇=v/,of!nH;t'aUdLH׭MV )`e?.V]l :/i#o]%ܾ[?t/$5a;{d/V:Rc0e'v7 hQ.}Ỳi 匹+mlyO-1#? 3(5@^mms&IL7J< +E^OrX[(IF&aO a<`"VB0?֧woDavb=wD`Q`G>=HT]X /CO!{>#6`"Eiݲ7T8/u L~:SmUaT"!jS{dž-{ձqV6S:;sX %$;_s6C9^پ&R^jUfȩH\+K%TC]U7`jF ھ 8~?Hw瑝ɭ<ݗ@OϼeS][6my>c? ;S0%Ik<0Ư1Vf-a!榄!Ra- Swg}V飔$L8v;[VODeϙUGH8aI(LzͮF'JXT\7k;SV;݉TB]N5aw8w"LQI’ ajiOܺC*!XKh l4yn;$Kl]8X86$\mI(ks]|Yk4S\`90u.:RK먢v5f'#JCTU_sЅ9owWnúp2) ~~ٱ2)vf3zo[>L633cB޸qYﴣspYQࢳ~7`V& jCy.kD G'(NGrMp"_.m7>2AVskC*E+ n^NV_g:.!G&P$A!(>,A~+HT+!9sBѳ=sr2X($7NGG2lb=>uA%kcթGsy! 0;9C .ΑR+ ).G].;ji8"6\ί=9/0Z/ꉼ|8тV%EMALmdd^?Dv<&^3,m=]X/ sPX`tz; qp̺벜#zIca`FBr{EB>ĪNĻZJz RQ4>M̚BFu"kte볆~.?e/&j JBeuR a$pX1A]B qs[>Y +~eF` q9rǹяF=8':˥|X^ֱjJG\{pCGb.-7'Hd9J:ȄAb TDOOn@+p H#o5G)oZB|6Q 5rGɐ,?1!PJ%$?vl~FK0g G&aSsr(Q[pk| B2bt UKH(,K:3Ypx%gcp"我1W>2߸^/,)Y]{ OvLnus:t A4HBP*q |S n _XqHGJT\_C=gq?\1ֳrEMD]ՆeCf#&!m>n'G@*^TF]$9|Lz߄GǕB{ȬvRx,|%>BR[dbfYBf||cF.=v!zWseyAVvt詥b#IA6D mnRZ>WX,Z.qGz:}^Ov#^#?;v<I҈RR,~RbH}BSIynX%i? gaG:zQKrя%}TQ&ǭ]Bk$XA=$^( ^""5$ ?^# (5 NvvwHBY[ c.6ՍyYWhkw荣˫ &;!Gb*kWh{a;|L2qg쳬,ꯨz[>V>̦=A;ܬ6zGBpeδ#4TS_v``< NVzas$R yEWIwx z/yM ^F^V/uF-jT_S7i0GB T^_E%D;S<}诣b#r0fۏ@nzlȄ4#"I Wq" gG^[sCr:zp,cªh/c⌒De}c((HK`MepM|`1Mb/{TRvH/|*O vYskpFm4vLqk2D:rEm.*ꋾE9v!8 [?&rIw`^T#!⨙4kNV1Ǻ按o)+K1IQIi ;αoW%0߾fIcN:h֍TlDR߿hzvrUa(ZC&@.i=ȄAv\ O>*1(! wa -4Þ!(:9oJ܆ (p?oDS0! glf6%,I"9[TQ!yw])o{:s]\ABJAa|jzvn3.뫥mM3fF:a#S n#gouf&IBl'v?:7)S89%B y}B;c)KPʇ`s1U'!HH8GB:atvB#!I~"" ]@y@j! AQkdBf4 P"ܽ[؇! @&aF7̈"rC""[04BA4>21G9"2QZ- #BGQD܂ htdBP / !! #HB !0iA C&aF7FADA=$  N2!G"!AA42!GA C& 8aȄ iGhxIAA4213B1  L $!Aq A=" yCA4;2!GT<{[4c>] 9 A=$$ malF׭|҈AȄ i$!SD ` Aш UBƚ .A("4"BA4"21GxdW" +ad؇lALHH3% wx\-<:AрȄA" Ƚ. Y#O aQ#ԭI }SOubFJ #HBpc2" ~Q+ٚ셋jUwrJס`:0U]oP OP~fwB7o|\ (G&aO _,y F "rKBXt^`ߙKw!w`zqI˜$IG,1QE_yl`vJGgGUwN> D?LWvA'9+ߒD9213BF C]@PdR#8p igw:Y@B=$d &{/6:U-Jދt$![}Y>,IAD&9`2D&ΨTB0PD ͂%$1&mBMgfzЁU+!ձ8\84>$!.2!GT/!d| C}D&FB0¾."Aހ8 WT%hUzarj&!.PZHO7>Ƈ$ E& ÒTܢZ XX^.Ri=J+DgaoiD*!:-a0(ۆD!;ˇVGXزr>jbV-k'\BT[avhJ،wlq$m-Zph׿: T{i-lJ%:X%؞T"ʤ#cf97a,G}Ɨ:۩Tgu"ЕUV=" $a,0+֛$ /m=EظDg,1uڕ G^t:~S ]ٲsD-@a)mp}HA~mQ] +|ȄAh& )7^"0W0`B`k@}ά'=iHưylLsCӆ Yada$%H@Q =uM U݃n=Og*Cwޙ+WCD*T~̽cÝw\ ணQfbw"IH<'k;QHO߀^BRͱu8Wnh3:hf>Ed7*Q,ĵT" He>Bg%L`HAB۷${Z}܏W]hò }Xdg`t\BFơ7wmyf+8.QBiQuEU\wa=M„CM C/TXs/?!ǹ훘JǬzT{D 0i0JBXgf u]ug .F;ESS e$ ӻa(I`UiCP$HZڅS;n: A%EXBkɫp!y%v_b*(ı&m*]^6y9._t׮J֡UJ.B[E.( 9[GXU}YAOXGnúp2) J1,Xܗ/X1?Y؟ncں:).c~p)p"wqӐs4"uc$;s(>.̬q"JXBPdr YT+!8jsBFkl;Eamk*! '; .!Wt.Y<>8j⬑VXY^~f8/e 1ԅǻq-W'Cʇb);HST,k!uHYq b=g'%x<TND+cg#yNrL/vAn&ɉs0o"ϝ$gl36YD zIŝCj$g`$|bFlNN&6zK`d&;G'% ~l薹ZarOnxP ፽s8\:dW2; pB`vr V\#V"{ctܫEQUT_vZ*(y .e˰Rbmgm[?ud5IaI]LBfƵQG`Lsە(-p=鹜hNdBPEBĵѐ%m",}|%3S@*[5;c3tw哓u^j)!5HEL@"=3dHb <ߨNB1qk[z˫C)?e/&jChj%!:yt{nxG44bvMBs:FaYΪ)4пÅ9W-_-V/w% `sv}{9 A=$C."s<_bkkR8( 6[ 2Gs=?Ȼ}F[+Tމ>Ιldzqvpt`b6myryhV -3HZn&l +!.묶 |,hy"FNY?rwn!O$LG-IB&.""rCD&6h!'`M񎟣T3qkd¿WwCB8xWwPT\_C=W 1+i33A%dHz 6n 8.B;ۆ,O¼}$=gÍx$ںZ}!A_>2;,v>٣3$`Ȅ i$!ED.k{q=ƕ˿c ȃF@8nZZ,vZaCZ>e(KKƑ%d&dp:#d@A%LlJ60Dj.(!/<@nIHu15.H#]<38*"UnoǐL ŒP%oY"Ӹ%J@F@#ub~MB̻"8, [ݘ0qlSݘ{ewX{s0z*Gpđ Eêwhe2 I!%D=QU.bwXJ,3xr  i²бv`$~j,0NVzas~8C$X$uѯvEfY$Iw8|$$Ö7&7h[ Q0e}v}[}G9X'>21G ,¡qo3!FBߡ@@N*!BtDKƄU^)oxu)8$LQ֐ Q q@o\cs]YE;Ǭ58 ̴c[@P%ҡ#*7$!$ou<]Dev+J"k0dca7&Kw`^XoahlX'hqHRm]AsΫstI!%%@Z]1U%!wǡGۿ(ۿ3doab(I`B/2!G"!͊`ݢ&"]#x84Jy7 A\ސhw򛲆g6L $!.u07`Mi7F1y8C$Sism-a7L!}x'LuN5788*[25\ABJAa|jzvn3.뫥mM1 C`N[3|FSq= >H!3 8K}jz,Gv=M3SUbdX($,, }$h$ A=$."?$!q!0#T kTP YJ%)"ApG7Z;U݁KЪp]:֣Jz VO$Iq\Ġq 2f| s5`T#!("8R^.Gi=J+DgaϥcHܖK0ApJQ#<3j:Q[]^N>\GMlJҹ*:U eAiwI]2 Ѷ{K:2va%?XTKԿM[WH$VRܯ,:ۭDڡ+} 9Ծcu~x9ax,N򸤍ri@i-lvŭMuB<`r yK%:@w 淊UP0=8˰Gukzq1IY{-wW4LV^B%ܙ97n@&Υ-`e(xEڻ =6c[nvc4D#sp,#7Ik\‚O6E:IöYo|9%i #BFQeJǬRBH?_x6?.0=wįcDBB.ϱQhUbГ bn}~zڰ}=,F&!Z%H@Q =u,Xn1He}n; J,㍐M61`R(F-v#>HS N/a:(+:SiY 2u_)Fo`NJ"!9bqMk#W7 k_ r-B;eAJ\BRF.B'm+h\%Q< W)!{#fʿz !䂱15m*[,ò9a?.!S0)?^뜰2Ny~ڈ~畟7.+mi[]G=[!9aOfڲ~ -! ϧny}?ڙ P\m`௥w b׈ȄAh* az[{T!{]WݙKioTBeቤaz2ܵd:KB$c HI’ ax6@wn>PB"$Flw]ŵڨSkk&;~](Z[+pWxIo#ɫm8aw|ՔE>:h55w x鴾]gv4kU!'F[MYdeq8NeUrxbrKD#Ǫ$wKܷezIJH@x\T'!Fwtzn 9#Jqb=~3벣Ls¾cX?"V_G5%D~} d9I_- A4HB(f 9~4ȢZ |sB4 1/v䤦RcpٛPhDKHy'w#-s3`Ǻ˴YK qdr0{P<[DoݓpQ.;0tK3,pK#H-%' nuw^ ߲WePXQU$!֨Pr^:-!\ 8-]J HȮBW " u`5G`M˹uR !鱼A5*4Wpej$d}gcOH;9Qwdo L;=3kZEB-/77uRB:YYaD|v"qS?bGF{ʶץMT7fLe@2wr\B ʞs:z;8}R>_*LALN= D5Eٹ+4a:p=miojʢT` X͒jjk)!HmSf=*x!(lhhL0fUs* H^ A̷l1nQ۱ʞ}ucxٸF0wLJ!p>>mtDҪs:F̷jVysp}lWʏ: نIcdSa8Su]ִD&aF7lp?E1,~|h- .l.MGlaSMu6L8=n [')0r!, qq˦RhwYHe-ywZ|WfܷWܞdlr`FvvW&OlΣplPk+!9%=V? HMmv= 4hH c˗? q A=$/)/Aq! ^D&{b+kZ܆Ru0؆c7 $Af DIʯdUu &{/!R4>.@ˊh\HBfE&P$Y@A>P@0D& Nh\ QB*Sa3s'TOu)HW~x#IѬȄAbrT@0*UEKH;뤕 />0!:H"!!ޝ%!}]UK"_XriF#ry#IѬȄA@)䮿`T*!;KHbL("!!86\= Jgu,jй/$!$!Ds"0i0PQIHF}ocOOV x\эN~h,-L]V&n|Q%d=J'Ar͉L ŒP%oQA! 4EnP, Y-##6\zVžK+(YrqI1m`ܪD!;w2[X"ձ[زr>jbV-#8X(.t6헴QkwARsoU8>%<+.A/a?FGFf6Σ_뵼uNhtA?^]i\ːw̲"$~wK+LBؖ~.o]XB`` m4z穪b_6T"n~# 3}G&!:%H@Q =uqR=XnYәhݦ'*W "G NABcc-A%މ{ic x%d /2cD蜻s ^%i6sBzޘ{I|oqx(?ZCwcjD+TB/Xm%SB&fa$ktƬ`ouoƺ/i۴?+c[w~z9Œ1s`#AђQg׆YfVlUeuϒ9ȧ#Ra cFN^عFTvх-9Q&pmm[Ƨ:$^d`Gy MY/a뢄LbR ֓6#˺ڪrQ##BF$zx;S:C:di-% PFJ7ŭeXk="=Gb}ߕLTI’ axw0ʥ;n EB82aQrabqHLnK/NklսEFkkQwN&]9ޜFB̻N[2AF?DxR]=a;ŵH^kk&0|8uج#L7iG!3gwͺ:W%~C1ϙbXrhZcD!y|.J7G cq& 7&/2Qs^5dwa69KrOףKyLE& 2y9!8o?ݫ6'DoZfts1hk*2/I1 2 Xb  Uc%vvv3\>dQR,0+,ހkn tAn\+_N2!3xIY4LoaC3?3x5NdBP3)w||r+Ʒ AVA*(h99(B% -!Jj0wv.ouG=C \3>/OUB~'^Ʊ(ǧ,$!.y?nuOrYsCp S*QM$1E4 ~x_[!n?| >VY /E)!FYFY0yN .|J{M=Ȏɭnr A=$D[/-#vܯb&7>XOEB8xuP-iRkZ#0> 1ڔ4w'|3;~O > wH"Rܹ \g`ޖ`91HcqQ I{i刘oGn<HB#Bf") &jihIA6哘5!sY~5-!.qG³}M\5eQPnP 37b<1j.!NJA.tⶮ0%OL]gv$t6 ѪWb*/#.xm/X;w-h"bގ! idBP DDSqdd qD#u7׼g㵹 O6Սyq "{s0z*Gۖj{avae2 gY5'?%0eF3sePnҨ>F4 WoED{Eu3qЋK Rj t %]0qS]BYTZ $M=^U"!x'WterQw"^x\,6~E7$ݑ7bDDzbٍ/d_s4^X#!>kQEj!!ǠEHdluq{/u-D/Y>rdBP qOD %m) oE@/ 1GXmJСk8PF{;c]J4^>qR52w퍡9aLW 8;^f ktav$qq+>|wq'N=8uH>I[{aeYȧ %鳤ꓕuCv.ZKU+&&8c1͔wPڬΉs/AԍqcNc0~5)1Z=:TțIde89 c̓P9[dlyDvlNO`ݸ:PvLJȝlL߿,$JTqhQުWz97 ;)Q i$!! "`1Q?/SBX Q{w^{5G`fm;ab qa.Q6]3ߚ3GV ָœ0_+_6%i&$vͫmÎ,֕!jiGTqw üswkӎSqU>xƗT 0Sϋeҙc ? I>c&,שׂD:>rJ04m[:O]sSGIް5AfI)OZ1SݓSb.$RVtHH UBƚ.":DD( (- 521G@ 㒉> hTdBPEB"9"8  A=C&(I"[AL$!%"$ AD3 0iA C&aF7FADA=$  N2!G"!AA42!GA C& 8aȄ i$!AqAAQdbP ! LKיh_9AAL$!chv ё A=$/`޷bC ) A4HB" NQVA UBƚ. Ňq:."$"ADC#zI<>! ! #; +oVF@n~T{fm8D%"$#AD#!zI eR$AsLHPD0aD h4dBP PxIAT4VgWH Ak~aW "W, cθ8o x@LdBP a`#GC!]QJwgJ:#\:j$[(Mub@z fˎ(Xwl=}y,a%wGEݥ\ Qyq[^ڞHLܾ+'-!nSV9 ov&2/>RG-⡯ꯘ{&R*LA9#K$!mV9-wn/D /!_[; i$oGTJ#IHq6FJBq3Kh!Gmdk"6"}cq[ UBƚ."tQD,BhȶJik! !H 3(uh3uY~5-!.yP݄ .-G4_pYk^Qno\)!qs$v+Y]:2u531uFH>'Чr%IDATrtf8"^);$!A=$D}KLI\@TW#%:1?ywY["lL|:n꽲D~;?ryأT~mKLe#U1eϲjN~Kfa~jN_V`iTW#"{:j.!]tR^Ik$&E qJriwFA}Xvŋjst .1uöߖ@&P$ERY{kSG7η`" 1%IuCדq~ nwFb<p}2=& GZ}擕`|ڶ5~g G [dTXHvm7 _mS4)}yU!?bwψG#HB<"'.LJp!l_ ‡]Ŀw鞱S7%Twn@\Z;zl mD[D5c4wZ8u 8}v~Mڸ"ڈߖ@`HŁͫmYWc]iqIcNv0/6 \{DCBp eQx0' 0Sϋeҙc ?jLwCxqIb&ݖ遌tt.NQGs),"*Y[gnmȏ#!F?HH׬,X<ȄA%"9"<*CCԴrzMXhH;_+hls&_.Zѽ/|y8 %ee򙿀Ԧ=U-z|ԧޚԦ;2!G4""ةd< #^0ZAϾ>ʑw|t^'YBW@?7e@R9^u}N-.Է+HO>}S⸐ A_Ir"vW+ZHNt}':9|^ > o>Yxe^8lcB;)otdbf:KDpTb3ږ˯(peaX;% I,n$)!m9<^ WK£YK )i~ÿ~=}i^f?|q GU/ԩg܅8:21G4 !" u(cBrtHB ҨspяOQK<98?hLB?·?gr>ؐ ju~:^?kn W -p'ђX} ˌ(u~ }9ROs)0)RοTo"t:;e zϳЎ3e֋mJ;t5,#xA|tq^Xce;g~ ǶUBd{g᥷iC6e< P^{acϽ{o=Q$,JWۯ?,~#v|yj9OXL_/ۇg_Eqt񧟃}X:/Wؾ|Y7uQ70<ˏ IvΧaɧTBgk_;2YI-ÄoS9 V:婭Ov5}S3 )/)h`%,x*!mou9QdB L( ٺŨZB9 CB7ooohrT5 /N >s~J$>iuhy;TfUxJX/¾:um Y~UD<Y5|-)4;NQTu^=c-?㌯\B~zI[+7DBP?Mt~;YKpA$uWYݓ<~M^ v\̎*!ju yYX{%,_uנvOJ1ܿu)8/Ggr \<=~NO( w$U.!|tK JP=.dB L( ٺhz eG Q0>WQGo:JZdGvWɎEBlXչ7Βiu\BT:{λY͉zZBN DB>z.y\fvNfe^2Y|rS/~LO|$7zsPk i9 >^^--Oϧ:asNI9ܵ:ӬG( 8zNHYVnZB4k{ 0mJ^~ny>=i.(!l剨DZ;BRyɏ~i!@[N(\f"+ n~es5,_J ? |޸n_Cq澜~5 ,[B;c_f؛-IR+ YX_Iȇ=gL?)ƅ-21C&Մlb4 $>xzBW81o 7~v[Bvm)+'EF\ξ9]q*)ZK;_-HB?g Hz>e2:ueۈ{JZv]o AU[ OFKB&bȄ[D&J'{oBHCV!{yPa#ϟ(/3;lϔٺ1Qx-`9xAђK ^/ 6;Ib*&g剩֛JbwỼx"IL}Aџ9DTQC=%CZFK|1:D|%1*luf/Ḿ2+ uwpp4c=9B/mózx'ֿ^2cf᷄٣Hf/3 A{A|<|)x['D 2&d$8S:Uޠ;UwN5F2o~(FWB?|.FBԏ:ɶ "l}EW|XW q$iaS"dM1IQykZnwzoP٥_χ,P^W?Y oJB[o*"!,ѐ2&du3 ; 079SB\"󶎤sKR9߉F *yץm31y UIc_g%sx!+OD[ߜ/8&.s$cDQ^"TcVo~]_!qH&#`=xՌ-»<%D&JCj&!'g_bB1c? @ PTu4ppfyx幧1 ~Tg66ΚiLi_\b#5bZRٳޯ=M}y~[wBD8N Wjnz-SNA[|%qΠZݫэ-!pkZqgԧ(ED3z{S8u%'^>eNI} q<Ծ3oV/=k^|!DB4x͝}{mmJFoW4ë LG:gmKטGfbzM}%d~pGC&bȄ[P$- :jks/qX BN$)9||,`trdB L( ٺh !j3Y$kql 8%\ N*Q9O>-٫|;KI'!jBn1HBQS~?7lùCܲ<@Z $!qHRZ< pJy0eS߄_OB&bȄ?GN8ʛGl*E}9KA4>wN!jBn "!|cDxO~n x9YG #1dBQM-I# m2[?S&l(!;@\OA2!C&Մlb"!AA42!C&ՄlbT/!ӿ ! C&bȄ[  8aȄ@ PTucG$!Aq2&dUB ?21C&ՄlbA C&bȄ[P$  A&bȄ[  8aȄ@ PTuABA' !jBn ABA' !jBnP%o  #1dBQM-IAA0dB L( ٺEB hdB L( ٺh 9w/  LM#!8D  L TB"BAGG&aF7v:0HD zdbPh: g쟑7sO?hu+p~N5AQ;dBPEBjPE3_aYx1s:gɳ9:zsp+1IsRGKc8ϟ)0^4~ ɗIHIxِJ+546y^N^;OWцXx3[5 > @vPf P\12!G4 av ߃'م-!y @U33_9N"G1ZN? 璛Ư:^Ӓ$id _ Jp\>ٿ̎.U݂W] ߁/῁/=O|9%"Z[o}N: 1>%"zDSJr"vg*ZHNt}'ɠr[r8~+Ou)hT Q?gZ\$_P֕?5>e31/>mp뾵~?*;O_!]3 0ץ8DG%?cq˯(pea;% /nFBw, {o= jqc]sE7x<8o_-_ ٗ.2_ GbsZ|e稸 =Qp_o;\Ki9`̑cS5GP ۋ8;1|7zϳ:(K-: +s Qr:L(FbwrcU݃OhaJo~.n8˥ rA!ܑ A=" \"r%Q~Vh<*L tK 3ƥ ).EOZ3Z3ec3*j,<5~m8煺 ^7Dj"!ƨo tce|GW> .%E&Z ;E8}|? him$<:eG,ĆCd"t~!J:&<;8l9G:ԡWMIii9 Q$D Kv8BЫIʢuJG'|'8;`Qq>99cH۲3LRr"!gy<oòq&;ryTPH;rZX6/'u*c~,gg<ՖOg?ji: |S=j{ґ 7kuRKA  u-s/󰺵֕[i8 巿!,? ϼ>+x73~^谭N<0u;3 Jq6p}>/N7_ἳ$}8'6 p6c,4+V?:ξ?w<sǾ~oXcw/z[,rv--%WBu e璋@pvX\ o>#Rͽgm慤,#mB'&`\:?oϾ]?21L,l]bq! Hym=: Bq^IA \7nJPĻTNY9_*R6ruȱUIUBNyRl|,5_ qEC\epvXOm#ux{4<$y~;AB=zQ5U ~ ~n$Pb|? q{䊂F˜%!x |⓿ /ZڮO\% L d! ![, !D;CBK@]_R$LN?u~ WWau͖kRQ#H]<-{ b*Plyr Ґ/HBm~'=xCIv=^ ABIHT%IB,ou3 oiV [GRw1Z8;FOÐU=yO೧?Cb>U$!#,dP$qG|V=.[ZOYCE8:?ZW VxHCoT&!|2%P6LqI[EM%)7Ӿ?˭/vZweo@BuP5U ~"S_q7 A$$ހ9]ZBi毖O,T;_[N߿̀sB~{aQF&^!Y~M'!) ,k腼\oB_il s>Ayvw#_>9-Eh9(ym>"ag-TžaIHyb*&g剩 JbKwF-c$ęk#\R͜@H䫩HS_P嚘j=ª8>HkhrQ ʳ(Z5U |K\wvNFr8_'6|;s˝y}߇~9hofKN-$፿/3)K߂o|>'2!2}7H4pSegcӶFyqFE]fV[d^T~>*eP8;A96 QoمNb_K AzCٶ]ve5&? jJ`}[e,g`~pʳ=}9Jk˾>HŸrXs}7+/s}YXO:2!2}+x]ZBb7~QuVH›masM9ɪF y#;Mt& R9c+A9. Aͤt.1SBxK%gOUB<:'αFK<Hze^}SDUzMOB,ͯ{'e'!OMT7oJ&#mdH(S Q |E7`26ٳ<l!dXF3VL *jKHQS@8|W{STcEzɳb{g4=635lYEm8<"qZf}8N j=޹=VZ:Mx8gPD:5٧WZB87{+ uQ5P&Q=%f=x>|unc (?}*tzO^5 ȧam n|4}Y{;q-"z"JFoמ4 W]Bj#!mn%+ɧagS%Ġ8h !j3F8'ϋ"!ATO-$s{}Mo·Q>*!G&P$h,gVN8F6!Xb. :<$!j nM8OF5o0#zI# voN-N!ùϊepM1ѵHB 7(U 1eYx)#HBQ:eg8'9 g/A4-|߄⨿?Ȅ ~{L4|$~O~?U~Td͏NAq| m(7F;lZFgʄu0%Dco_ALJL $!Aq A=" ! q A=$  N2!GA C&aO ! L ŒP%o  #zIAAu! ! pBBAD] ! "TxF("[ɌP%oL" $!uP$D $!u  PiAB^`$!UBd+8AApB  '$!AA  BiA*JAA$  AA8! ! .A*e,' ! !T n~EK@N}mx7tG5^ AABSJ^uR.!--g h6BZQ?L }  Ƨ)%WM $|o®Qd||oaJX+CJ!sMӟ"|qP+~7[|֊n?u/B{ Hg?(|Fin&߀ =4|7Ǒm|9HᏅ}?`h|B(svCiw?{Z?s*4|e,k]ǶO +4 BHP$o`;ku_S̲n%!e2ՖSOWG2H %A<9 A)A 9 $!w37Z OߞxD T/O>01AhGRB?D!x=*y$D|#_!i> b$'aAģHX:hko}Wێ[|cC#&!ArEJ+ +͚H?Y\/Jq2iJ h x?SJ({6yX˓?Gl *U_}$fQzyqV $ɺH?+Sr>{l"5 ' 5b{sg^?Sp3evz'YzlN/Lt|'яϾ෿8gT̷#.~w' bӧ$&A'@eWWg~m8W{(H31UgQ1'S8fPŠT KSJzx.1|)?Y#/09}=k7 Aÿ0FZNݟBǍmx!JbAXAIKM)!D"> k]!!8i*!|cߐf%AlHBPZe 8Y"!DU[G<e!8ᐄdž|pHBq! ! U]?Mcٯ9ئWr N4Ɣ$  Pw>Uy[T*Rey0fLXɺdd.,@`EfQwvaE@8T 8A%^r~s=ϟ{{CoAΟ>}pRȌdb'pLńX @R 0 &D^ @ _a0!_M&I`&I&"4`B+ 6!ydI&./ @RńZ._DssVԎsC0!VI" a15 vcRi7|sҳc^!)A ܨx:(Hݩt)8u3il5!WO:*m޷꽘NHkB4WFFT4~% N-Zm@hGz2[ePgvfЂUqԯ]Vms3д[t稸[JgG=Ծ4wy ٔI"V}J+NmM0VrMwjY=io״ LHд];z.<'MH}m~o)rHoǘ0r&|fjdB eïf&B"&D;iׯr('ǬN&=Fmϡ.s VV>WLoiv6ߗ~ [egDξ)x{/L]?Qs5!Z8-+ ľ4_;@7^4fK; #\AS6!i!nUҎ'o.itcGTr7 mQU(rb?nt6ї˙W_"ѹ֝ oѹ,NbZSՃX=d>tq#sMńȋ%3!oCݨg;:sU!&IVӱhj ?YZ}-U{~UeJ婲"^<8rY7HxK,-фp4_oVL#y'Y0bF<5W[DgZW<,i;αۢL|#6 oѮn{ ˽{G{h  `B"8UӶlv4fkUxoagB$GQOdc?{u3!2K ]SߢK[>&=+ ,="h5tb9M,ʣg[H#_|ΘBՇh^QiwťjPu#U4_  85L<9*.[Ӟz ~C%!т74ݧ s,w-Cڜ  >dʿʍݣ]y7:4v1Ax >)1/x1!UsF=Dd@uO?aӾƯjŭsi88+G\k6uG@y@2*dU0\ӣۊY9GN"種,h<|1Yg6Mci˥HT_u;tsitndψg7WC^5yS$Rw?)@ZZpT/F5!FmVfr:1%ޑ^t=/hJ̇h)(W]Ӻ OYltg1r{{MXyRH]@Z6 Y=)1&mw W676!ci7b ѲFI&Zkh=4ac: 6!#hCvGc3158-, iȾ˫fR_83.ń8߻gCa:&sjtڮLOf:ז}~S}7!b"^"q!;&'k ܻ9M M7U$m?&c+*8߼%3g۝}^T̅y؞ށ|>9wS+MmBy4r6F5!9i_~{:BՄLvT8u}T &j($;,*?2s{.G&7!)YG'M&Ө&jޮ}D;E7 Aʿ~(CŃ:v͢lisM1HNY5ήH̡GF]"u%ʘZSъ3"-37 3!^`N̈́\xzFAPP`ex#!V%Kf&~ B?Uٹz]YI+ +P,F<%rH7xȸ1F=/8$Yi מŭױ̇>?6dB8ʨijt4XΊjlAi4!*TJHMS.油gQNϻhZ%7Kf_F9˧WSkn&RWbʑ呫S57<ӅŔG`xpTl~(+a~<[ަ1-+h*&B~js"稈3} WJsT]~V&ۄMH_f4\&Nz)DOtS`iujtpVwq^;;kgӥ #l2wnNc|˶'Fsp8n&6U`;-`}65MH=]X5 fD*-=tq{O \}.>TJ:+{3R'0r&[_lj]sS4r$-jwfkb;o cߍ`VmW 6!E[#l/_2~ Ϡp[m^aF:o~n߁Q69k^'O7⓶~7Ǖ,rMJD yd lJT.eф_;ugPRmB8|1?,%eLHf4acrp8n&Y掬ެOhhumDZ~IA©F(uSFzq2!bn&vLa⊳pړjp3#W^0Q UʇK;Y++1~ORʩ'/f5N_OCb_ȯ|2MGJBXhiq-Ż&Cmҙ3K%\C h+Ѕ=c洌~g`XW.xQ](C+Upޢ# &$@A+}@z /wG &N"fAf\*SF;No*ѯXZ&^米X }=N_Z⛗ACi: l^)Ë X> MFn{Xb<]/t/NsOU©=zaPxLo*m8YljN+x ߯}3vg]% Չچ@CgIHΏyxSy}ý2FfWL/~8;4ɗb9"ˇn>1~1c?qr bx0E}}=Ctj]>~ ?fh82Lřn*cCV3foЈucFnM{yZo5tB:1R K6r꥞iwR~y!Oo u]ԇ:-AS%h*3)tY`Fh 0!#pV*n]*۽,I/я?D?XR|Omҏ^C>jn+҂lY 4y˿_K]q4R~JKߟ:s=l* rכHz+7пnAsG?/-}\=}>wfDn޺ɌH@&oܪEe{S|=>S BOmFowLI~)^߷41 _ v~ j@9t ӸMB5>W~ɀ,}c)tݦ`--lu_LLtW<iNjèW{U bfv>S2"i!>&M؉m%KTPeBӮas9LuF}ίDysS mi}B3k Iiښ}tcY7g`B J_L߄! h¦)=7ϓ.̴s|K8%O?]B8]3j3>zf q oshVK}iXdYROҟ\Ѓ~8%WckN]1l3+w8bC4:mЖufi CDG(u~cX+u=QC:4o;hB8mTr/۟>ţ!0!DkMH}Cb2v5u ݮ ޢ埯E}Qr^>,VɦdS!3 Y{6z0BgV#nxGbMVIkLʽ L Z—e~VK/{‰$=I꼰򜜲^I7.uo 4w#/S~z;ѝmeOE1e]B[#w3!vxhGy @oc>@oNH]:kT(,2߇oN]u~;pNZq]+&$DSD;ˇ7a(ǜiIz";#3<<Χ#;~t+32Y 4sLǾ9 tJ٭|{Ywd{|WL}+ay_ԥ7Ɏy4jx ;#fՁ7+;g5 \|yׇQ5MXg2_F_ef'=S83(u=g~@jY[C{hE.ŎXy_dSɖL7=Fwaye)+$h`PQ M&OQzbzm/)jOi,ݬ^OP){2Ӝ΋719h$dؙT+/5u}2O!%W%+fP3FF(ؤq$tfΎw#h%bzDŽy 0Q#7)o &D^WX; +>ЀéߪLC6(Kyt`8W7G_\4 \܄ &J\1wbK눌Ql1unD,*-R=SG3R6 9€dZOMjOҊ$dd2`,YQoTF(*BߘLw*Cǫp3!?*.J]@#yMԇ[Jg׎<>EH'rBiN>7 ެ?5r ,LMӵ#kh)Йs:z^`B 7%ۄT_0L3< ҍ?QNHx,1ґb>5۴SwfRT'2k75ɉ>'oYhSUd>w'_T暙.Ket()I[_)mRRF3>Vt+ij)][ӚAYZhP({.[z6fؙOҮE(/uP1)px9r@kӳGRlqM6l{:u6VǶkDFLSc3B4 WGfm^C`* Z"_"_S2]_ DdGhRMw zy8Wt_xEt MnĄDb N#o-:4k;g%iJ"Vuf;7teK:eM/o; `u;b _#='~y{qdF-VV8fĦ1J2Evi*jϟ[J{4~1굇r#&沵aB(^CmL Z"cmOf ]~ׇtQSwؗo^(H~,O}YL|]s飷wӐ8trH^t4UJ'6 fBrNA7hci0=+$nubBha"V_zWr腊 >fOy>Į1hRMKĩ5TxG5V.kr6cznS&0!xm]kB)ݡck!͘&хGG`M.qh-#vjj7/qtjNEų#M65i(z?s=4GQx6!ROӷx4ηMψ;b{"j;Ow߮ɉg=t杧TU }!$nyjϧ1.f4#XiEj5GU.4zZZz$c,:p[}-J&D^oر/߼c})Wԋk}CJ(N,gvS}}}.^A)eKH(WSէV6C"N#7eD<}W;/#nҁǛwix}5jG&)?cԗvrjy!e~Rxzf b#$ HSH^o8u䯀[J8y:/s&}TYkO, ,aѤ&xsG1@KiIڹ]tt9g|TYɝ[b=AVrps"ё@Qo w֔U?16h6tdrOCޓf~8_ K)-Y ħZ)]L;dG)r5:"egf= "^-v@]d&玸FSYJ..5-KPB-o E!{ej1ߡiJ‘op̦\SFώ(Aqh5Pivz>FЈ#><+L2l~sȉMi40i%GZHso`xUO_dfu*rwxx,꓾ZT`cqsכ7 k鳋#1̌D 4 v_~^>|D:z8E~Z9tX^|z:f68y6 9g 6FS\BWGC_m'"+jZ]17I6,7~U4 +lioω˪+h\j.Oaؠ^*^E& )K߉ LjNbcYVeTaJ\boھ!d,qZh&Sjj#[q"Q%EbFLXDzbԤü農A_DŇŘݸ]w~[M];:/(_?(V*XKh۱? Ҕ݌&D^,oڷWi4cǯo<@BD̦]_Q]vZ p3n׉|R ݝc-% IU"̐#50@ТML|EiW3ΒˋH`B|1!V`B`B+2L&  )bB )WdL|W"/ @RńX @R 0 &D^ @ _a0!_M&I!q҇ 4 gFY0!&"4`B+y1I&$ 7_L$ Ӏ jB$0!H +0!H 0!_ՄȋH`B|1!V`B`B+2L&  )bB )WdL|W"/ @Rh ƌdV`B`B+2L& $nB~Œ`B`/& LL|EiW|5!b$_L$ Ӏ jB$0!H +0!H 0!_ՄȋH`B6!1&8$ h Gf4+y1 L/& LL|EiW|5!b$_L$ Ӏ jB$0!H +h&vWdL|W"/ @RńX @R 0 &D^ @4bgL]u]u]u]9oń'lvlvlvli}1!AP~!h8ǘpRCACs*$O&xԿCAD0!o`B  !70!AL H& LA$&  ~A `B@AB0!o`B  !70!ALHi[i1U[>`B  xMȩy/zјٙj)Wγ1[GL 4r@*j)uq; 䑒&ً۪Ҷe Jzմqfj6`F.%&MhB{_u1yׄ$^#$z )yRÇ qVA3?KnGc5MѠ4UF &$1`B88MsT ?uM<koɆ?RK4!*5P'I؄te&MJnALH`B)x58bF>|*-)/$mN[md>uf"wDbB]0N)NͣHyƦē)cBlhaBb?u>Oẍ́:a9/ӄp0( (3!;m,N&d5 fð5"l䲡6c]"cR9Ou]44` ɿL4ƳymrkjBTeTs2c?jz~-9t5O-.ZOU^kk*CZ8>5/sq?WiM)trHTUV2!k^cF L._A1qMr #bNHHy6niz!eLCggǫ>hoэ]b{5!RNjF6A319Antș.*ezޖzkU?Ƕcy֒j{:DikX>,DK^&P#4:]CNv"bB6;gk36u;3a&2o2ezaP#g㖦7!p{l$v@6Nfh )>~ߺݺ9)ކ_c)'s3WU>\FYxxN[scݒ*FhZ녝ZB]3[^Ԕ&},u+eQmB"FK{2!cۼSy˜H}6Niz%%MqT p;}T®Aۄ4-*eʩ;x[*V Cϕ9NՄe*m|qHiFfbܯJш %^ CzIӍ1!Cg pU)?}v kl8k95Fke)ކ_O5O?]Gu ?%ʄDyQuy/c9Ʉu0DṊmĄpl;}7peh?baL&i< k5LɄH"&Lx5 =ńl<;T ]" :ȇ̯9R6N'ӷ>ÌEupntxּ6zҲl[N&+޲\ q9N!!M75 x1-1!CˇJ6DfEFvċ js5eo4b~vo-'lr:^L0!@M.4PuY0!o`B&~(U,7MjB A5 `B@ABC N ˤ << LAAILAAILAAILAAILAAILAAILAAILAAILAAILAAILAAILAAILAAILAAILAAIУ@Ի IENDB`Light.GuardClauses-12.0.0/Images/xunit-DeserializeTestCaseError-dotnetTest.PNG000066400000000000000000007250041470750352700272250ustar00rootroot00000000000000PNG  IHDR &<sRGBgAMA a pHYseIDATx^MZ = #L&511x'iBAR?I*Ё@ #cR$No;6qcCo|N3wTU%ii-l~}>ַT[ןB!B!B!B!B!BXB!B!B!B!B!Į!U!B!B!B!B!BXB!B!B!B!B!Į!U!B!B!B!B!BXB!B!B!B!B!Į!U!B!B!B!B!BXB!B!B!B!B!Į!U!B!B!B!B!Bm_W/%B!B!B!B!B!#?^J!B!B!B!B!B|G _;o\\+wO_Wvn!B!B!B!B!BoO*"7?{G?~>}cz%ɫwS?[V!B!B!B!B!#X:_o\JbQ띣})oo=7J`B!B!B!B!B!gZTRQ{/z3a^|wkvƪo#ĿjKL Q٧gS ?;U&-'RcMvmA5c:%z6Z?HAφQ_KnL#'% !B!B!B!BD#6G'~rj? .sh7ӣU%palZ[%b?':c%}?O. q=gt5޷:uټB!B!B!B!M{qX'1OϚχ헶klZGv Oo'$.~s'%]#>$3X&a6; 5gn !B!B!B!B&ny1/8a'1Z'?k>j_ڮ}kSt?v5rq<ڷF,&>)l[m[Jhh6?S">dxeuk~B!B!B!B!h1m4/8a'M`mޤWW׿nX]f-Ͷnݔg$ R̪0I^zD LMk4+qx-zkͱIx?7srԱA\w p[Mׯm4m=>73%"k6X7h,9:D[) MteӵW[q7+$:nͱivu1kM8v\hE$zqGөH9B!B!B!B!1m4/8_Z'oQmVdZڼaٮH`MZK pc*yx8.@6{NwlT&mXmP'WNS4v16habZ.w6hߢ9J{1=waܦyFxs؍uv1Dt8+g{9_ ѶѰlv_v|Um2ݒpVG6U$61[B!B!B!B!M{EZjk4u*u:?n??[RP$^R9FD-V%ɨMj?%6C{%.' =z bSIL-ϑMjKHUXٟxV'Nc6Ooɼ]?/p86[nǜD,~}|qI}̟o!f(}=)D1eJM u.K񗪏s%oՑMkXhs!B!B!B!B!1I&NZW$COI`%5'HIjz?=G,Q*5qox Rm2^t|yqmw D'cj[єrK}ǟmqY}6I`-hM)퍭gkM3oM.jL*R HKB!B!B!B!xs'uIXͪnX[$W$NtOOX7I^AQ<2dī6eMj'=mИsfxܣ 3m}fg=̟o!1h۶^/1M?6ͪ֜$B!B!B!BdTFߐH5M`mSWW$ZM%6l$6ǩwXAW<4%N`;xF"e$wu2 9u{4}&~7;}fg-&֌m1([Zضm}RNGA&I`ݪB!B!B!B!v[.Gem'I&IXmQ&ٮf X$gM MPdprOk5?_sj^Քc60mcBc=H`m~6M"qDZ\Q,- I4,2\˙kBȩBllDcEY>(nn!B!B!B!BgQYDOKb&6g*|J_q6I`_{SߏnϦ>DRhR[9hJ'Ge2ۯ.O'\.!.eaB\aۼuk&f{51,[фb/]we86};n`t˚/S<h6_Ѫ[.!y͹U#grǶsGsz !B!B!B!BKr) 7?[&zM`mް:u8X+vKj['A% {j^9LrQVls4 [ㄷc?Kydx_k˾I\շAbfgĽ¶W.n!qc~w4Yof =bꍒU랤]u岌"ea̯>U{G7DD]'Scpj\]f?xtkspa=2W1oɏf#95c^!B!B!B!BIs3~K<-y{jo}X ϶:uNL~{([d,u?)}|r-Vc!ivٛ:?ٚݪ}\5e0/։~3u-jq&4nwj >BsX븽6_u:{|ӱ\Q5ێ#ѴD]n}6]{)c\֖QD f(K]]֔B!B!B!B! XEz' !JB!B!B!B!B?ϯ߹%>W}N [;!B!B!B!B!Bl%oEC}X vB?ow9Mi \'}R囕'(o8x3'>*YKX?1,ϕN1$yc,U; oK$2 }P|$- ;ʀVq O&ӵ e$$?};g%{{|mO-*s}zr=lڵ=arߪ̵:4^տ5r=j[_5eڸsñ1eι1q\*knM<U:~K`>u>N~i mR'$u-wx-R1U0yo8%sNwE'Hz<f4 ΅v.Ws!P26Vkr̪nj982S |Nk6.,U:2' 2LaVGol-s|^($]{Rdb'̅v.W%sY&RfXsjhM>dA"ꯢ?_*K]q-nPᾟ\%{e=f[Z,/? ˜0$a^ؿق6*w I΅v^6΅9;gԯWjLfyJXFTUY߆L&*;otrӒ䶺=lLh^X͖0:J9l;΅'9.a_9V ߘ^$5L^-MbRh&yOK`MIzfWP'SIce{YKПCc2LWo֔mR;㪒56)zMY d|dIyrXcɫKZ:|][N;.fĎY'ܞ3M8ޡ֒qz.9S;f[9.^U" c]bT7J% nm0qnzک꿫7u=]9 C+,U\/s.mhK[8rd +k«rXc?*N`3 9kr=ĩaUyoFI]%Vd:}slJ2 ÄȨsz"ϟr=7 soZY[> KRܪۺ?$M9M+ v.Ws!{l{\[o#g6J`ϴ6YI(X%qÑ-z=!M&|ڰn ֺ܇v~eVԾv-6(xGoboYZ[[>U?uoclԿKۘu?ͽ1svW̅챑) 728Vo#g}0U#o LJHL,%)z$">DGo܌VO+$y|Xx> d}WkXx> dz:P* $+ J+ $+ J+ׯ~r?t=D>'W֨tn%? =f 2L0\.t|~ r:ķ/mmGIN~~4xJ`m7I`};'[?W&zz8H`}X+^Xox'I`5xK`N[w6il(#1'9pΗw࿟hx} ]t=g_W޹tnWnS{>xmKug ꣺øS%sC/W0X}Zk;)<1o_u2`6u֗8Nc׿u#M낵}Tm?:F xݸyZIMZ%&Lp:OUz/A y>^8)&F^zo[=ެ/s?7u]pyIj {Iʃ+|Vk(HFw`:J|sp\M`rKTb$.9+1E/9rbR '7}۵K n?=w{ބnG]Lw}? |\k~[8.!/9ifۡ}.hؾ}uqӹؾ4?·62:ٿ%NH6Itnǒp\@M`%)M%}^kJs c iׅu -i^SXSyHv4S]ݏ}ݸ4o\DρqsJ`>Rp׍+Hy MoojbmͶC.pE5cVcy_7 W%I{)I%%Gvu:ѰM0]yܴX_t?{Zt G1/!y %}& A~ǘɑCdZ8ѰKMH $F ]{mٿ][gt: λ:Th,m|Pz<ļhj$x~]ݖ IMg4MAd^c{{"I]p>0N 벞>NJ]ѿaKOyxe.4H*n7zɮrXmXL 2L\O&pvޛQ_ɾ0qNLlh%8O]V>];&Ή'XQ%L4Z&l}ލƕVsX/[-#0L&QkmXo}fxٯe>g_}I'6cvh>~:s y 6yyWc<78Y+LP>V>V)$!$O!!~ | SH``WXؕVv%]I``WXؕVv%]I``WXؕVv%]I``WXؕVv%]I``WXؕVv%]I``WXؕVv%]I``WXؕVv%]I``WXؕVv%]I``WXؕVv%]I``WXؕVv%r81p\/C3V>p/Mͯ__=1=ˎ{Q'|.匿߮c<|?~1i}XaY]˴3|+|Zsd=cǼ\ép$/Q~锭¯ s/xxޫ< ϵnߢVײ㵮iJ m9]ߨ^0?gn]շ]O".|:>6l]厫7_p=̣{NMϳwA%hXx5%vMugpoFcŠ?Ìi%Gc5O=}U_(=71޸3o,'O8 U7c6!mtjZ~|/$B/S6^sݟ5(m:?b;Vzm.>D֭-y_[rΣߧ7oS߮s{{̷ׅ_. yusײ>NKVO-ojw9ȳK}{ ޯޛ{XUyo{æ|'֤Άk̺c|^Gݽ=N;]߾~O kRH`O>i\`,yϽ Nn<\ײ̟0Y%Ys^}ݟ5Zg]tulm}Ykw;x䙂ā:p]ns^Z?\{5Vեde۸hWq5w溳Λ$CpE`vnvJD?3/ǚ"WKnbP.In_s&"oUo˴9?m_PUx)M=6Nv.*r;u¸ odsV>t3wdeכO*$i{9ch۳*S޹K}h;4FY7z4-.79.Tf(6Zmx1Cלm:~L|S1V_>ok~GQԿku#d#Xߜ+뛔<]=Jyuct[vrV{ѹ^c/Z`,g&Hlr0dKgi}ΚgLif}Zy7;X;B9tݽ ׹漣6%m3>Y'?~ҴQm1՜7"ewvk<>֏Hyvkێv=%2~\5友bT}CoҢ7 8 j\YFBho[ص_F;Oܸ^ض/> : jsQ;o]g QRc_U91rW͹]_0گ1ݶwFv֎ZʘVwy A;Pt.} CYs9nܯ,oԆcj_6̵Pv[QeY`{‘p>>(߲`֘l-h绕mu0mݗ0* 37Ϗ%yl[iEy;^pRp <[Gy~mζcwvy㪤}s׍khh];ٵ{.WZֿyA6Hu޵;09s=co06osm3V}T)7s=e}7Z7^Ys0f<ط+wjwkn73Kf y.]'?~'5,͑v.ܵǡσڶ6;nW9&Mϻ<~VkpAT7N,v}tnp9/En²un~;qm*~ P}Xes/k k4MgA;lėQ9Szo{̽:yyjTkÒ}'[eFQ&)c:Qr[Է~- ʻ4֢gݳC{N>Ox~ʠq<̵Pv[mGpo6oX+9o[\*u59kvh;sZ;>[+s(Y'K֍nbvnPҹ'f\oKi>K9f}YQ~\_UI;]]e~w-YsҮ3{tixJ׺kY#g<7"m)M_&˄G9Fȝ)ϴk9XiI^7zXnڿc(\ m^eQ{}-ܛ웴>OꞰ{'s;󮘃QswIƾD|M;4;/izߪo{?Yk+WwOWghÞ+c!zܠ\*i'굮=|~2Nӆݸɺg }Rw׵Xg$4 f[k.-®~ m5{êލR}#7So ZU¡Y{hy\u_&ڹnF| f%_Sv}'_Z7s]7 gxu^>Z]ߒv^6fқ[v c+ߚ\n{]P2&wkNQnt\;&۹l sZJ8.soֺY;YۃYW5\az}Sn;fɸ*iN{pСmU:0&`{ܔіڦ:MFm?jg>yTKTxk̭27oe]B$l;ʷ1u^ރf%wn}ްmJ~9UR&Δ߼x\(Z'{ NMϷ[PsudBsǝ?,ln֥h`m9mS)wOo꼛_ fh ( kNI瘭o[vHm*y.t>? ۦSf!aL[k}1Z76lk{˜ jzyzZ~i צqU%m:鸚*s}HPu/sed~m[nVS0el3kWnXu+SByʑ38*o[ξvwl; M׽{IoP߬u\0J})4 ڡmvL~R:JɶnwTGm?wv%ϓ-ٷTw1oi;om˵nO;e9˱ZVv,&hm-B&vў|S7cY_PKd_Kn^xHm'{MR[ҜFsMYN}9i|ǟƸ4_"zc+ox߬=26ek/wBrK֍>Jϵrh-inײK|NkٗҶSl~]X]*If1ʖuޘ5׷v%crv>/<k>=,#kl&Vn,u}sڞ0&yHG[WK]xqU%m帚*sQ;w6Mnf6i']&)7"w󨶢-$׍&#ZЏ;U-;{O]7n9ܬ޷[w6CS&lf@\h[9k.s睽_JX')ٷT?39A[k]b9sBǴs|w&uPn % jwɍ+o:㢒dPorc֔go1r,ϡv.޿;Lkꕷk𦿩C;!eFQEZBS+-kF{/q~NիYsaERvjͯ kVjUf1L0oudLn!|9Rk5X<|+u}{^n_G̅PJ}S%v.kηNWPv)}6MiXo3e۔ ͣZY1׍&c{6kc5up޽Hɺg;3}!5h۸%m3:JsL|>OnS6 Ga;o17YQ6nTC<}x_?0u Y'oq_R:x<.*Nnv,xTM̎/c\ܿ/.7ck JmG}V}Z1JnZn}KnkYWsMիWUIi۩mڟW亐\*飈{qOӔ'3:X2&7oZB[%Ta}|/)OL;7el/:4&yȘG̅ZB}%X+W%\VNWPv)}W:UW׹Z6Mɾ`8iVŒUŽvd}sҶS۴?_s/2'%mUGޠ)c{\2J~ iKM^뾙)ӆ2u.y?t?e#cn?]Ll&9\ڿX߹矞ذ`^~h)[ɾ06fUGQK(wc%eHSh5{힪r}=Vg~]FZ*%s~{¾&לdLn mu<硩z-wrsaqX;ϞMB<OY7Eߠ%GV;wmzm_kD%y-H8ueIҞwpqUέNWпߜ9خ1+mڹfdX(i`MYWz%opyz߈5n)^V3CSZow.aX;uu7(&|u(j>Z2g݂{V2crׂZƾcb M"^NݛGsmυm̚[ߒ۞3v%nRy2 s1XпSX5&b8O68osXeYJ9ѐ+fէ~cܴmhՍKʍR[i8W$Uc/&,'9\ҿ}2/W]5}kl%NHQGҾPj[շײ`.9{|S~Z=yu?v c2 (@0fxU )kNv.Qm`Θ|N;[o}?[s*9T4Cs֍yVͅA}׍wurU]ׂm硥ֱZ=FomS2Jy= Sl1wj>t,]jm}WA[mt-vթd߈)e77勵Cێ-NI υ`ʪuriuzɴvZ֩dߡuMF75;Ey7m7߈6)vgH?(5RTCvh^I9x< .W7!ͅvB\/4 RQV៼'hভf}Q{:}&C}Tap}n"Թ޼}7h_kD͜2_{kŠ4myǽvo_}4) }UQ} 9Tx-b۵eݯIq~Y+Z;PG}u=Fׅ:U~Vϼ7]^qO8o}N٘,ii m{]?Dy꿫wse7<W%\]7ϻw>g% k%sֺkYx. }S͋y~zmuޡyTKkܹۿ{Oq]ńW3m̅Pޫ9{>mspZVKkQNkyv.䭓\s/:x;0'+_Sпk]麑;NixO1lw5罿^1~\kc/`/N7SCḟ/b7D_f~!Tumn/cM[_r fwϼnl)alV}|!)m06s^ih tB>`}g]_T/1v_oh%,93Kp*oY;M=ۿ>mWU}Zu-[?Vc԰nrׅ1YnZvߛ'y^7c2g,\,VU8Nt}Ξ w?w۝gi~ftު9KѶs~Y*2׍k٦ɻvsW>m_p~ 7-ոq5{-Ҿ>ͧ9fZuv~\_7[Yٿ޷YcLU٘eU-{?οG}+֍pLV{ỵ9jWYJYVKzPu'(U u2o<d[BemdiTmù1yogOcYdQu[9;+X% kf筵D;XwݴCFͪ/l}٘]C |uumI)I}%Do8{`]"ļdp.I~n^I+J_rezlLOsg}y:_tE{V;OV4A| :+|[ y\Cy ?uD6?fbWOv${3o&rp<_/_96]ΧId}6B֛RG߲>q[kֆ<>zzrkxZ\v|{p:# ݽ~\=zv^V{;|x˵ɝ+yIE 䏴u< 9')E' g'&@/N^}̻<|Czxg%խX']ZONWv4j]??_E /e>x+X~z O.L+=oJ`Iף׉{୶~T$n}55cpxks Xb6ÇD6`hCx˥}|Sx<4z|KO->9zoXƊ[iNp_[~htG;hW8&{!atpߏCaCC1+Ç͑Csfta]IYĞvyғ#Xqv\im>|h׍1h5̗v/i*!.[Q{ܡv]'LLJy .9mZ|U?U@ɾ)c$:whqͩm~MIKSmU;ƺQ=Rɾm=} a_=OV&=jv] zZQ'huU[}z-moF -Y@1!n`<-KF5~c4o~ P}:o5x߷*o;?n1 c766Od産Ī͌^rb{uYy+yUWъv_'~hڳ&fn8挩}\gUyqsɾxXy< G"yXJKBa[9[Ys=ʟeXJm-S[o01-7Vs~Σ-m ssN }X$I3mHCW&olH:H9gp5 70wNxTO龍6jOdc7M΃`>5%փZa;ᨄ&&}:V֫`㭝o9̮oX׮Mlߖd4\G{|dsm5l(zT2֍>*Ԟg~0eۤKftG |J[Oʝ*y i4lNŶ}T-`Ζ ז9~+e[0&5p={p]v:Vmٝcx:m(I.y{֬ݩwox[K=k&uyNJxH\i1}llA"p)j*a߄ؤ۽lڦke8f~}$7gL~Ôm$;U,iF/eFDrm=WtE_Jw\[(߂yN&;f{ itHmo ^,5Aycq"ݖ}9y66s7Zs/:gzM&}e6][zL~}_I3}2SɓPTc0|esz,طdնOmY~+e[0ake\wtǬ|yI`}hr$d>NK|P o&' a{9ާk}n׎ Z3c2 QKzQ9ߥzs۟hy^MI%{ڹꕰ=#Q)q׷ A}y^}wݱ3GBS%zھRdGOUkab9`m-hX7,s3j:'} vA݃ߌS-v_;o'ε&}Eڱ>Wvu kWf6dRf܍ h^'H(w1X2|=*EFDrmWYؿO_G%E[26R$+?X2X>nۿKk췝H ƅUqϧcOb tBG| ֦Lz<Q{@_rP{FCRV2%B$[09ץS5{7x1{l$eG׎~.i*,W̴}׫&*mT*ۡN՜8ss5<^Zjɾ`<à`m$,F-PTcJל}Gh+ݜ\0~\+ׅ:ouv/Ḻ]Ϫv_gK~PkȲ`* 2}`Y{^”Ʉն *llI96˵CIcήc#9㤇p͉&w G59wD꺶Tڸr5<^3'{oܶuɾm.s3gFV C6(o1=,s~۪Rld^|X >d¸/mϻ.^7{eq[rgcҽO몇6K*6Wo+W9gw97(=$.垷>NJDI!]M%-1{K.~V~j9LBcÜaB1ٗarDڹUSIY h9gz]Ram~-vu]ZoqU'UMA cWR̩UV5Qo6W/kol߄q3[\ֿ{_y uomwm_:~cױmOkp,m"3OFdH`K?S2igv}| |N٭s%$mbz:ķ)v8]/meH`N|~"y$+ J+ $+ J+N },³|~rH`etuHPC|Jqg&Ď iɫ[^o}ù׸M>K_>H`>{'dAb.6J8:eڏ۪KP|nP9UmnvW_.H&JdžA;ו}_a1Ss&XO ~$*|֛,Lcz~Ϸ&%qqݺ>[ƯGOP>6=עk7%6&}x>&Qā[y6xW./S.iYm۩:bdZҴkʾY?dOcjM&ֽH`oz0$qgĎdRݛOda???_M֗{#5GݛW%K`} | Toi󂤺 Khu{OljMBx:_/ڥsuvIK'{ ,yKc'C(iV# U$z_fl2;"~{`c>vWaحr 㪶Jx9tX[FNJ[IN`}fPv)~Sߦl~M3~6O`l=q1ar<朷T8y< žs%{l/s%m16~n[ hOkj?riF\(y=*PGClݟr-8of}έG:V>j3*{00>ؽv> .j!H}68[!z ,{bXrMUf-b'yg"מYoI07[I}XϣČy5m&pX1jmU0~%H^[VsyKҋ[\[vG]]^+cdmU+z&?%o262\SjkiڶoQ+hd5tЊ2Ow))飙2UJ[r.ώэܻVK|x6-kC~Btvq|c7~^f%nc-%v,sr[$ml\B_LI[+=Mt՘xԣC3^ʐ<*%m;~YBB &49^>?[N.Wݱ}YƶuXEmG^?ʼO\'cX,'o y9J2Fz5.R}8*VAs%mW`.$Wuy=*GK7)+[zޒ1ٞ;ogeN(&k> v ʕ XUbGdIKmi~i&9t!)ٸZ&esC'Oǩn6R5jKkϬ77c ʜ2{&f#_J?yo5a |Ykv:4o|l3^jڹw19n=7%e^,o7f7o;yJ@ tO>><^NV5p:1pc9Ɖ[{v0ךMMX1F*w.eɥw GYֳ`mU[_[6u(jm)7A ĕ6׻6Y\rYd5'Z({'2]n1&{c3s2Ϯ޵y1I໼]kpx= ]tn٩/'I |3Քg29&8m_ /MWoݦ$v2&&L FceOj;e<5Z(Ǫ1ZVs!IF<}VwUfx/9oh:Ig(<_e=6ה9C>y+V]S*]2].]Yd5}(^KHP~VF%vT{ $ԄضޱRmLxjqZ2r۪($wJLJhurzmEznow(mk%f\* \O7}Q> 1-ocX2 xu:zS}N>\5S\om$.I sL':ϗcyI˒Q7[ڸ~cԃsݶK |ifldu%7H@XwD+>$H2jUcr~@=/垷&ĒV?6^n>Wke.z{lsM[$}I2hׅ>jmϐ#eez=>[[GӼ}{Ʒr*oy7]0OW+*5.VMy=%$+$f?%Aq aF~fd7.h+A2Nf"Ɩk;1Gz]k#I-'%_S2ifK }| 7$9yg_Mظ'mjOį mOcmpρ' }| 7INH~wMqG&>߂SH`>>֛-X/$wO^mzto kU?O;u;T}l+$$rN+ $+ J+ $+ J+ $+ J+ $+ J+ $+ J+ $+ J+ $+ J+ $+ J+ $+ J+ $+ J+x+|=ƶޞp=/.؟94Xy-6p8ޒX.dϧpm;r8]ut=>Ge$x]N mɾy>ssm-ɝGX %]C"rY=o"˛GXv sT\ϧKT=\|9K`bgGD+/yz%%m ?ʀ y+MJu=Dž$&Jp9z<aoSkp=/2]΃snQ栽ӥxmnym6A[l`U>ֿ>}Ֆe.mXe2<w۔sP_y،2sԵd]k}E|[k3%c/И8ot-ZM{&C|]s*g @J` RQa'mȒr0g8[9;y.H@:&lxm"lmU9T5{:.m 3jx΍\"]?/sd~OM`]ke~2sFL#3sw(G+L9f3}UV9 XʼWkY'd$`e)::ߩ~Ka"Q4A.|s 6W|Ͳ m]i6tL߮UԷ1TMy՜s.%7mS}%9iFunlR p{ܦ|ѱV=w5MkN b6ND%̈3#fh乤DceYplݟ[Vm]Lɡ:NlIiDž\Q}obλ"yqd=`jkLw_)b ֯hLVJ ׍2gjZ3&o^KvΑ73#fhr&uoYpvVS~V 7s/:ő|mRј̺. 漏v{z=G1_7n6u`mSS hr%5 LϽ?}Izi}[a÷$#\Q}2c$-Oճm6ZϽD>mL;Tk$9K +Ay1{4 Q漷<{hm_vy mbtrOȒ$DGU49fdeI.GA\V,/ ) m?]%$0t9vO7ǝk]ҚSk5\L`ֶ:yenQJm1Yz]X0nl04Ѿù98h*;7(}>[% (7x09˷\LLSoF&qgGHY]rlzOf:TRlm>uíc ?e꿫vcJ+:_}O\ݟ/s337va氮6j2jX{5wbA$m~=wHJ^^cPnͣ\MU ַ:[󷛏wk«to&rLJH&D?znbIXW.!l̾2uJ;%t{'a|E’9C9e.W߰cyv 8!&]c6?G J@]Oi;?k_J׍y7}smU޿5v^I%|J`ܼ.P~݊[b1,so>ob&%H/sIOY\[4oކ{p>uiVz*.7%K`$~szool.t=${ I/\ I``WXؕVv%]I``WXؕVv%]o|Wz: )vw.ur:D>Nr"g^tc| op=HlBkףW;K` $ [?H{ؼCbtyNء«{8ޒXD|=d2O&Cu5~9k%}U[EuOJ`meuOU;E7lt߶[;oT"[}oGMN`Uߩ,zMnپ$oEkmXsoeI =Ww.1V'[BRAbSTRz^Lx,K{X:Liy_VQz- :5w=bOhVm{6mׁ] yXn،צj^ylY7Nk%V7Hs v$(ٷ2?>۩cxx/ر[GsضS}9k}Y[EuL`CS/ xo})~y3kZgo|kS:|[ھ~?ҷ}H`=.oSdaAɾ%y9edS]dJy+ix3?%έ9k%}U[Euc;X\In+Tx,֔ﮱ} i='Mɾ֤6i 7o|lXo?xaOP҇)6}YX Sz\oWm= WHU{0Aǒ˼u&)3dwR;Umխ盎K}ߏI`uoY%M?8&p{܃&+ַS1uF <68w(w=֚m!̫eS[aGs*cE ;+kZVQ>_pFfGY(W@!W)3 ӫep.]bGϼvwptYcdx΅ ץ` H9i!rzOյdV׺p`Lmrݙk*Ju!{]Ώ{]Ѻ Q ~S?k͞k!np˹{Qa5ʿL/7>δ՞{ܫk#خdߡdeN߷X:Ⱥ7e>:PtpsWUT}_ku m;x y\?|k[$`P}\SFmҍײgr]'۹~^{ܹd5ׅrSm۹lϿa$(Ly%\sZOu2cs<nYnڿ in =v׾ %kly74w:fo|Z 5䊴vSq  =1[I}7_}<|_pdߘxI9q uөab6Z6fv c=.cy)fo|ZkO]TRCw2f=tVP\ݺ¸7z^2[B)CL=z{CUd{RglJyL&uUmՍ mn^2麄ĮszD4Y浬mON|JZ92ypذ\ʛP\bzs~P޶}vhr&7uޯL`ͽ.X:Z7ޤ|?3>4l<t][Zj~Y?)Ω2y}[Qgk]/ym}E}! Ki۩muh~Y]*B{4]zz|>X_JlJ{h5>얬pSP m,ER[B)slͣ[ySoJ_  WKfymߘO9ףj?:uRK- ה m=\?[ײv|v9VNp8ϗ[#+,qT [gaERvjcԚ:dFcfu=fm+-Y7^|=pme여P+oFbo{ۤd<ܯ}Ste$+$ |Yd9yށ:9G`otٷmYۆײ5мq̤ A5IxA17QkYc%챂dŨΥ U}V}tl!XKv}k?;)m;M:!%mUGׅ|=7el/zQ;~dk|=y6}8ăf+&\IFq̌9[k-Xe*MH-{ uN۪ibݺ=7\&;4::Zjڪ̵G;g~/9vlg>K`m9Ϣ`l =1I8h!qNm0FI}Sw2O'_;T^>R2 KfIkNʺ6-wmխc-&cqV2GS9ݚ?݁8u=1HT2+k ݽ ~euTBSsQ[Q`{`.Lo^ϣB[ȱ~PZ`|O(oR}~ɹ]+,s]n< gĀ}Cv5Gʜ[usa`͈ Y^P6$y-H9ouv~jzi{][5Ҙ$<^7u5lǔu+zz\O܃>ϩ~O<U7g <;փpz\_=zkيv]|kwpͽm\խ7B:Jm碶*j#e7Hw=wd\`q?y3mayþWzS-{ڔ\zz ̻.eףN=a½뛱nlX~>x-KIAX 0|ڳr%  '-<-o2ϵYɾeK;}fa햄߷'kίxayDeuG&ΙlQڹgX@%?e\,97k5rZI\{53纐/{3smUG}=pߔ> 挏5wMBso>so|_5ͱڹiͪנ1YVO룇Ɩ3B iVߞ!cXÇn'ˌx!qh0|_O~A[AxK$X4o&z t8I$}vM0Se^5&W翽j!y`_cB?\"p--*[R?d2IR;^7_]m1xP_xO;o-՚f,Zp+nߜk}c}:sBַl.UY e#v5z39o ̝=^qb]юQ2W˹=T[Zv[ղ}7sᮽ$Nyi}+֍ w1 KI mL$$Չ^mM[*X2X!U~2mH`H`TmeR O6ݟ_@[::r 0p^ hf ]GG V & ztomU?ODzV~$ J+ $+ J+ 7x+r=z^O~]}^\NCsp=]t|'x<^tc| op=HlBkףo#u^sAO `O`!"a9:[N^U&].O%2j]:x=<;齸c}_·c5w/s|L zXkYĥj~Q#>K`mQy_xOx\Wny\[5yE۪{v\J`}n&{u۾KV$V&>GV?/d+۞sBۯVo*x=&Nm3xmFϛ?oH`=*b{qs"Ld_UgvjTl<1^ ڪ׺?sRڹަ:?nV. w")f}ح?2uN[s6|w/mq۔w~<^]W7%}Zھ~?[$X+i$}.aDPoo+sO/]-٧YU$Ԓ}ߴD}%&Y^|>~޽D7%>5ehcRk&[$?&5pMCĂ̓[ 7 VVotdӇm<0իǥ~a\Wַ=LbT`ɾ#UWUow{kfto+p:W? ֒޷̳r-KkkYOkehhbmi0~~On4Ҙj[s-ks:ff۷{/γkKu:Ypp`LZ`N'YvZ)\QxGjHh\jڠjUuab.J`ݫ[/ng>ߏI`uo%AM?8&pgTF0Yޟ4}^XQǹKFɾCl%e^-7/sI9}vĺq=WճYǾ-5hQ Ȣ=jy5ҕu&;o{D{eG~c:n.c\G ץ` Y5zK_B9~JZ:sQ06̵Pv[QԵn[Yk}7Z7ޡ|?*5|ow÷sM= YJa5ʿL/7>δ՞{ܫk#خdߡdo+vN%y:%qk bTsulD76vss:z47cֶzs5"}3ςkʨMײGsޮۑ6}<~ǚY_k-CvsarLo)lb6@3噖?s^υzxЖ\; 9|f%f(6]?[.u%=ȋ뛵nI;~Xk%x<M='z(8 xBCl%Mxt~uqT}c%%}[tN']*}v[>f]56Oߝlzqj`Ve~u;jNL}6y޹kYoK`~]ϧ.e*Q)‡C:f+oun_}ur=?dVymPv~d5ihhMG5}ҪصŶR믪G[5ף` Ķ 7\%%%}y-kuO%M8yk^买̕) ح{s~P޶}vH9ys׹Im34V}#+ kly7C1oP߬uM3X+CôvSq7~@:c?O3uXySxqJ-me ɱ eO3}v>\vXLiumXj-]gV^MR/.59hzpN9ۖײ*8oX3?tgKKB) ح{ks;U-{Lyx`H쌺L; M(~%kN^% }k9JQԂ:UIE^2gRh[X_WߔE CX!6~s &=ܵm]f< T:&\Ӯ׬aQ{܉{>3hNnw];s/T+O?8\7_G޹19Uv7XSC,G ju(j>Z2%kݒaFrwvر|?/}$?> M&>\&ᠵfۇǍ:ɷ[%]N&NQ\U<|UP{|7L~d\ز*)Д}ߤGue14֝ou[tɌєv\E[WGѵ;g36r\ ] ;VjccJ<_Ig|VByʱ=a0&'7UukKs?CtѣaүKC'vwuX'+tJ ڭ>l}a1wwyusaYJ2bwhNo)s>iph6Jֱmھ^7umv^q=:j=s)>| eQS9;oPc.-{ַײ:>0y=WI_IgZ|c#eW] +mj{ Rx]7X3zu= Q75?x9Mu(k>עB[v=꬞ ן7cت%*|P9*ZL agK{&MZx[RKek}9 CS 9#\RHNBn[͎qaɾn焵rL\-#o\W:gʮGiYc `Z$6گoXq4nbײk(+gm1YھHZd&{`6g|Ju:6cv\5r=7$Vߒ9X:֬kh#rޢzZ=̌ܵjVߞ!cXÇn'ˌx!qhpj:4'?- v}÷cγMEaoߛ]L7EޓPۇJ}6 ;<\16j.trj6QgھzZ=67MfvZ8yf,Zp\} qA>YS:om_C\zѽѲޒ>z39c^3DgɑqױQ^Ǹjj}T~][{={H锗ַn| id Xsz[[&ꤸ6qvX2Xo\\wM~: | ʥsg9m?~9|O`\OÄr8]/V`C3k|zX$9\r޴ڪ~v9ǃ7@}X$+ J+ $+ J+4z971`rπ:ļokh+r=z^O~]_p=]mKkzmSԿĹt=D>͙G*nӮݮ)7|vݾ,p8^ϗKC=ls'דVL `XH` $>Îf#Z{k7o/ŀ!:~cdwu\x2ׅ%u|wQsǷn~O>>:u ?u$â3s~Kʫ[ݜ0R]N)7%2@ Nz/hñϗԖt=&p=^w~ߦa]Z̶*>oO?m)l\z7^?o{oy2ݷ1Yk}>{o#h[U~n&{k]ˎH{lgׂ)o{֭GZ7Wi]֫0^x=?&|wއv^jvmlsPq]XucTXivm^q1ށ:^7ӻ~cpL3KwO#6W[YkD!^Q8NW+ٷWHoyononM2ŭw:n"Ҿe;v[wkuikn3{Mdϣyg8wյp9My_3&y{Zna gH=ovk\{]6cjݰ^=z{W?^hϛI;ӶWະ.gf#h'=~m \:՘Pۦ:֖gZI[mqy~t ѫ|7O~ߋۦ_~_{?̷=V7K޻X>5߃:^~1~#4~W }o[߮ߧ.B5\`J-me^^]P?e/ɖy ܱMD/l%.h/v~⸚=<הA7^?m?/0>q̛ݮK)c+i 5߇&/Ok|W֫gp>i.Rn;}'u.|"ׅ)?l]O{p\g`6wLk>{I?&5iMB04?o&m͍m[!{2 .ɦ \a}^=.u6a\Wַ=̢=u]HU{^ʼ$w%eNYs5mNx:%ΚkZrn=tL]]׽;=:ox; U0#C9Թ?d}? ͅu2Gmi}( \l|Sv_۹:u 5ׅg ^sɶϛvxO֜֍>o9{:Tou371f_?'ڽ˷9rLnQ57s5w֎j 6m$E3z2=I6jpj yBVZJϺԋw <6&]spl;%3Kʼ(hYI7mq{v=;:_m8&ue7([^FIuK7^ %R(4^ptƖetc~۵e+en`}>C =#r$oYW\fy͊ox~/2umNP0kcgN%O㗌sǙ?MWf( u[iG/A?Z[5s.bѹ `|}Wێִyheͣ;F(nz'Qt.t'Mvn {_9l\..zU,㔶)ke5t}ƚ^2gϺuz,4v:$<^,7S=U5gDM\ eUaUj*ՏJ` ;چ=T~h__ێIޚV7`7gj}յlWpqP[sjfrMyn seBfۡ}o_bbswӺu,^zMu05v<'|QIY{\6.ȹ[̇고[_vO|UkZϻN0R4U㹤 Q|Gsay裦K{\^ ΁p+W[9ls췐J0IUmNyx՟U8*Sɾ1&v_U%ݱIQVv όp \oU/wyteZ^ ֨vi賻50e}:oJMC`y3n`LclRwvθ+,s:cZ dalx+9e^.3uc)kVٺd+U¹S%i-hoߘK^}`ښkrn/m34V}]Ƅ>ymB/__߬uڹRRvy SIisphŶkroe.GA}&O)s<H)]kHO[aٖښ>K\SRqtQ\H8S+yvS}{yI({B|es];Ug̣$>o)c*aY_uw1Y:/u!h.}lz[,y>CA MUae13הZ -e7S ]CaVPv խ[,i5k_GL%2k~ +-s7cmc tbكطHoB RۮםwNWm]8׉t;{c>Zƍ %n?[=}Ѷi5gF7wuye;k_h)-sB{%.sC[yK˜8˜;\h/ցٺKUʵ0Q\ʛPdoL ۖ62qW^S:sm۪^nwc%oP߬uڹVRvϛ{5Ε;NsV2eʙGsMfkx֫7SkIoWm*&uWc̽F5en?ڹs̱jv:j޷V[H;.ܷq]׫,Y{jY>3rlW;gseJ(oB9d`-g_m;erלλMA MUaȊUg&VAԘYHxrf ?O3uXySxqJ-me|rf۠a" . n*%>?khq7;+Sn#l)헮GFeK8o6e|PbKEnZJ9כX;Ǟ07dh'9u X}9QR'B6vnQX]"ݺ"+sKRuq\&c19KzmQܟ})m;M;uxB9^n[h˰^A}s׍j2`f EhvΝG.{>|zUz\ڿ $Y^$υs4z>zظ+ [7?_9uln7VׅoX6x.VkߝvR[5r S+Q;_y`~W^]M` 'RXBX=Xw\n [8X{w8)oc)2)c}K|[cխ8Io MlR|C[ܺ;[JkJ7cT,QlBהq*xl',ͥz]zG+-sLXs0}l2ρ׆y+3f/R^s0\_Ӷeu^w{Q{%7|ЩzַdWgN\MV˞ί upY;\J庰;@3-̆Zs֯?du>FJ{%Z1FvUX_O?ޗ&v}OCk}o!7n1{ַ=W]jo}K|[E9V}۪G8/߭ז\uh5۷y>G˖)<^ZuR}Rmޠ[_=&e[9X%s0V9u<VȊu{d/R^(n~ M(~c2S皪WI}sqҶS۴?_XS%סJ(UFھ{7o^/X76\ς6i0uy(Ehvbmt9ǮW<-{x.-GkJ}NN}J16"VυΟ;v~΅n~yƘL(K–s)Xkf]Jmr[9C\;)ۭ_j)/bUu}w?L78w2CJNm|$סJ("`f4~dk7Fp4Ml#F.D7w|FNg(o{CZ6wo[2Oh[+ymNγPIlٟm y'uXq#^vM pj3ἓeH퓶3c^SҶOiϕ۴;loQݣy0cxΙ%uw>8ZX]B/֞ok ;o {\;UvԷt<Nj\+3kJ:UA-yպu?H~/9ޱ,s0m7A;fC׺y)bs%z|޵r#joڹg^Uŕ |Cq"y r">V J2?| *[\cr(A>nuum1b0(낸^/W/xi+E |5֠{j :o~=~t^ᱚiy{n|Z4gE@W_c.2rx4-5ih EfU?XfscKqmeڦS[J4.i \m&n\s֚Ds[uڰ-Ml}T,+z5s72qeiy<-uۘ B*Ten*4c0AScN7_M5| fk}Pϧ}#A<6+A,UѭQLGh\=ڱGCYXp o\˾e_6F:?k7G9?o5]c5Zُ96aם5W.n/GϚc2;0[˼|2':c#xRWiPtỸvYX`]Ǻ|Y w|_9vȜygVdgX ܗ-/ =|6TXK 6¿Kv8t{|ڹ9c8&u0~[\~zt$!3_ڱH`vo+FA CG;:~,Gr2{렴?@ XTpei~2e3Q4f*VR#.V"yC>ZG5p}6ѓ߯Y j~^8Xwz&X ([Ǎ/$7IoVǠX1Y$^Ћ;ed]=$~[ᆓVp. a|_MT E$ͽ}INE0>2v>%_#2_^f$&iۿ5%^A?{;-?1\ W^M +h-:gX[ƾ:\ww{luRbf?{fuޱ1s7>$_ p%$f/?wX<_(wll'<i,g65*IY)؛U<-w\m~9_0}BYn<= YWeblF ؘ$y!51\ $~OjޟM`n쓙leLf#g\m~/9A7n~= 6Ia_ÈIXA}96&IAH`` Wr)vsEߏ:IL+&SmR`P8W~Ai4;$oHb-q;m<'>L06OKJK6ʆA:Q+G/{g룔pծ21m&Ͳc?;?\#6YTԱsӥ{"&%ѿZCy{l-Iih\%\~]G=UwosJ*ƪҶs݂ΟԷQf,s6[^C`2zru]s& ~"a7̶u-yj}-> L)}eMsTqԇO:26h2Dd啔$1חշY~q;61sBc> iUf]{|n*3~z\ClTW`Xqߦ̓\{6{v[ۮLTP蚹iu[  s}'3& y..xIq(yRO5~~n}iC\^WLvS>ߛF96γєٵ'sFvc&cԖ>oW-kolFuC h .m<1`c%Lvec휝s5}+QЎV'WW¬e8n m kpٶޖ:KI2vṈ% {zfʷYa ˶WgٷG]I;}Әz낥 -UU}T+ W7sݏ^WLvӴU]X>fkvQo#e{A19D\VA;dU <>^4e0X/z?8ƕeuv}zt;G|1m xT,">y8Xo<6ڈgJԷؖ>ʵ̓E2ZJχҶݷS'ƈqǦcU}ǯ@ƴU뱺1 74mUWKfm<<2>hsF8R՘'g 6K`/W'"hI}1oFˡ /|9|jg\#6Bcay}0M.A7ȘI;۹[gF>[4ϊ2Kջ^i/ʝ{Xt9͡T^G__p^?{?zL 莽<8vv甉[X΂tݥV}ctMۙca!>j4OjԮ+1O)VƠ7dӴGr.+ؘ*$eAڨBZU[v͓w0%Xl_,>mO3$"Y%fvmYΊ/;omм,-S=)_Oƌ'h9%ؐ\y~VYr-zq9{7wc!]3ĉ5JeOA}=}LZ7lw=%w^[5};ݿFoc]󰢏"ߌO=]%lw麕.Ә0;u,ss9eP_#+ v}icucPXʱGo/2]'2`TL!t'u7_|iڪXbRbd]1uA5"+m[CHj+3O_]] Yfc~h߀_'|R@$p_R3U/5bZٿ#n8|,ۆrȕctmm׳aWAturp|^lGfSNjl&t696')ϛ:9gG; B$Vgm8lB#ק=;q*h| ں~[v/+w<9&s}ѺpXkoI[`}گcx=c2o}> DiS=p {RekŠB\M[?O_|p r iuM͐𧹳_0DZh͡6ךO&5fBt}l_nκ/5+,h:W`~۴wffX6_Q 0MY'6T}J{'w]yϪcPAan^M02Z {(FWّq4(0|ҹi۸ׅ }sw--G1Zsmӆg#_8sEeq[h/ +_MLmf~H7e ۹ s!iˎu6u =CڹcwzyݶZO[O,ju G-}'uzop\/]_WϺ?# 1M}5}ex׺߯۵핡*x#4a}<<~usNH~ [RKuC;^er8קIf;I'%seS*imbݨ%e[> lcϽl$Ӡv6娏[ L'ƀq:?,sqa6w%NkdnitϱF0~w9f2}sN?D diZ>w6\՛Xږ9ۿ-c hhG93Ǵv-GsL}W/WG2^)Am;d β.cN:;n\\}?m_M 9;O*ur?_;?V}cw zGyryh=T_Bv{1dٜVc~d]o{d].|8I™i""0جYޓzOimROA-/~_L֧9r.9I2&k;VӜcӵ<۶Skۺ.lu/,v1(WiYA*ϏA?WhC8\bs^aqEԞAK1v4+?e5<ǵs&:M1[-n v3![-y;Qmjd\uw,WR?wnf`%Iӷ5wh[ =cp)&G[Aør,^W+}P7&&j+](?GGH^a~-!6vaWP)<ى+UYoxOHTHB_Ǻw.ɑz0 уe-_\O֜qݦ~{R[$4 gL{Zo"6674 rwSfB?~\7Ks[ַ3kk#c_-N}ߞQBlP}8߮ZV<_ ^SHr]0cS7yY'^sK&k#eS=,F^S7[}wNOf X { uzt~( q|Жz{^/D'x-y({/QW2r 1/﮿.7k:mcPV1,33ꈍ6y_??k|܎+c}| DOeyo곦<;XuֲϬ{$>\SN7WeV mZcR~օQX>גּ~SֺJE>Pֿ&5Eؿ2]mtgȖAꋾ@ b_/6O\=xv|1k7q+c"o\g-ܺ#|ҼI2%kYU|5xMLgA<׆1Oc3'UůH`ֿujGڳZSκ7k]ojo?X1){?úpojCI`C6x7.egQA"R1e/!w׎osrX)#ƠzM"ue~"m~!6>󆻇rUWה .ߗ< ֡Xj-c~IkϦv8bM9~WpvYB֘uAu0gh(Ke$bx=kY/ Add0wOp~QmTށm6%}/H7mm.>Q}T߽rzue_3?L,mߎq:m ︾O$Ǥ~mֿ X}e43M[836&__}D\d7Yg* b9;%Z98ֶ=>s6!c7l;}ZmJm kl|'jSg=W^}`e~65L/l' o=\?ka׷ܱRtO،ZYyЎ@?vؿGrgvOs#6z91czƺˬVM^]յ)'~-M;Gրk;a0}7:dnq^CJО`n|Ac6/WraTD~׵Zieq(G..,I}MY|}V}cҿlt߳;^>oƂmMkcm ns{O8W:Q7Dz?e}ɍBΛ9#6t7Kb~Jmf;gw\FնsW`~^Hħؘ]86z1U[3C#gZ|cw*}F#TS+]v is9}_C}fK>^cz | `'Sf'=s]OlkHb-{mx!m߈#Ku3#̓5OZmdmwyc+66,Wo~;KmkYg`*]];Cwx mõ_!nq褏vBEp`hoJ 7xs/ q0&َ˕AL2Go!cPZ_Iyݹx?5|4&m7oX^> 3OY)w\;kW9PXG33;+w,~>&ceMogAlvwD[@mCayuFo~_mQ2v6Y8FЪk~vj!(Wm=Q=6up)s]1m1xS/#.1>Gq&%ϯ,sMs]wlb]c>Owd[%Ao;2"IX۹yVH6cYAO6sh)Koe; W-BʗGcsijO)-|xNX؟w^l?džmuYG]lgZ֘tj-W<>+OS;.T5P񜊱?1Bu;j15ͮgc:NH'Il^)42x4QV2-.v ޜ_Atw6TIue72CƠZ Cj⛩61*׿yC=~kV~{lw},DruXC{D}+w,z_wF5b#e d * uטvnDru>h~*bcoņDU5V+z.#AldM)s]&_ԓ\?h?ͱIXpƳDl92ZWzooi rﭯQ[%㱳JSSu)`Eq4:v(թAElנ61N,o=r)yDl'Aq[>2O }S;H="u895c!:oS5ڪ#Ÿk97r8b]X j/BRo<.8y\7TsbM^Ku%I`fz$s B~b`7Yl'Dv%˃TVKM52~z^?oNb]=WB ąxl1d +m܈IUU26)1ycqulw},+{Vv.NsNzd꫍Ո1(;zYCڪtß,iϑϒFccon-sSV%}jL5єj75OYOQhg3&l8wcelާ96I:Qz4"u+e;3"\yh>eǺl='2y$9O:2ۿt__ul"6\YkPJO\>$GelʥjiGVΓ27t߳Ͷ`q>O[U|ɶF= iIkmźź'օj ͱ*s.$4rѨDN,t6H4j3;0t}:/bv]{/\Y>/$hݐ1(]eWcRU1=󆻆̶MʱV=zlw},+a{-\=c.~{=&~S\LtQll^ڹ-6Ʒ25h-_^gU$p(F ~{jg ~ޟuϭZ"> 6 r\8n>}9Z9n}gjhM*BHG2he&6ܿc2s][>W@+i Ǫǯ̧`,ٵϓNu\/nGicP̽}wAE}OqZ+W泂%eϣ+ e;a2#YZȇ+dle:3f?dڶȕ_VYXoƺźPaY\WcEOs?.: jAAHuA}@;&UeSW9o.HTc~vvWΒg\AkGܙb1פvVƐj}y󎜟 _%bb\\ɽ~ >ߋflnҔ6oȾ=dNG]slU}W&he*65[޳wX?119m8XU2yRI:HUFo;*ϝ]M\%|3YXDٰs}j$4L\4,o=%enjiuf#+plH~i۵5ĺ~O]kLޟ+wօօ.t_W3ohs=>e#U-FΓ aAEhW,}IV,?:Gm'"&(Wr^ B҉QYfWNEʮ jAIA]SחkЌW>Z8?'%q G1k?Jil=kR{; b#<ڪϒ15ohוOi%fclgI\Au b#ziA{%> 6 hP~)zqE gj7?}~ͱIұ2b]{s[IȺЯyCs$rMfW$j4/p6 FX. 'xcmo2J3[{h*MA,/yjj-4z'"+Y3d J[7x#rXLpX3G}cA6^}QWjQllhЦs6Ј1\ Wykb۸Lթ<'0?3?WjQll|3NV0닟32Sb\5z5G|zldt@y(s뼡c?娱ΛPkgǦbaGGqe(yJYb|=~kS.wu}n{R[g2G'%n;O:GQƠ"6f,[U\ՍLm5kYgyJξLqh{12y^KƆ1ƨ*K['m1O'4m%=A}tÌ*u_gײl渄B]\뼍{$S~̏0cc/책VeڤV9([wn91d%" 3օXu!#ٿ j捾c;Ҹ ֋H`dI :dY<уv_sw-&^93OMe4i> ki2k+Ek6;?ᠱL4 %}L/<7g&h\{2􋺡+_cniQ_[u::&}3'->߿82\dc-Q_jg~l(Ue 鍍548~=_︬zJ=kն&ZڹԿm-X7gIungIbm/ 7't/evmM-mU_i}'c>GKܹMmO*ҕh7Ո{cB!c̕1 '{Ռ(^.>}qgWYtJ]w0ʒ.Fss쫯1OeӵRW+eH#{r?c+ŕwo8ox׷8_ͯ},pߗQWǎ X}<`ޘ8{kD[Uhg][]AjL][Jl7u\uAV; +օmpֺ0⺚yؾ5 ָ %X/O@k1ZYa m7b~F26//fp?ܗ[ og0yg -|Ր}s_uu;oM!*$WЇ5m|/z/ذml}>i2'X2I{$UIZԶ^g_uu#u.K(5hK: Z~3rԱa~ϗ6fOsI~5?)Z<cʘ'q> #>k5XXX粤 q> @k1|֙x>9Cbï+(בF0y=|従K3<Z}ź7 r]XCn3ɛ/{g `]y>^uX !: bzz0yW=r|5،i}rޚB+E+E+E+E+E+E+EELy%%<^?ek=IbX|~qK\/u%v6&naɦ}M?wX oskxp뗚R-:#n)kJ~+սwtljbt{O{mjKDuxSu/Fl?FozOOխgd):-񱂄ҹK^}oV->=o@%>^.ԿM~u 'Sa^$Z$Skk'>n40XTOCuא>uVH` U}bk$4!5bOWIDATM׳t% H`ݸ=g.t$- u+z?/%ڧΆ%{=SuEO}d.5I߷&~詮WpV&Iz{t{=OoxOO~UrO_%|%uA.O_? |XXW?+K^$^$y $P$P$P$P$P$P$P$6| >m?_| @4^/x3SM=?um1H.ޞ-:ƚr\̓N c6 qƴmJ}%ڸl%b_M` Ndn^綘6}fmm~zƩ?|/[SN<_`§|<?cVc#w!"% HC{kosz?v"5&X3kpzt,?ss$븱}WƘ1D=_mccۃceu]ͮn}/QoOZv>=v,o=w/wo=v}W~ 6SWAoAdlg w I >e/(1~#v>,uP`|0O~Z_ 7}dF;:DW%?kl^pλo:Ʋ1|o;vG<f>+CW2> ڻ4ņ]k$sAL:J[v>V2y2w|nRH`=rE=c`d2Y†H^Α~HƢ=9]c1i-kR; bõ۶#ڪ7r/ J)(WGSO~)s]y?sJPqu)7LslJXDQښxh?A5uݱƋ-ct.w5^Z<ޑmlGך|S'c!nq4RG[#){쏍 =[ϭy$@Y_ijf7-җ̗їӅk4UL eB<~y`/srOX^KPueGl kߧh(IUUk_KϵkclgI\Ϳg%s#M=\c(6b 6IQ}U-KV]}b(-78Ҭ tJuK_ %'v)78~c> g|revu[[Z{ѵUY2;yqx4e>EPI\G#˜nR{TĆ;x jY0o8#uׄ—/(ĺ"-pcW†we6G̗ mP_׏v Q뻧l~*sa31(]IUU26)1qulw},+{Vv.NsNYGژ\ҹ󭷝1%6׽uQSW%q?=4eZ?kkmsz$XG=aGijN|,sg}Fĕ+oG-=ֽ XG6 _nHci2%ҺY6ǧ|~V_/tR_G햻Vw} Y,/Uel J5]!TyL}_!mrlbO5?]_e;KJ^ WK^Opo6i>kRW;f]}%s p.W/;q+sg MXAvܛJQgXe<>_)YMl.e,}^AVWp;'2yd&_Z]6Zey8:"nޜVU_MO!_ɷ/'#18(6UqUQ*n ZɄz_|t_P~k)%p Pɡ+0m_/ɻ6X0_׾.ԗ޽S-LЕD>1fַ6o18p3찘eNk~/׿y,k/J4Aj۹WM1# 4~v^#&11bʱ;ujh=#>Wr0mEF9syhϗQrѯ7cAso96% ;>+CσW2GkqX^rsp{ݓ8XՔ9xflnk^ᗕj_ZNkuh+Agyl/r}/ D_}+Aa3AW`{[ˆ1P_nா͡sb20֤vFjnx65۶+S>b?C|r};WPGeÈE?kkE癕ǠF7(s؝qGϰxyRYQذek7k>2.x|s^[ujj`VCyҒ^GuYcPuC3>ܴu~^W̦gWml鏫ڱ1n H u%)$< |jKDk< `w-M[zS̗bSLu>a\;z҃ῄl;B^`!sݶ}!,te^:>ep4y\-oXnzal'_vh o /5~n?|~OIyYFzc#u 4_;.ޥҮ)FmoskkMqu}ٚ4G؞ua;i}?YZ2~1};RQFu*ĕx,ܛYBQ{\x%ދeVק/q[ \fu1uݹ¨*Ktͱα<;yRNVK]fط#ycPwck?7W^\EcP[UZgV(k1ZYt$mE`jIxXI0OL#A,Hf $B =9!/[`yg R~`u$)sW]s`zvR,x%\Ҟϴ=>6an )bGH@'X!7_JXCn%&QL%#@ER'q!#&ǍfE+//I5v^1K]Ryܞiwouؔ ̓PfK*>VVVVVVVV ߿ }ڼz&ד-~8?>%^7򼿦ݲ[%H`u؍o6`XQb_@+~ fiua+hK8mIb ~X?U5c蹎ӷ)W>6QK߸h<I A=q{Tqkng$|~]m}k%p)$.ja67?:&.u9VOyO>yz]Ž$1gCj>!lK`$Ҕ)2QmGƘ3~%CmD?r}XgMQM$ '=Iɸl^$XK?/SL't|I橬>62 $Xik۱Kj>֨'Ӛؚ'αZo\SHuƔ1Ëxޙ˴>mSn` ^jymEs}?5g"u&۴n"_t%ŋ8R', ;rdr%d;{zڸX6yǷO%] pzXf|$~JVj IX/e5gVѦ#۴%''ot +lHIJ"C7#'LEx+$勒4>y{V5 L|`>^Ν\}-l>%U󦶽`=iW'"9xsyiczXWsȈ21i)a8oN ʌɸ5~{ƒqϴsV>v9xR툄ZluՀ>22~^\w֣;r8~&O,L%B7$[65v2Ynw|bSLFx̉ Ɔح0A[?R ~>('].:o}FOݽ'q*O%ז0'[9rǏ(ss1]/K7~jnxp^ 浝M\ 9z\?$؎AL YwJmV>U*G uGqCZAXÍܿͷrWg \nPٲ!e} Omoi9Osv\T-r K *o>{*m6?6LO3mps| 籟J`زm]szw7ks{rpq9{ʼS%:΍:hb[ϕc}[qlhw䐱 WFm g9kKמOr]^ߴ6[m5ܹ}_[YrO-9{T9]EXgf٦]n7N8Hm6m 636i+wO9>w 9n2iMϗIؽOƟ[~B0#7JVdrS0nU.x0mַ%'9ݺg koC,^6dL'k%c*艍U{(%^>At[se]׭ףE6[(na`hXϯo׼qvVm{=vOrswc3kӱnT7'?ߕIs_+s{DE덫o2uNXܾVr;$TͱO'|%'01NU=w~+ӭ% )x-ij=W-숍WPOߤ`ەו3oL}s>2]O&F1&R z;87.~:%v6evM]u.;q zcjMؾLc5ZŸhf~>1sy]7ͱ*;/E<6,dα/S5Cq9tMj2缟˿ĺQ$;~rX{a~֫^_M}Ϛs:(!}TSjZ):q[/=lg|K`uArNo `-α\p഼wսyl$_[ -M}6mPbUsw}Mܾ.4$sbd;o1; i/jeͶ-Fמjckdk)^wv굧9&{JG=vj=F{Bu.PO|o%21J 6hל yc5 N{s{>m0ʉ~=קf2rx4 TbPn\>ev1>vTXH%Fg*?[t⨶z 5J߳i>Y:oyL޾gb$6miVۖy (z{[eNC|q?+:=~ƆO*B:d1&nc86F5>Z @K fQx-յI\][9Ƅ\~?V1o4 i [8OoǼ1J`l*TNJEpMHFM}伬f=je.X'Q9H(%&+0N쫯`x>ɠuN7~"u$B\۷%%A0Gαk?_kW 2k_:(33->yo_M\4H&UZ,a_%!՞;dׄxmĤ>GB<ɄNur X7W+uI` 7ݲ Ism6&`Կ݆֒@:_ئ`a0MX<,qVw};no־Pi}۽`7<0)i,T6#y<*c`[>jاm!3<߆jxZm<)jc7\0hׅԱ5CJ^8J(۳.et6}5?~o;}#MlhWW[i\=;G뙝{kruNwC92e麎yB~?V4#_x ]_y{,&w6o.I`@'Z+.,I1IS{2/MH`1$|{p-/mH`1$.qq4?m~;|4?՝)y\ @'<_mB9L'$`Xz>nϷhB+ෑK^|'q:=mɜߋ@ I$P$P$P$P$P$P$c|ܒzާkE+æ߿ c9v\_g/k7'qq|=nׁz#X7{F8@+%s +7^um07QedE̓?l8bA!ɫ0Os$֫}_S۲l7~_颛l'mxn6r4ǧyĎog~4zoy[o}K^Oc#!Ҙ灖$6D濗{1Gv|o'^_۽aͶo'L}h,֋p_'$$I:˨ !}e>quyO%N[=t';'%1)HR7UAE|$b6٧f}A<~O$?nnIm|n`|f|Bсb9C0GcW|E\{ohޒ">˿@??#u$O92}}~EdnS5!̪>a*jO2V>nS[,[yjAj6MT;|>#775O\)WLu]e[ljrxA\Y=VsYsyG̓x9O%\,lc#-&EcЏܛ^ܿc͜noA~.Uy^9rlI5RP>fy}9fmZrs>E2fovʫ릴Γ{0% Y[L{0ߋs=3H`l6<ypcz}h,y`hxK}Yl/wO3|ZIxkכּcsUmیX#[5y)Z?γok,3e2kǑ?~ qh7Κ2]_ދom϶G3uwm5S^W{bak/<}lk-s]}:x`^:T94?&}fׁx{!jܿ׍3H`=dcgOg&8I,ke#V%> $l#_pm$z ?AEl },΃ͽߘf'5{Jpd.Ss 6)LlIA=Kq+('c2(KkD$_ŻyJ '64khp涪i~7wM$4KR [&\).Vh/o oʸ+S6|JbH''ڶ0OZz)&lI7v7$8޸l:+wN]ٺ$,yJZm[u- N"aD!&[6$}.xvz777 9WwWq1ۗ2%i2d|[mn/_mw[a{ܮGJ>NpܹܿT,|4ҶR]׷hNh񼒶M;{n 0>.,fn)$ŤbVycXcC9'Mޑe&QoTe7v#?ǧl"~7iPƿ`CLJӿ '闏Ź~[?VW2uլ{IJOuSZm[iVI;_tN>wzվh)~#y-[t^Tcdʦxݜ]򉉡D"{_orJwL֎q$m|硾ضn-n\eS|4ҶR]Wҿu񼒶Mro0+gn@STW׊W5o )>+ #U-pR^ߧқNM) Rdjs70jPƿbcjKp>noʸj@[ug%63]WAl? mx9!hZISFYYo~Q;./^7Ǘg楏alv8&Ww+黆s~c>W+= }WD2y55slܽ٘e>Nxȍ_]L YxV1͗![sH` r//Ż yı:݉5KHmۚ47V6l-UM5q޽XѱUo[:A;V1;zyg<4F!Uyhasq++dz7ETj+ڤU@ b!4dSH9&f\֨mU柢2Oez=VWm+\Woq-B77ſ<϶=/OʛkzTg? A=kw8fH7rC, ^^&V}ԯ>GۻǑ/ݸ ۵g8NZ%|]q[;➡)x޾&^/{cjZokrq e\)~x ĕ;켟$X/_V`y݂M' kٍ`$>xflnk^R8̹VϿc>&>dmB\QKąI7děckf]^&YŸh+q4 *6X}\󪻭4s]&A(S$PU[oB4wUDGVO&.ﷸ/ޛ6?6fluASl~Y,J(yFX~Ůy<^s?q{W|P}5CU,IbLQ|MܭL8.q^ jMssbrnx2Ykwpy ]qnof&%眾&J{ Qsu^_<fK=wݛ G {nXĤo+3w>4csYEes,&} ߌ0!dcl*'S%X&&[rmxќ)Z\qlW[?۽zla>\W6vϗYJRCvky=N23|;o5cQYEȌ}~CVo 'Yx^}>v{38:~n^7%.rҏ_ELv}\)yyK8R':Ԗh<~HrS8mUOyByZ%p䅛y2'ܘ:uM{dԒO&Y.>$D6'mx7xv& 6澶OqXim+W}F74ch%;.yUOE\g˜ygB1YdTI"34(6M}QWq &NȌ˅66zףu?c7x\'ͷά~XM"iXX]wT\'yŕo7(Ϗֹ}a3Otv_D蔖EIcYKv2\]JVU>jާdc!c|[k!J> ԈXU >%.f 6ЂVXY1l/8h\ Xܜy-~ 'vXWw z 0#XĚ s%v#I3{%rN=F"4X!%<_5$WCkoN`eE+\ޛMrz =$""""""""x=k|=S5 a__xRh+[/-5_u-!h$?ozw“$6V'qXJq#Y$WWI>.$^t=LR4ݖ6MM8L6 m?l^'eP,[hxEm7.I0 6K$<_ zǷYF%1;Kh&y%琤4$W$e^dzۿwֿ}m}b{ֽdPE)#s $^ ~zܷO2O |Q48/3ǒzY#2g dg }yDVAOLا>_w xt ` X/`#N b$\K`KeXH`3:6ֽXi|+FOs"u& {'.u' S6xm0q~\q&ӿ1.QjnKosهBqfi\Sznj0cdtCwIk`\5ʖAεkum[\/+{ڪ+2jDOhi>ތ2 aNO1}[}|-[N[CWG9kc9~準ɧ;{$yegǿ>::9F{P ~ #H%#JZn}hӺ,$U3)&.:&H4tjN*:#1_$R~l6$-4O\c=WJc+G=s"hIT@cwU/VCȕ:W?rm^)yo}=eٞ<}Ͼ&dfhJ,mQ>{!yoCAmѵlõyC\z99:Yw_ :)#Ta^OTxV{z拜zIDO>3+i,k%m 2Js䎰|yÄ `5H̊"u|f>AH>eL}l=q%n2WQ[#Yܥ2ousW[u^e>k+Am5kyoƈVel2紽'"NDZ\OkRԶ^k{| >:)Uȍ Iжs2V*A[BҶ2\{%~{>ve`}{|fےM.\˚>:+8L\w!Qkc"u'>Q`g`p;ۄ|>գi6Wg7yQs[MvnGRC,53;*ʝSfWz:I,K޳AV#Ie>|ߵ&l懆,'Qژll׽cﯤm}?g-nv̓ɚ>:-b[ H`!(/`9fc=TlL'7zTIHIՎ=,' ȜK/sq29evenY\'eZBڶ;̇1^H*pZ M 5_Wp%my5(L^m v._YO4}tf<'mZ&5l{I'J>̕gNlۍ:.Oz뭼 VݛoI` dujU\'h+{V:h\[͢9vti+\{i#ֲcX;cx͜:S^lW{㫇6u~ѩ8WF_`J,5.~ 2b\uUoBa\?lb)ݱUw[i溠MBT8fMY>Xo-1icGyqX[a}{.QZcXL;mCS@G}xC&憌{XKLl/4}tvyDO[M]1˵O 6G$,YlҊk.yc6}:KިJk[24aRCk,qqϫZ}*:_M<{]mjsl{VH1a}v:'ǟ1CIJϯ+;/=lrj*g2纭ƶvvy.ay4}1KWJz+H`Dg#5V$ےCA8AH`J&8"X3Opp>]#}@}ٟ<X:={=S=H`t=kUȑ {%Vq$@X!m?_5$}{?s^ OW| 8 8 8 8 8 8 8 t{[5Fzާk u{/AX{n-|ݧ=-+ϾXy$VVMNx$3 #wL` E_kt{=rI'KHXb&yM?dnKrc1M>L6 ?tlRH'KeP,[*l3.HJɰ$q6nG9qZvq߽1ԗ:,֔?H`ixXR$ O;2*Qb>I]G7INi#[7>4R s8!Ur[X ֲi:L{1 &X_H`2}^S(3x>H`=D_vFDҏsK O|2>5y~ }MK*nՋ{kiMj4in2ns>G)tv|<^3FFow'h+dUS=A5Cm jI: 3\ϨZ .]yZ(j#pmHYhۛ0&yei4R}3-vČ1Ni^ 4ww[ Ԕ6Izٕ3T,=%m3թ7h=ú蝯6^\\z=׳kĎM`e-Id\¶tkyr)6m` XG0nٰ7KG,KX?-JYL6t' MIVuUѦo`7kw='nΕ+!)G.Upllۼ> )Džq5y28oKS_A$˵zUGVxs]D\ig{1$6횡iZ-49V}}gı9;e˦ZF|},ɉf׆{*._qhלs(3Ǯme-C2[<_덍s EFja3[ҟtɲV6KBm%ؐvS6 7[Jq\ŏm̓9uH6(4OJj䮝F{-mQV2-RO'Lo 뇛vzh 6ĉ{iBaSs)f[n6I\p+3[e?VnVoZz涽$J77%8h$++wN]ٺ$,yJZm[ $MR6#MlWlG [vż$$JZQ5edחufk;od-g%F:*uƎd86#u`3ľffC?l\&76lC4j39}Vݛ~C+9C! Fݿy/闏Ź~[?VW2uլ{IJO5CZm[ Kˍ6)qJ^ֵ.6cԇ+2ԓH`uǦے̿:hjX ̓ewhGZQz$ K4j}ϑ\yf Dbny Gm5`C+9CM%nS|@ַXe\uu5:A[޳AVIjtr]M4uJ\YȖ]1/5%)VbC0J}8zKYm#VĂ$QBH.f\֨mзUwҀ2?{>n{6zyVMZ\e[oL Rkg?e(molU@ٲ楂>F|ߙۅr' NzikvϱsF-Y.iIdV`yFSz[w[o/J Rgյ_% )b㜸%Y{\F,x[nZibH!F.no^0c;WdpkLy-k%9W@4W2O:#c~#ui@Ѧyt<+-ue^>n`WTFa^״<)-lJH`z Ǐo^u#|-Y~ɍxCv( )J?T+'~荫ܵ,sƟ2!I75ߦ̣Mc!XN?HǍj=:ams;>hzqq]m+VsɹмkY'ٺtOx܇X/Є`#-I7{ae3f Cy!٨kR]/M8yGꯐY飶 +gnIڬןpŁC9&/{O8;̷YO\gHϟyyײs~1~)A?nH`$\H*y#xϯm˓^z<??hxVlIVǃH`-Hnᱝ\8=5͹!)ݛbz+|A?f~uM[ڥ k-Oe6S ໅t/H`$ĝSRvp"p.AϐՑsk0!rc/%6uz+|/L`AW 7~ײ14}>XgYO@ sݬ^{fObm6fzl^{==֧Ѭ.sDAycM39(i3z(sy8N$O׌۔{mWDl=2}Wֱ!n";Ϙ}43O|4Q|%K̥=caKW.]o T"-z$K 9 &'Ɔh} i=9_sPX^SGnɝZYЬ2mclvzw?ߏwqVKݼ?O\c[UڸDm1ټqݦxH;E+cZfǔŮ1Wb91>4rqj#uIv,=Len j6f-XfcgvD!P(s>  6SrpJ{ʒė4&AQf?˒I_=Gs̛Dd\W#X–86uV~8ev@؎ 16dI?3yy΀2s{m}q,W߅s+–86^BWD - tbl,H˽h>\Kn;:ߺ}NX_iBD}󕬎sdfcCPOY\A\bF>G#B[,$z꣑,>śo|k).Wg7Yga JΊ1[ Rޛ Ʉ}![ϟ^Q;yծAƳ?_לo;ox?עA|#M`/996cv3uK('|Vґ-0MU:a} 2W:f)S7qlHbCeqWшМlk[qbl,%:(G#Y|.Ats=Ĉ5eW&!V)o e|_J&k I%"|yWytf$IֱqGVM;Y\([W<  j~l=Oo7L!\7Kncfe74&tl<coįM~cشU%rUohkw4u<|v a} W:fίTG׹*hXhOtJ${l9N\Ϣ(>s ڨx ;c|  9%J[_Խ^rDuq\yCG8 ˢqc uuaK;Zfݖ}7sMls4-h{O!U+Hm#sA}қ 6eU?iìcsrgA{G!պ˾a݌loȍV}GSc[T!cPXvٵrR|v,lYPoBel =N1QFN:+%W@Wp.۾ɣ''v ?W19fJvdz0l~,TB_NGkں^_WGǕfX|\oedq}k {uv\dc hGGl?d%DfMq5XZ{M\m4F}_&4m5uug甭^jaxuM`5FX} XY`M1/$U`XpAg=fyNwy Fw;O3OI'0cn[UKٶݓ q.W΅Gw6\?33 lok{ֱou#TyrOvc:_Uߢ~ذ7|ڱwq֧Ekl1Yߍh֟2:'FIx[##ymZmlO5#YS̼~_ⲚvCs[['Lv!?';dC|O=:ᒜ QKK,d$ycώ_k$6'(V<;D+FHI"X y|6޵` XHO'{K\lO %V\ҞOR1?]?NA]FJ$_s! k_=;:V<;~t=% z1M2H{>n<}PABOEe?-Ǎe$񳢤; ) 횱1K]R|':=i z(n&֞NJ~t-e'+VVVVVVVVnqK|=S59$߿z?h0 t{=דXC/vuy@ɷWݭ$p,X|o=ټyf_ Gr9G<0Os+D}7;@ɫ֙y-/֫D{_SanD*^kzݟd1&~Ja3O_3~_Oxmܵ7;,smL~[}0_sN/XɟȞڍoS='+%>~ޜzWRZ}>-.?~iǯQ^~ 6J 6ru~_09B66yAUfWӍ9G;{V?7]|KL"+]{WJW7Em*~=ҸX!'s ?G.!"a43yyYk_d'>n+yl0(0476LF9㚭`狵3Px!da, uF)*|%^Czo~;xn&?Xw0_ƜÜH`MC+?!пMm<~{?K+7&O>Q~u#Κ{y*~O'n3o>lOdnXf7xF4?K+lAyUOn1i%nSڮ>~dΡֱEdE6>MsM}ZAVɜ3+sB6ef /9G5M a'J b9v.ժ~z24jKobXٟ-c\tS^SпnNCgJs̍|朅w)$ ٌn oL?_[Pfck6w2D=gsxk\,,Mԧ3rq(49#AS1u=}*W;F)s5S(3sNskniyɞ$yc!P.+sຊ2櫙&6B;;7/;{iُC7FGgx+߿ұ$y.1||۹7uԜ'[0 # u^f(D)m|> 9Ul, ?<ƕeav6+͆d ib+x-ڜKk/<9{I-<`,8--U~C}6 v<~{0_U1x9_sب'_Mk±M ')2_ɯ96 \hC>~g~73o~A2~[h@;7co֣+zm=If1AeW7zhG$s]xjFyOoojfw|;7ݿ΀29Ĥnmn㷓Ɗj+.xO3#Ə##yʸ6%ڪ.}5o+u^Vem4S78,Ygwz}{΂s$u^4L{S[|]jS>ݸIoC;%|feʶE\c+F@3X 8usmH6t>$wuV;'~N4|zOIn~s&ߟdvfg̢;l U|_nC{|%œƜ*a}4]%NVqۧ1_鮫-}2_P_usC7M1o]ǦW;\|$ڪg+E;sq ì?u !F%ձ J$nYCW7]{lk>n,8:ߺy/tC? U379Ωו_SVٵL=]}{iwK{݆j>}`g%v%:@zt͞_ոh/폞]F XGpO(l I(ES 1x&tl({fC0  7r\ƂC ]e +MIi|ÜWyܸ$ڪ||a];sϓkzK%i7U-K󕶏6Z9+i\wH;J`u*|d$ԚS+E;AK\vAh1OS$s]xZrݰ.M؄ Sڹ Ќ6e#73M:m }a} i9cԡض>S!q%yܸʯm~xb/f̤'8.O[(=1#->F)O!zJz!um(W/\dzt-' 9a{(\s>kRȸt(hFVThl|9oL7fMƒnIѱQuMKO'=נhsl1W²ˮoasN=ǶÜІWO`յU?u]}%AڏJWc[?@5YQzA<:1~!ozt-˶y#9gIm׵{O쮻=9;$j6nĔ6x1⯷ _o,6rcumwn?͆x55UU SP2 $X3-F."`A-~9{uT((mۂ7<0kMt_患Cm5FWrQlʎ/5GՇm9׎5g$_U _TTX1۵L𳖺!?q+ft_V:F\:c|uA.q Z6ؾi95C0 KT?j6<'xPc<7Qj.2msQ7F>A2!W1R۟<{] .{lk9hnUss8hN7E-֘7Ә? F4gW?> ; Œ8WY^cx<16Mo.<cN8nǹm.h{ֶsa~])ێ߈pQ>j5ǐAqMxp;qCm_ZbV.RFSݘr^E.זK^jƸvыM|4:y|[ SܾMd6qd;^ͦsXuף愿'@4,pPPT`s `n/V,`w,`]{]Hx:k Z&߲u1}0u oM4-{=3<-׃)׃4|M *S?CaoZu{W`ކUV8 Xp(P,`X Cb+z$kx!35<^Kx=R j2 &ЊzʍiAb{=?r7$~~tX V|ٛ<ρqvcrp}5Ap7rȍ}mG-9yV^55G&}|c9Yi{=׫WA_zKZcomx |U}>snvICOZSIbuڹuqo7Ws7VM .3C<<|j8w|c67[zUԜf{ X}mn|KBVxQ3sY ]5Jǝa9(sם8F?}0'97]Lo ~yo7tn=q "v$.7怜3l0{k_^8)|unE ][`r6[G}fpY?}0'=7%o p; { X/?v>P84_?x+Qߨ9:Ԝִ|l+2>m|Q~`NnnsOqo$s2) ߖ8[-s!'G 6Ko7GNjh~~+z)5K3% 6Ss9.sϦRkނc\s_D(zeWfU5Q'e7FskK+kњX4Nv ZStl6VU$sbZcdq2?+Vl[ =iԅ".vh)W0VR<ǝ2F~.`[cXڃ~=!q*ݤr77zIH,݄ZM{f K8/nLهb ؼMn?[HM a)Ĺ\pjlmU~E˼ƟyjOۂzQs?~渹6v|m\S7 7 E76 WOucĹho>} A1Ǭͫ<'߇f2b!=y<Yw-&_FGFj4DPק1Z*Ets?9o:)c۔oi_8gf,`=}MNFf&@j8o\zyCqv7T=\l2?۵u!9{ӡ=rE.9)&kAcF-ٞ9cH8^;nCJUI>߽F^ۡmUQ4?\-e^$ǸWql!Ps^.6ZGg=bӒ6>O*vSpq4Rխ>o^%۳p1eN2F۪Msmnf-/1mQ#AR΅~ @rYo;[Yq6oHI  nLJ}=V7]l)~}nL'h,澰Xy̍JAi&aTs~W~LmI/ںJWj,vf>*7`|I%]۝bOXTGcQ]MctJ}\mc'ɝF.̾j&r~W9>c{gm|9v3)|-p3&~mng d77 ވW( 5烚j?0x\1j'.2xϼG&yz_?Rc\2A}}f&L ]>]MOG.iXu!ρ1Rէx_+S&1\_%dm}Usٹ1R_ET9XC"ō½}nop87L{Whм GCWJzy6^iPs9Zsmy\1j'ݟk_g\GԜ֍qv+aTs~W~Lm!Ƚ9b6i>$C{ܞU'8E4}hܶ} 33iEE E:;^8wN]>~/V{gjƨgoq_>L WKMӇmj8۟9mSvH1q.'bV*wSύޖ7pXM@ח> Ĕa{{9zp\p4}hٶv+}ae [iвm6Ԝ^}.VDu\7J|_ŏzC˶FOeFK%5P&8ztZ9oc {Kb\Mcm1tׄ6O_?οuop}C˶hhX>Kr3.51ڞs!NqX܌Kޠ/M썳o?[)fLvڛ#u46onq}ooh,:GӇmm+nP_i#+E[9Wm6eǗCkǚ3?0wܪXE*jˇ\Θ}Z&YKؐyI_W;F~. Us9N>۴܌K qvXO4Tqm}vGU.4R\\θ*z[sfZ5*3>6F~bUs87[?e6<{3.cK?dk=@J 2΋ҍGc8ϸm|v-\4}ڶF~E}{Wo<^5{4}ږYkڱrZy̏X-X7㜉kئԃiMkg1NzCն}vˌo McEza~q}or@y#r|qNK4T9b?z-e ctJ}7ܾ>5cN2|~sf16X H~K1uRǪ^r.P`෰ō>ظ/8X oZ~K~,2ao*,ڽa87- R8f+]渺6!ԵKu9 s~?n]ϣԫh[jNn#*u 6LRkknLmuCv|.S:_Ml_?F024ȍrckFs^9A2R^6hN1?bX-v2`qcͼ¼ia&LDx&!o7N?09 >ϿkM|1v[1+>Gas@6[qn 㞵s\߾g)f67"GԫzE1$sPsܳly'~0<.N{PۃʖXE*U+jT7>noaWl뵌2sq7ƔyX[X}bgO+Թt{jqݳv=U5FnY-ׄSܾMclC'76ukv{#wUč1ǝ~V^jt9 [;s uen/ ~;4VႲ.TΎ١qEf".XvbE*5 NG,hp_kL {X p팻.|4ؾMgvmc5=ū,0uʍϤq{q[9s, ["],)4<?ֱvXzJ{mz@@iZg ޟqU dub{@q9ސk~=|+eȱb+V8 Xp(P,`X {ɟsH wc+kx{>dMz$~r7$~~t,b~ XqSed?ƹۃ_ 1FrԜ#k IިW x8|te޲n˹-,`27w{c Ϸs'nʋpX~=Å.ܱ+ڜ[PZsӀ#s>^E{)1n~ Ϝ~ԫ^_\ H] '}?5k3up>:Mj$8wuM:F'צh/>Xz!xX{Po\pƎC<JHM[?{ct^֋8TOso;ddpWQst9_i-#nZtG#\ Xsӝ{s7td1-X{>_|{za7mݍl@݀.R7ٳ7v^m|\nqDޥ3W[Qz c$b%ΡڹͣE݃ |?ckh4~Urj}^I9! 6SscԷ;Kj'ZP1/k놕Ԍ8z5V] Unk=桿^(΅s1ّnhbUCu^Xi*{ώu}ΡFureUqm>|vst}s!aw^9sHC_=H07{!8g6sX{hwۺo}ގ!| уn馫y- Kx馲榶z#̛V\[$7⽣xbng&c6l` +/܇{!Ss9nLm_W -jժ=o &jGY՚g[[ZS{I-sM(l0|ʘ{J~ܘfۀ^>UL>o,6 ;CPRsC4uXp9h^h溷ӝ}Dk[Z8ݨW?_9nLm`k㸭0^&7/%榛y̕qO#ߦ~K9u{`$Ju>(2G47RWA|#;>x?&{@xbyخ q{|m+}tIio\ :F3UlԜGB5GqbNU7j Jumnr&}Cbu{ɵ=oXTWcfIn#G#]j՞͚2'OmmwK;f5>c$Uv_ʹQOHnzc6y}3y51j>;;+m3?fIo!ꡇM~<✳σmEv9?Oy^Ps>9m$j|[ʏU;i>s\[7zz] Jw\m%׎25з;> F?]bS{֏J,4F:9o;I4reL0>XrV}H1p,`frFrJrC.MjI;U7U&4>/γd"o2,TK7MT}r/hsoU5j5՚#^cjcNsa]dRty=L-q+fS~^ihҰ%nHGP7r+oƪ YiTs="ޗ`|ԇ {-磄?Ig\^E?#UĹH#=o(Rދ;(1T 7ϊy>}u  r4t/tGMo55GږǕSv}vqskxZХ=nEl/+MX:J=PgJ`ڸ6 4Qr|%¾\?7߭ž"?~>̻ϸy+82Fsj&)Jˍ=7ŧ} W3gR[ 7ǚ$*i۳}Xc\3E$wI[3陏 =rٚƨgoq_>L>q?s ۦ6gb*\ROV`QU&o߽-o1"ڮ/׊) 7/wq=/Z+/F8im>,>r!6Y}u xWP%1:iΡ.:3G>Tok}!UR\?:Yico*VΊ8g VF;|+ggo.7Atu׉ZLUܯq>AvGԫ}ܠURs>?ڽc1\;6P6}3q۔ZhsZl1ةS}ڶ^) Uvay{~ dbp~|,R+ yឱZgTR8k3ن1: jFn_A8XlGF|9*\@[=F>Vߝs!Մ,nԮ^AxƴHx^ևʸχ6xhܴ(dKCܬtqn \̇P.v.$ECvwI>¾RVm91jNmj8Ϋ|7ڐ3IZº1-BHoo ٱLJ<5}9A3R?g.O38>V:űފch1!8~RPan$iq> q>ZgFk2;ZqK58g=eoN7s,n7?6 o4_gzDxszk/3mczkP3{c7Em9#~d=oh dE綹9Y~?{̅mB~roZYoc[?#yDWC25=kjN7wc =xoUZ%@fMucsz̶^[nx}8Q zyX) {jqlwfVsd۶C}oB[|˿l"nǏ,=V˹,X8rp?,`\[h@+(s{_0 7馱 U/pFwxduv,¥6? no/`koyt΂vG θG߄g6V#XBkp SܘLza_\,|ś?X -l.yWsZzXc;,^dn_ 6A x=X.oxk5[,{U-wUp 2o;xC5{  &P,`X Cb+V8 XdxޯGgsH _<hPspax7Vԫvuy%wWӝY Xa؛90vZn01\\üm_!woԫv X݋W ֑ym/8 XbxCoH>D*k{%;I`Ld޾f.߾6.8]6[z՚Ԝm,OdvspcH|d|\^j\jW_wI8{sዜmy"܃#r .Zߚsh'W.vWQ*sӌ#t^aM׍ocY5Uc(*_oGW _|n^Žăa63E ~!Ce!{{ދ8͟p-ڻTxvfbr+ӔW!V{lןD_9T;ryh{8!g}ݯ1R_ԫY19b>'ds!AfjN}q~ǭZU; yY[7̶flƹԫzehrcV5NDݘf|-s\tĩz)[iR1YRmʷ=СLܱøPx#hS\7F2 ^mUYUFꆝ/+kix=Ggj{+?ҹ$ ۿe)ǹukm=<DC҃$Nh, f{y+kK}Gy<0UQD>G㛩v>HousU|gnzct>?:ekySۯpq`e+6vͅXXzùxՌ>̓ÿUq? O %xd~k\Cs_C{d]rRŃݭׂ;ƌz[=5g1r:qP͑/Bwܪ/X}n1{ՍyCRC۪H\:e|}}voq,GҲϓ?^E7ߗO7oS>ʷ)V)G@5@ԇ#aF5gfԟ ޳Ƥ7s&? qag͢o;l U\vۊz%B}fW9p[Nv| 渶n<~[^Jw\m%׎Qf.3Q_qĹ] :}mN#X~&ORĹsqm,`fSo?^AKm(J<8t}Yųö}患郪7/0>OmBF8Zs :W~LmI}.쳋L*?3󑉻=nEl׏+E gfvn#4:}m㿙zwqm,`cCO% S}o@8z>lWhм GCWJy6^iPs9Zs fѝ.Vs 0'f1#M{܊T_W1̥sWmK;-`u67M[ؗ}f&-[옟Rqv.9-q Xxk\4n[7}%R͑/w\1j'ˇ jLyX۳}XQUޟ<ٺ!Lz.}hW/"ɦUǷ/H8Ԅx^챃Zꮩs>^)3/M9 U+XT{"yqÑ僩Q!%ח$ÿHÃ= xpm<=Ii.8>l[͕澰ci[zխ^Qs4}hٶvjZE Uvv%AGem:W,` r`s{aDߦUǷ/_Vo(_xVsͱv`Z[k~Sz}g>K9m}=[L`<Gׇa[𦞖f ɒ\p4}6v-WpcqV#|MP-5qڱPj*V!3f_s֟ ~R76H%>n8{5ݗc[kۗ|>^8|޷|tVa;|gPgAtuGMac'MUܯq>AvGԫ}ܠURs>?ڽc1\;6P6}3q۔Z줩sZl1ةS}ڶ^)(R5N Nfx8WL?_>ꡊ>tsp^Ss?p>:{|k Aߦ1ηS3+ϵBȍ]}Ђ,^xᐈU|>P\= j|mKvo1MB>J=k~s\Wb>w.'saۛq|}^DRsbԜp/qW;nȵ!5gZc=_cucZhcszyjg1TͥSWmz.9hC!5*XjwkwbeOm-T>^jQXf!z?3è҂#!Ds]{A?k 5&>Exi#xC[ -8qc.o3{z{#GM99Y~Ps/cn=nmKK"*EJ5hS_S}^n7ԫerc X.z8 zÒF'oya۷z,;,v׫tnzԜ$谀&7 ʢ[ZXjlΟ!W,­Њ4tp `_3y[~@+[7޾/N~a?\>1?⍹]&_u4E|gu{^z3cz#&ߵiAeg5=Loq " Exqx?[wp8Uɭ(NS^=|[]~eP\QFl1c4vH9>SfqnǤ挊ͅE91[s~W~̥X-" rulkjf[KmoWF\6ho|]7ϴpBUZښ۲SK8΃XP]XQ=Eώω)[iZRQ2yUkช6r}Jm;xڹu;||}Q/MC8 !q|m>ۚ+zn bv.V?ge.d(AfÃMIϒyP"ܢxcds!AfjN5}snٴu]jU;[|LRk#vQ6*ڬW1 ĹhoPc͵uiEx-ZɎ">b[q΃ qƪ$BqnRZv ;Ng]يm5'Uqm>j*^>sUS}v ~ X{07ޯ7D7^Tf]/p~[ioL"y "qōiss3P,!ɭgXx>s7ŝ8w NqcmvܯobW V<[P6QsE}Dk[Z8ݨW\_-Rsܘfۀ>FZeܰHn'm0WR=e|-KߌܠoIxc(L\>Hm_K8zܔ j⡇Man69gu:GH%']܄ߚq-<c̨We?Ss#C{>zG ~ǭzHU;i_Wݨ7+q;y1X˾#7̋*"6 >j+FbGtZrWcfIn.F*Aիd{N7/Sh[UiۡmՌ%;>c$Uv_ʹQOHnRz#+ٸ}m盀57}k>;;+?)cIo&M~<@✳ύmEv9?Oy^Ps>9m$j|OʏU;i>s\[7zzCX Jw\m%׎ьsW@o33ivKԜW|\S]+bh4siNϚkBmz$7W\_S*g}gw/n?on5ԓSuPmBͿ<,}𑸁&BtsAJ?y6^U|Ps_9+?6V>A&O"o6UGvb>~\&Ϣ̤uIaKB9"(%V:m9.94FK0}sׄ=Ɩ뫄̻ϸ~.;7=Fs*G X{pPQwQx#1ӴMmn5s6qi50Mh*s__Ct:+ j5Wk-=+?6Vs 0'f#F{܊T_W1\v0+9f}N&ݶ3}1-23]b|XQMcF} Ʒ/iMwkW̻ϸy+82FsjJՠˍ=7}Plp87{76{\p4}hܶ.?.4>NEJ~爚qۺ1.y%j|OʏU;Y>W3gR[ܦ73ǚ$vh۳}Xז粈VO_A}}f&ohWA9 ^SgK.ҩjLx_-T6;sIiиQg3>ݜmns)"%UA,` UnQ&y.K>۾ ٧pSr7 x/^o|#G}u -ns/lXyyV^uWԜ\y9A|Zvoi4-&ޗykg-4}hٶvm{)V<4幠;F7ޗv.d) Xq% qͼg>757̟)ۮ{R{ws0-m-77b%WhPw +^cd}ű8+JͦRsT}ޖ}XsF[RHEu]?kS"o6Ikjrv}:lj'{q})a;ή􉕆*ηո/ێ(4ܼׅ1Զx_kBKW>Tok]qՌQ1VCPFX~uЇTqV;|ggo7Atu}CLU<HAAvGԫ}ܠURs>?ڽc1\;6BP6}3q۔z0sZl1ةS}ڶ^َs񭹡opLH/3/?6UWWVpM.=|qY<Ω~t:瞱ZgT[q4aNbWǷc, WFՌ?Fpo)V>NJ?X R΅Wj,v{7 y"MKoɯ7 W}>M@E7E![ zeu}xs\Wb>w.'s!"bn¯ǭKyzmK͉QsmCPsq^!׆ԜIjR|֍mz{nȎeUBWHFu[]nth+'hC[+3M?)VEGG}췭&Fbah c94ʌSM"w ;ZqK58g{A=eoN7,nS7-?4 od\1d-fg^f49x;g|5nz+a0sGmsAsܳ8~ WL9L~FzQS9dj{ֶԜo"؅ij{PHŵJrE0Tۍ-/*rm1\f|wnw4ƳTݘr#s^>/k{ k0ԿRc:N6X-{6ݮG}͝#߶p۷z-vSƦzucnqod.6?F X.`p˹W`gn3~/}*\PV]j1;8N PVZRh5VſFIks훉~ XqׅO7 .`mGxN138n/?nXz71'~dp [%{^0:VW#[i׃qMP^H@5-^Kb8j.`[c_OH]y;8rޯc`܀oe޲U9P,`X Cb+V8 Xt5<^#3|CgwṼ{?"ɯs|<濿#-큻p"w>|#⦆>0 X{90=D/b vG]7Yr>>YXڗym/ Xbx=^a]X-IaxLC~=Cۛtu5zpǮ|~f[h +ڇּrn8vur:\IUnΔYupunyWI] =^_H1:v|^ġ َoRNth'%m1.~ZmyEC@ﯬ~8f3ƨ,deAurw:kX~kj^f8zǸY^WUFrnor5RP3Z p^p 63n^kx~Jk_8~74舅cE?@\3x.84;/.|}CBSr`>Lc p_gOEih4~UQ{-ҖU8cum$#;e5}\sдꤡɍXիZLkfyN9t.SBFhE8/kP>m^-}Oq}}mՓHp&ٗ&!I n=Hz,=@< /V)bCG8/*5 F]8D_ UEH f.?[;cnH8. lի-s^Z[9bW| _!i իBqnZUMC۪#˶UQ'|_ U紫:e.,S/[mFԫm޷^mo[<_bl1%gm1*/\Ȩ'űL> n?8^ۚΊyVOroZp}ˏG/m9qu9XKߏmAċy**4նYmvc?27?bڹ熠^i IЏe6m&֙r8j[UMWfIcdٶ* X}*fTu\\o~7^-Pf)wʾ3Fhf)iM$T=Sm8?i|JYYp,Bc)aBtsAڇuJ?^d}S&6Kfq\ضcr~{>c)k#uR;F~uR/sC5C霢ʅx_pxv@Jz%w[qy\V#UĹH#)/x| Ίy>t]A`8-<(/Wꇻ=w4}hV0'CWuJp^d}SfsĹ!Ʌ,nc?< uaOj>aTRkKuR;F~uRZ|[l\3)<%ȣ¾\?_Hn{^Q"?^$n3a j)c8p},`UWD]!|87KafۄwĹg>griXU?W>sq۪uo13.J^ٿ&Rw6@-rw{['7ǚT}8d( X%} Uc'C/A Wl&`ۦ6gb*\ROcV4@Cޖ݃pQkr<חՃ:ÿ{ĻnAg0~wUru4MZݦSAaeեz:v.,毐h\:$|8KGS7MZݦWn* X{/!ȟ\)<~N1l|O_?οuoԫgMZF3F^g\ CK;2v'aV -p}xv⏷~lݧd⁙vu_tWjԎq,|0!zY̫D^~.~-Q !4Mx~Zk 8*=b+BLu'EoE#/ۧg:Q$("q6:+7l[%1/n5![?]j{̍Y~ ɣx_k`7:ƶU\~v pU"Yzp#,`U J7 blyAZ@nDZ)xHx {n[ꇻ#edG&N[ q` ڲh ?XGoK.i[>TmB>z|ڽʫz BL=fg8.x/ߦԢ+zik4Fn?4ӿϵrXc8O:#˶U 7$u"@5ϛ8ig)̅sJǷ91zePc9J=17 ?X~U΅Wj,\ X;Xw ]]RVf*ߥ\J)1-` c.hh}՝SFm9Ezwba*DZP|O ՜sh>/ZXC1f)xz?3C vqs]{B[ S 5&>V[ 8߽Wnrqq.|8a<洏pY\A3͛-j㞵ܟg)6jsM_? ;ϧ;#*VM9vsңNF.זlL_:r9&| kkK~Nv9sܾMֹeC@^ո]7ֆ썢Ǐ,=VCu^ pq,`[`g҅_5f[8{jۿL/8,?Co,ma+?exl `Ϳ=V~ X˸QPꉞ[:s3gaB71'~pc,`籀`/^exl[,5>_Q j5>,`籀/Xj ״23&oUg2oYf*V,`X Cb+V8 Xp(S H j? X2߿^翜11?"7b\_}8^ r {5@72yH+Aa sw_o|X!GW;0M~'@;^{ߔ{Íⱆ[DlĿvX?/ƥcZ\a)|znχÔFRW;/hs##퍦K?h<{myuεZ~^Wց.qh X}Udqs_{R}&7}(?z _5ֹ<"7{p|'h֋8tKp/w_l0thGo4 b[r֪Jnw=WύlƪV+r5tuѽK<:ܘY_Fo<3Ӷ.kn2]97=o+oG\\C .kA '\p8HX}5_:R⍯Fnf2;#rLj,`~ E.=.vo.]I^sAR0ܰs!Q%H]Mݘ1>#ٷ_/\hsok'=cܿm[:F~:77 E$V3uh޸}>G#ܒ9G98;:7#rr>cjpm21|woLaupuDZɅ}|1 p9^L?6e`47B/J> Tyr7+g]Ř7Ju|sq7(n@x3)WMnZUN857/Wxrsc6,7:6o__e5ohq5%FsAV7 !7ƭ|v5Uj8VGme._57>9=Nq}QY,H86fe0q'm=&|yɆƶ2>Ǩ,WmwVQ+"hUq}9fۼ\@f6ec|;W|sܝ4V̅HA~=עI{mH%_9gۖپnv᜶]mn,Vuū[y"ʍD{߶]~29w -<"Us8fQSzo˩Xr,~kskM7zF$ KqUk{}q\\ضrJqQ9͒kHɹpx~nkMmO >V2vwɍ8Kc`e{!s!1RдO6n{3~s[s#ݗtφǰm o8F⸺1RyǭiDI`6y BZ/3sYF-s3q9?۞2W3vV…{nvn|i4| 8:K[ByYqVl]f%Z|ɪCϘ<;=摮^911iXIUa9W p}IE\j{iL^>2,Lu+=*mmNZ>cΉm~c>MQSN^)‡21> פ89/6)ƹ1du#3]r# $/vjscH-E6#w,Cӕ%$sAx^Զ-^1FvlܿwEC)s"w4_mɒ9.$G<37hȻent&Asq;iߝq3q:pWPpӉ;(R禉%8/M͊al˗l;Ίb[2gtwGÃ>,!``kݨCr)ސ~Jrc)G2i[|drcQ?xs':7 v| wڮI9W 1uMYuN^)5UsL;FIE;Z3ߧ gkOnT87悬ndơKn}Nmnswv0dx[mgG_vHM}_^bk`gh&>ұ֌oh1VQ5·`[A7N]iGh+㘅s"~Jr=b%) >FCq&7 XE/h_܅{5{Ƈ_i4|8:aS?+Ίm]|AeQʍ՜qHՇ.3㟙͔cde̍ξ+oRfN{]{Y=u,U+M.171͵…>苹? Auo'l4Ap3C`ȍNe?߽bc3V[cdb5i 3 iGmnMnv}ǡ~)ǷW8GsQoPc+jIDATe[b.1͝ܜH}欜H 龮t}UwM]-5G4S4Wnۆl{\ج8 G܇p5gsܝ̅gDvϿɯ'vI; |h͍y=Zng_m5cd:۵a1/n,~V? >ǝױ2GfcmGEs%yO64茹mOzY9y8OṀ YA͑?jo;WA;7cͶ3Bn,ǡKnX>iFLѨhs͢ Qs=V糮EkUXlmjqc?y]ij{7 C1]6Ew8bQ~^*֣yg\V*0 ʍEGW=wkroض=s{ow3gr冋A)ckB>0I\Xm tEcua4|m ]NE ;9޶oy708o> JccRcV1cknhU{E}56Q?cp M7_lv㯶[c~EZn.xܨ5Qn΍dQޯIkQ\rshuN|؞ r8{Im׹1rg&sj[d|'t8z.\.WY:ƹP M BnT#j8u-ev] ȍuעFٶ%:FF?_,9N{=jSesCXRmyMRY2Z[-UrCmȍ>FW͍$۹xFnw5:5FmPɶBUs8}rvck'oq-./,BLDx!_zc]ns`Ӟqn:_cm=[f)7>ꕮSN07yPR=Zm;Ƃbe(7,\liڹW61vqr4 ~V=FQۍ~9:/js!{IŹ<6sw̶^[nxǤ΍մU^{Vm> n=\-o^fYjjNύjLjܸgn,Ωv_ɱgc9Ylz-q&7ny@v!\b=->:}H6=ʜ͢3~hE\XfA 8 n ~ѐzЄ 7 ]!tmsmQk#0+"p9כs, X py,|HW;ǹuS?]~fa5ۢHG0/Xbss7-Da+8ixQ[ޯf[T?9|n9,8w8X]( X.6<_e4z=ܹY-dF:ίͅ ޯ'8gWX Cb+V8 Xp(P,`{ɟ~|CgM]:^/3<ɿ#4=ߟ4](fٯG؅П~ G(ݸݜSj܋oֆz _9G G8L~k߻b륌 \@,``7`66uTq <pM7}g;su= q5q9)w}u,]8)ڿ`.{'C0Nm5~Ϯc7]1{AϿG/{bM{b?닓 5ō{\ ]Rs{\Cwˢz{|mGghwv~+΅N=1'[kk?u/;+s--~vk7:=^xѹ iwSGg YFpHpkx| \gc̊pjB]uj9{kPs*pZ8'T׫NW7u0 ;E>Am3,Kmgh6yE~onnPvqet&V=lN̅},sou]ug9~{YuzNsT~p &|q'ĹjWQCspͿj59o\|Z#Y` k7^zP#Y\79ub;~s'&_hk6[=R&6E7OGMTq.3hc%~Zc761癧Wvs>=6'}_S)g1pN<1J|.;,̹sгj\#ѝ™Zt;!u4~[Q쟓c)xԜ;knڏg-\^zPk.3D%w{yѽe|4a6-.ڂo"]'#~72>{bݱ A4ۮqe>[ -mQYRs|MKԂ(ƶ'd/w͉٩k͡=q} j2.5 WEJts'X9{G997Zڼ;7\L{`B˜' N1Vlgߖs{_}؊M)V8nhA {q.vΥk9_⬜gR1G_?[#;[wX*H92n >k~mLT/ώv#K39yV5 Γrq֞΁F\p| $(?w-sGt3(+;+q;hwGg82Ϊsm5l.zu,c[ǝkgȍr?;T׫\&=>I?5 X 7Ih1&;Jf3/-xd6'w;73ls쏴yS?=+jڜ8v'RC}Ī [7:Aߪح=۹aJe]aL̅W V8 22i[=kkR&s`ͅNzXg6f|oy:bkU1rlǺ9nG+'qls͜m&EUs0&Ci_&g\?7ϣ|f7-YoM>g7~^mNSϚu a;QD>d/3F[NU"R?o@X?~%alۖ΃A{r1i >^\Xq""RM>sBXu#o6΃q;ښ3j>k1/܇;q>6t-~2u3Sf4F.R_?ø}Qέ/[: %uQx܅2iRJD7D7ÀX7?q~ڤ6eܟns?-~m$tmv9\\/FJ_2",l&Vۺy=5scOӏкvLv󂸁FskM q%rqAuASA'ן*|V#LO&]X0=ZٱY_7J}'~պUf|&Ͷ2 :6<7~.nӾïԸʱjs[I{g6>X'/J͋YsoTi;4d|/SFDپE򷻊mKS1bU9͒pܚρ6+u(5V\($龔$h"'v.-?ק98VS}*bJ9FgՍv&.@lhr,?> dgK*ߤmvmjG9J_߯Q:[/ʩL-Y||֎oUt>sj;d1Y;FnֹPطn('8<V{u%It[KmWЎlr*^Υ7s`q{?'R"G*΃z5i=ngzw6Ս8^CQY1+;\=k}׍E]cƩkhzY39|$Wg˗z%w.``Y%IiM'f}}9e c>^IƯ9/|mu6Wuhx>H/am,4m,}m ^}qvBۯN4̡0nx-\&836eT綈nvr|s|$ϸk\F;ΪރkV@[ƭs84-|֎`+=$lhὅ{8,{u.H%ԭNrbܣZ4C\.ֺqh毪WI}֝sa?zūVU3g:՗ _u9)N(P$MJC"ۜ8IfG7xr)q*Fm5~)^muis\$?]O mjb%6WJ7?"nc̛.|s_mј̍q|/qvؚK^rswym4%j<4}hVR f1zujsu>z׆Lχ}eBs0\,DwM^+hq9+CsRW6y>y=)3g MmAzyjmhjF9T!.ߦ3dTȒsԫJytV>k7} [lmS{>|nut8 >4n{X:,@uU*J|>jhGp3?vAN뗦[1/%}FMA+%U7j{$7]=)5m>nt} &^@nY5Ĺ<ݴtqNz̃b;3wV>kǷg~%oswNf^=r#z.>oB{:ZK(r[K-AgܿA+%Hσ㓵hǭrUY13?o\}Ţ9e>d}dVBj Y5>V(6EҤ4$±Y_wZw?/6~EV8jdX\B%OR[:PpqI7cui rยqsm֌N9EyI<+m4Cq. gW^fiJTsLemn8wms)mVr_k;CXWkw|r|gf8(G;Vq|s_m>$QXJUc嬺{ 7B|iq8ojulC_w\86XukGqkǷdUoh9/͎QhǨD8ZbdigYmtv64IQX~m?wlC9ts;ߧq6iTRіR<jSq(׭ 8_Zgo 5GmW)r!'Znm>~-xѐ>۶7Z}Y8sKo[Lߒ!xIRٙ/:&IK_IStIPml|_kG2H\%]oKm}n#Ò䏥p9eXq2ƕ|[|SB񸃯7FCm?k]6sP@/Lz[ݹ| WY)9WFK>(l~//X\sk=VyܾRuNJ1Fg ImTͅ5q\v8o+k{aq^)\_jsLf<ʝvGygõy|Q*U;+Rcr*(A>n>fcXjv {Amvqxl8 jNX5䃤vr8=ܣP-R@(ꕀUͅ5y;꺑OXeۚ98kr|[UJž|N|.\5;}IPo>U+c6{^?o z wCwZ$N<>R STtۯ.iZ!oQ..a4ٴ磹?K+ͶE̾6ϵgRus_ A-zhժL Jh[+Qcw9%Y9/\<5ּd۸s>ƺkü2q=Ic%Yq}qAs\H啪9I/Lj[AɸմYױ\լ|J\X flƾϮhʜ~m2>I˜x_>7+AL*t?e~]`=XUOCmG<6GMs!6u2h'(fܣ±=tiiעzwz׮\hzPv\g,F w\~}mA?㜚kQsu/Z]xA.Tn+. lFVK1lkisxũn.|ƪ)59ΉEPP/.S6H:圲زQMm'5&qϫ?ibW6Έ725ۼq-붂s6kjiJFt]羊t.ueN\mfir2Vr.Yt={_y4j>n5sXw^Pj1j]2Bn{am۹8+W7ʒ/}4+֍98n[߹qm]kՍ~a߫WF5Rk:WUX\p\ߍ9_0obw&q1ԍ~#}΃i.N8Fܣ{1US{NwWBu^v31ar7g쾳kSbimSUד)q.vN~p&0Kw^a%>r$MNxmmiU3~ 2ȼ%5|Hw[\*mNŋjuQ;n2⿖qb]]ٺȓuLrqsǺ6몉65'o٘\rKۼP z4)obVoS 搩xgϼ_0VMmsm6jiY9SCqjg㤹"q]ͣ)&>>[mjY99SiXolL 1}|TǤ9wcQU7ǝ4υ:MP26QA?'clp7~>ׄeuis7oy3R]2L|jֲ̊9s_}=K0>_w+@ ? gn \ 8}}_RCC]s̅ ܣ|$Դ=./X "}xu\ð[f zq>qu\= I7}uVa+85z?9a?o0V)gOE7#ڗ_QsBQ5Rຨ~x],^>wD`4< X (  XN5Ϸau~GAm.hqz\# z`+n~[z=>X 7'io4,كOcv ]p*\#53ov[jzʮ_8 Xp(P,`X Cb+{?|/>u,`3 5z$~`ixB6,7$~0~|s-r1}EMIba{3f\;7x[7ǟ97~A97aϿ,`{5^n)'j|Wc96'Y<59\ XZ,TA,_b21{ZmMŚ5v>kΥ~Pp "ijNKN>ٱF TIUA]}ֈ)/~oωm g7]7Çmgn&bn0\qyjUfܶTczPlo=q=x,1|<9=QWA;63n^L`cgGv՟Fj"N^I{˴$T́>f*7mPsjc΃uWE¨)͵[Q2oOG~bT"6g}c=/ĒͣpX7wxqn4M9T1s`8ngMqU=;俗}~# ~.y^ts֫(uRO5q}F :4)ΛskfʹU917fߠyVm%\[9 ✭1kʕ('WgQy/9ȷ׸`ylvoΩ("A㯍ข^o99ZQ^#8ٱ1+ԩ`lGMq%s0A` '>}`BMJj#XLتyn7s]UA)'iblg8gk>clsk锓]4ԺXqlL Y/6V馵Yꆯ&opuqc_+cqۭULrJ7Q#qJթ{̣\[ǩCs0_OIˍ|i!\Ui'r:MD?hū܌StNgǺ17}?o{?[۪Zq=Z2n2˶y7RWTC{Y8DŽqҟW:/|9&}ihkq%15=SjĪv[ 1M1l;v1=2}s:&m.}PŪOAV'o97'M(nKotKbvӼrkqJucZup7\u~$ity Xb8m-n8/7$V}>RYrなjN|on=B/g2 '*=7;[5`q墨asTJmK\{.[r?fr[2ky+h7c8 >0e}:ѩsK7F5uRC1E(X&V})~}lգwYomKcP+'A+]>TA]u!(>Kr<P qZxh0/KXښۿu}ՎMY}~gu8!VnqgTmw[x*,9e+PUs%ܾͅ;Mk(]Z ӛ>0CN1O֦ncЦDT9uw&'Z2Ϊ*Fim;6wisL>yu5.t 8s.ҎQkP`ONmusR7Ī~,u.9qҶq^9مXim3Xq7 RMܢ6o\QжQM\ʹY+ՍiqG=oxWˍM]Qw6Vhg_<U=摬V4mެ>=j^@sΫE?4b9?/lYqsT'{Eټ5y1FSB&c:w+<qn^!ccXmOZnk6ƔmN9مX_'篦^E*}fa_V&ٛFex,n燈Fu`5uy dz>6v7 $7csw(ݘ֌a@վm~ ƭ-?3j!!֢ruTqrsT̍|fNc~֎̫XUQ0^5]y!s̽9_m(Uyp>gco[as/Ev_6ڼ-_}y+ym#ߞ9sACˆԺ>c=.qn8;-qUĽ{Y-b^ڟ9Ns!&ޗbuRu-%n.@!fB 5]K UubKNPч.d՜@w.`76nbӳt3|X/Jž\o}ߊi \tRY[7Hx{MW\S"[]Z`8ke`J (զAmKc츓ݎS{Yy}.c_ 9['oy/;wU\hK- mtmx?zy ,UPmn9F#93K$uVsƴP2u#tcFgK7[ c#s-ea~ YԆi;62w!+{onmbVj{}ܘn# 5MI1Gm~,l{یWUi8VSNͱu9kǍ˦qACښaseM[ s砯U8څ!|38hݧXy-9/[I߲]o<yߒǹtf/׫y5vֹP[4n&f`%Z]qΚg5V=B\fQ,6W]4kjl듓rgJSquR>{Ԝ/u;^^L"Ow0M")`qK)Ԝpy'<П?u"d8P': `ք̡K4pun!T?Y~fQϙOC>uʨ Ͽ|#ԫY\CVkpqXsGme\^o" 5Qpy1N{- BEPF0bfsCjqYC503|1Q36lAޯ.Pc & z=j7jpǷN@uu,`X Cb+V8 Xp(6<^#36 ~{}g>O}z?7Pp$o#sPCnԫ()EPysNjű8/ X Ԥd'eO>\|(GGXC}.gڎF:\F\_Ws9?k`b8/: #9^{ѓexL7.o{ {Rxcd:b|3&ޏ .wI]W7>DNP/wub9VA?>b_yM{S3~>hw5{=׿\^u>H`^zC? up}u|- ԟv8/;*d+wUhsf+t8/T0ἰya_}z֋8>i7>ޗ _(HnۋuIF7y5)sr7L~q|Wuѱ9G/Tus>_2栬 _xM氠ogmFɹ}__5WqEy0zq.T_:Sn½(gZ} uv/괝9M{H:*SN6|mSBڜ}B/wV[j"NZ(oR/7<`e1'Ǝ߾7=m _>qH]!'[77O1o='oؽvcIw~cWD;>b} QÝ~+Սhɕ/9mW)7bdl s!YO^u̗y4jswύew޷jd_'Hm_7B}krX|?m w u<\^u>\u){qIw*%(e?v^#>xVsYf?x)VyImN>yAajbԕ۩߲,`~g=V_}\ h=78]`Sg;*scHlc9! f|m\cml{1Ǣk6ԕm62oy̥%ym{ۧرox/6aZ{Nm_xűkikn(+{̪9n>vv }ȫl1u{ksbA.gDp#cmA͉rCTc7:RLlD>SXczC>mu㩟5ׄrs[,qnX,hRi ;NG7 Dspe-R\]7s0P5׍g$7뿳{mQQu^}`usc>۬uX͞9霧ߖ4q>z=V<֟NFvwMLk>=mVN9 dlW=Gsuc^L4d,8>5lqEMܧn${]˾U9 ۉ*Qi |V)fgVۏm>6A^@}H^Kn.œ:gzgJۮlQߏҖH)T7sC{s,uy;vۈ/Ǩ|*h#ȃL혴Ժpǐyॿ(Ƿ24q>z,qϰNޫNZ.61Yڮ=o6Fyqwl*o\V]2Y幫|X$BQ~8'͹`5ssZ1kc z.9˿R/_08/DR s'S"}GoB$p|8/s<[hmFy+c|bkfo(LRёY|0I).M? Y-*w1i9,>{+?sm)QICSK'iI^ӫ.65ĞeVϓټ~hIldcקǍo `Ywv+[7olٟIrF$k.ghsrckЂ&+y?=3! <3qn.In|wn(Q}s.^#&?gk%Ln?:fo6 53>b|9͍qmWsa2A}RٍI}Rk {.ԢANnx^oLhi)ZmuҩUv6t=m6ooC3jTh>NU8?+~3c^gƸ3/K玱gI7v8M?9e|يi su.:yöHJsJYP{#ir\8/8sBk 煻Tԍm;IqrH&mVY'î $Z8I |F}6dɛ+#7P9*M2]˵AL<6/of ]栴}<{Փ]s2>=n|r.8ogi4o~q6ވBE8$sQjbpO9i58 r-oX@.6P^]h_;N-_Fg#y쯩29Bn,Xn-iO ͚곋][smF/[)\Ghڼ-mxLƢfbKAmSc$GckY~6WUs/ž1|g{*/9Zl>FUMN2󨧆X_#){lύw=YX{OQӖgs(~V~CmmqmW=c$6מ8}Nɵg52>w }*zcsZb~j;7|~טg9`5wse oIyv۳=FmsMU*S1=~Ƽ6}ag<'H&[,l+)TH2E|QP (V&ᤲɛ-mMғ z.sP_wC 5TTO_eP_D}j>n_e%y7(7f ڽ\-U8Ƣ]bd*z|ϨnT+`33Qn\B9BnD~+7$Ϛ곋k"V3\J򮅦c>x63>LRo ~mk¾,o[gu=7Ϋ~tnD*Kcc'LS})Nkr$>os:>9 ?9N>FA>;I\{w<&.e{V1jK8Hdς>~`Cio[5bUʑbպEi18/Lıy!59/8x^h>nj✲Y"7 ?/{L*mJM׏A |Ohձr@OBp/&=F*,P" qjs>ktJ\ 9js7ʺ!I ۥxksӶUYWJq_kSE-[ ƽ܏L9915ΊY2}{4CBwIr#I׷\ } =~fNUѴ٪OQ6Ǎ(]}ܘ۩iM΅.cr>:J+qQms5Ϟ ۪篦ͧNsuǷ95R{չGEnA)-y?;I8>j*[sPIX['%mfLt2|[>kwX 7rQիp^NmN>+ )_~|\Ml+ɫgJ98<=A.U(we EX$2,t6I 0n~CW']CVԍErjQkN'n25&AqԜ6q㫬2qLʹV=U}ݶ8KJp%?o'R?T(#1Z1IMqˍR.` bC}R6WgI^ 5q(F y{ydȍ .GM6%} r/i}umngQe\םy6 !5A}R?pf0֦-s_\šwN&'l6:YɍSq5H=m*rõu>)8?ǵ+]AgILBN6W!s="}X^Quf)VFr m,r*|> q^rP֒a[;m$DU9TLU9礖8+rK*.@}޷L};>/fZK:ƾ\^} ޗ`܋ڪfnhi췭~9sl# ~hkM^5FyehzlscTa9s}yEΉmUcdh| ܽSuks5)޵ɫݿӝs3}0787'*FڦgA3񔴹*qkߓ6cWsn,;H{0ce6J8/yVg|No[Zd<ɤ; Yv>)8f&Eu. do[:_FLЮdiZ B¨lk"]栰c劾:!5礠.&m'SU9msqU&A(7\N1QC *9e}zsR}b?bOd6 TՁ krfRڶ8Ks8sv{ 8kkx_(ˎyCk'ޢQn(`?S]?#5&IfPs'mn*7My8}uNzXMNV=5m>`|7Nqگ{]y.MO滤Gee}.Ts{؞A^H #=lK0rC7 Jձ mq(AnWgἐ̖ڜ}>OտWJ"G 횏m%y o2q^Ukk &_aqbTqUHE, R}EFik~bck6^B䂹ɳUP&hwM2E>''-]栴[u"dpNlk̑v>=n|u}.ky,J4 mkqΫFD{AŤ='C=`SVy;7\;V9/VظL\j㼝WU9#ʍq Z_An~<%޻rkxUZ#vndƴC{hsmֹr\s4lmJ.VcԜW";W6Gv|cΟqOv}cXgl6/P'quґ=61rߝFvj[t)+7keM}.ξMy|12[g>缠 $1In,Vm s7qMccۑ+ن q4f]c.mn9pu訹PsDvwvݶ+}4#M>wR]mV=7l?oxysӴ}a?+CϋY۪毦Fcq:iIF9 C#u9}3*8^}\㻤]cT ?Va4oko"߼?Nab<{*kVQGǷS>Wʴ{Z ٜVuBXhQf9K8/yAslU9ŏM\m[% X;X 8in$rq<#BD%VDZLN?1[6gO"3E(}wm ˓kQ1 .<"[.n9YkDl{ۼ_NS708i곶_eιHBr _#y]WsJVF5(*Κ*h .9#3ϑBQ\JT3+ԺI\(΋X-,jk8/r^8/d$Ǘ}q5um:Y| X;,ѬX 9Aez?ޓ~su,fXh~|mVK+Ik:v:?ᤱf1!%c?LYq݆ng_ߎֹ. kI˿$kTXg޿V~D}0?M0fl4?Wr7- 8qW2k5.p]7:%\A<}]^CK`Dg4b1qSa-@q=~(^grafR_uaup5Vmn 6vz u?'{g4ueWk V !uv[Z4${$RꦮMn4\.[ K K K K K K KkW /y^k?L ޫҽqi'I ϱ_;C_=YK7v%/meo`<.IC/ս>r$>P?,oa_SVݽԱgF]?ѾAq,նc^]s/F{R 4, 7I\K _]sX FS^6yu|n[~{\}k1߀օM_׸|~H(uE_mk [|/XW$Sg2^>yFjm [ZH` pKl =V"$n??NnokS8)4W/FN?φm"l {7vk4*9u}kYZi|u .ytx-ɬoi}w.&v_4J\Oz+<,%fJ5nmRgC X߄֠~oo~z Tg3e.Wea K"A׸UWoCSÒo Oн&v$>D?$@+.E+.E+.E+.E+.E+.E+.E+`]?L?uq_]3@VY]O8NӿaV?jX+6NCwru}&ȵ ɼaQ"װF-$Kx;y5$_8Y+e~b]:DSti0ԅ>?yy}wܻ1W8cI`D;vjqss/l0'|Ss_w\[֠?yOO>|9Y0^{4NdX']ev 7}ݽWcD9FbVVyrs5Ɯv s1$݅8[:WI834BC\47ll_0$Ȏpc߹ãuֿ sqz8+ؽyo:Y4ܞ&}n}:$'Yu >2m6|ټϚ|'6zY֊YO_;~nbV^ qiҀ7~%"%"N%w0'kk^76l.~-յWZ5&}6:vm=yU~,Ur]!ሓ@ :XKW | X[15Lb~-o:|m*| XY%d}`s_Z`۰"}8fmgS3cP}i\fc4K'ǢG:l,)lr1?~[+o-mۻws|:kM9~[F'$IY~}wm|~ZfZ{'{N|I6W1se&̎W{b\A1:>G6ŜXNto}]8i? X꽕ZGF`e V Wu6s= k6u=[X'I|,7s4Zvm̿1*WF5XDsc1:kbݢhnKqm[Vu_ߚcjPk9͞ڴ5X<7z߫}VV5<:fUq{#\[Gk ;KPD MA'U7=y@}s~M^Ġtxay{B~ۗV^gg"xb3[̫üXIڛonF|o"IYtDJe{oߵwn-IGulq{ͫ~?#ayQ2b,%xNI w1bn֯U{_2NRK{kwuDNRY2V>|'Wod}Uwm}kjnx}\Z7ֹ Ck 8LW?u=2񠱥CiR<2x=Mm>>oɽnn6i͛3sܧySIHF2QgӞ8T7}Hm Wfn Jl.4Yudnk>yi_~BJhIW蜉]^7 r-znwt-Qn6>ty92ָa~&3a(ULvNZd rn4+y;{Qt_Tng7(2FQN(=ؕwr͇΍{3ݱ0ӌQռ2xxSnnI,}כӪwO׏BS['sIcGҵ5X97\}+Q=f:wwZ-@ 7%iYQe ><|;+L 7y?\v5؃`?ֶH0Z<:oGhמkgœSdڴ'ʵ0[i|v=KoHmFL?oߎCp. X"{k=4ZkR}? }{[U@h3Bm7:ʏQ-䓟h>/S'ն'lض$ͽؐpQl|(?źϗs2R2쫸:g1:~V\[l78)_ ~.^G-UU=;COcsWޔ1<X/ ywC?xy覅zi?Dn8~xL k=*I >\WֹB5(l-+=FKFZTչM{_eP@|_kn%+7hn,l+56ck{cb ]lnlۤ}Ru_#;q#u_9/=?Pq72߾|D7ۤUuNlfhk{CZsRU6n|qÖ!sTI [1.UVWϒy%"`"l69S툴W;'-֠4v~bn4F EuUcT43Q\y?>54u^ʼztD?V<Ɨ4IB1|)W:Wżxm=~/߂߽n8V~5uq2%<3NZr\GoznbnغA!5Ö8vH`max"ݦE!d!:YLJ`Z׼jl(ztE;W?w7Znu=#Y> ZЌQ2Yuljnc>vk٧.;uDXzsO_pzj| '?WƞW5W~]:܌Y?W4Xuפ~ύZkWl2ZS>j~\2v.&ˌ9:Wʼzt9,5R@t1 ύ+ek~׵12,}s__ujj!Nfy6Ntk s|g{n^sk敩|ew'>$$6la <|cK둔iQyPnu>_{}Jp)oQSED.l^iۛ{p\Ͱk礷Qs0ǎ~n4_w&naEI,𜫝Xn_L 5%$Wl )gWA֟Q!m bφfcp|::8+Qf sp|Mrz{3ͱ:Ev敡ϭUY՞yin 7熬1FJ [7\Ͼ߈⤜s#xm}kPuӽ6FUE"~4[Tm;)dҼ j!x]z PyM~|[Cm1yCܺZ߀OyyӃk6-v !'0`[ޣҚGW[ܱ<7TU~?C<lq6q ƍ`&:|^ތ&>cy}LݍڹRz _ǵ{[OSc5U&iI?777u_ٸviw_W8FIu䎭.gm8N+p-]㸘Ro Wף~:WPsoe%v畡ϭuW9\ lfbyrkU_ϝ:oطʵ.!NƎ%NVZmZ51{ݼ2\y[]xo %CKJp FI? 6/ROt% < ~qw b^4 +5e͛cnB:X?yK>'q' bU˷ב:']Ks`5U֙6G٤w.?"O,^`8q͛zH`\AC Y\C%:Q|Q ΏqI R~^vERxx͑'m КD ^CK`5nK32osv8cS^[K0Ht${$ 3 K K K K K K K t0C ^4gE+dMpGԇ<ٯg/n'0֑e8 }s {M.B+uk?# —:XߟӰ\'YZ&q/DZ/% 5F2 )45uOu{CyPl7mx6it7oxގ7 F}8Nëou6c 0$ ?~*h!ӫ QXn y!~(Ib~ph6|ch%^,>7ɟ֗'*bOzl\?EW>@w߂W!eM"I﫻c6}G7yDI?_q'4޼-DVɼX5#y_^s_] *86:6Vu"WOF-].]V=Y?,$d xc-g#!IĠ~69V[}~"!5_?ަ?2s͛z2H<סϼi6w+Iy7ziql77r5x~慻&j6_陸xcp]C]WϏ?ĝv~:jۻ5&%5)HR`S@ևt{$6Se0:S|˟o>Gk+Ig[G9y}"-Mj62n&,oWǷQ6HCY٘뼟cs_VFņ7[5Fɦms0 fd״W0>z5WEyɎA͹2Kb۾2̫UxUk~,˵w{h]yYo6GzėTR {n>t>Ar7|v*P6NoNz*51߼{^ZD{z1۬5c̭Z+P^s S$16~}ZZnHi4.geyqFׅw}cE*K!N`m~~|IyV}Y EJH8q~gpX[l7n.Dmv>o^W }e67xf~6Zb1rLe-_|6l{sӴvòͼ*ϋL3Xso6XwX)jh.MrZgۖJiH{5΍ћ7Mܸr>׮A[FNkM]ԍ [Fzr+VX)΍݃bzzX/\er㲋WxVuMeq w-ge_p]7漩D֣>i`Ln*5o`[sҍo߃*糤ޱk w/ދs=$`6az7\)s(xK~ Ym̌6u7d2RWr779wO:Um6ĤRg6v;?!V[r?񵛝繸}{ 'X]KyEj>/1Z0ǯY"ü5hL27Fݘ6L:)4'+Fs#}=y>Wk.iz|cse׾iq,)5~Nؼ3eS۵[ ۹߸+E]>ދ&o_?>)=LYΝU7o|V?bOiutV=ushotֳf>ϪoxU[ p?X/ ث9nI.nIm`cnoIkR~΋Pl 6Ͻͽ_F'~5JPnp>/6}\011 ;U罊\Wj~KޠzϏlHחwiLpόxnJ!-s^?k*\^U9 PɆ-w,;1`M[%6g]pwb]$qݛ;nz_OFkx]ˍؼ$-S#m;}UUdne$p|>~}_eovN\27NS]07lMOW5'L;|^:9'zmrkx$X/ y~׃wOo::Hmh"D }ӛ{MhܱHSl.I7lpy8mo6VWyab'>Cm_i7j-mn؛'Lr})ןeףW%uHg*F'J9uy{Kw9v;|.$Hǡ*u}3<ϖN:a DUv:r/fxk~kع⿏kIJYn^M|v:s[ {Bt,JׯnN*\~[ǫ_n~U%G#gu$ Psnsʈm7m;Lvea*nIA"6\;͔&ZFlI7v7$r<޸l:W2Uժ&I; i}Um$89Y'iLl~]nVF|~ ̛ګޫXޚK4_so$tڵ?Wzm^5猝wl.WWr]?bJD iD.cOxout:.&R:_W7'*YbF;X5Ɔ2&6V +7Lۨn7 ֍~73⾪ޤqCuZ 1)N&d\NշX弲9ԭfձN2w6hJ7JY1mrK\>˯Ge9;%uoZ⾗3Xk6h,sH>1s(fWR-Ŵo`XG;Scb]kعg+Qr}*W2yy!후&}ެ`]ūUMl@^9WϒW7)Vj#UpR^l}fMԺ Qf>Ho`U-Ԟ7n Ƹ*Uu[ < J ھŘw] d)Çs 1_nϛT{Q~\.m~R.h,3aqMYl׬#ir{u+ߊ=g\voUrS[0v O$qxV?-ZgڌE+mb{6IDl椠9[=r Us1d4V-/A y y[egԩNLm =oiҀXj&ިRle6Z8E{ڹ9W5󢶯TN%ojAW~57k$9pn$G~>׬wd_TA6}?;2\,FٱL+*$vŜP\Rou햔;瓮ܺ\i_)mqP⬵]F]<~utǺN,Vκ9_7WsV1oxUa'V1M6$j6oMl.$76PqenɆxsLPf\`mU柢ޱye9nv^Em_b]ֵ ʾ-׾Yn[l["0>זw|; ~=gF5n?~퍐ok.-7%_'WcT/}}޸0W#Xu߷k7vˍp Ѹ\q_mqP4LX^Ylެ:Dޢ]EۜؼRIo>{p8ߢq?Hp|Xռ 5ަ' ϖϣ<IYJQRg`l6:sg]Tocvo6q\M\:.5ܐo ʌl?hW}%nߞ7\Xϋ:MfM]IzAT})_ؕf8q2obih(fkG,J(׹_{3w0۞mEo4WYIcec\?ƾb-zKcbzn=le^&U{7u7kR0ԕ$+m 6ߏquyQ7{^uox]ğWձuΕ̺Ѯ_͜t}eb:8omb>koxUs(Ǟo%f`u'Yood-GRt1Hnoߤt7% 36LY~2j3Qwq7~6|>/Iu9|+ObN;kYMwR6 aɮ >͍}~ lbpyel}_ݱcgMMZ[/j+I;/F:2q}df~߸+ֹc㑹ֽYF>T9 'X8>v{3:>{mO;bw_9YB1W7k!Gx>Xyey`;gQcPet(k\^{ G'yÍټ5e [Kjj}>]%&J~O; ١ڤF;U}+IM$2Ϫrmig=N4̓7ܨ=>ߘs0g|c^FDౢ+м0}%O*Wݹ:#zXcc\?UorvVߛjf\+Gwέ3[Υy!8JcoM^GSv;^D萒EZ)sYw_꿏 )ѹcD{[3B+\ 'c k78M\?4% G+TؐB X|O` dC4~AZ:s{H`8k7o~{=K$B{MY9XފUj_ʵA ߼7l! = M8C?ul> ӐZXvcE+<߽7^>$ #ɫ K K K K K K K ?ig5N ~$NM߿~x{4L}H8 }UZB+H`nz 'Ia$ w 2U%$aГ,xIՅyS@ X{MI_S$]׿vM8qS_]O%ɷgExs]'cbɊcR'k_Dz,$7BpkO1ح_,siX$ֹyI?vH`})|Y$`^﫻Jcw}Gv+1$!\^|ERCbWG]l8Y s zoc[ZI9i " _9} X ?Nkf.4 j(I75_0ޏ$>Vkgds v^Rֽ~#A͜Y&:N/2*@$>ĥ 7&FN b$<܏%>)ƒX-e$L{3 Fzty~ʰ㒥#8 tz 8I]HMbTrnnm}5͛>mWr ՙ]Rs_6׽)1%eI.nwow |qIIz 'Xh>/:19WfI{\yeLjQ7p~~4uӖN-Dh]CWǜ]rW듳;k$yQ1z>{1.5Wwy`c >X[$K7[&.}h:,&j3!&nshh۽U@tGb+$Rx-a[xi`|j3b-ӌAjmƨ&ֽyܛD1V*x ǻjibY/O"W$ a=a_t-]51ѼS{J`Uzv]'ӌٰmJ]#ކYj{ ڂِeޜX>RvS9q}`.sPi 6V̛ɪ*Q&)gpqG~֩2Y-LgrI 6v;?2V[r?5o{z۷i`|ڕW4sI0ձ.9$s#دRu68i%ꮃu(ըN>/]C_9*kyoo77tNM{b#9gcm|"j4Vg&^Ĵ<F$5 :DŽ/ud"/H(+AM;>r.lrڮwGbv^ʍwl$y%Yڴ7:>~ˬWryP2S~cDscw{󹪯Tm~ug3⃠R⾚|7E<&U97n9eِeMǶ㕧kR9Zl4ct|V{#"~ANIhļa2s[(DILMBdTQ]~[&446A[\y8moJR >V9)>N5IqF||%s99+:&;ھj8ƶE}N%$+)kY@Z-.+cNw|ywsNۓMv95ct|0PnD@f ]A斟w^r>bێĦ_Y~ģ⾲2. ʵ_$Ke4;eF%yu"E}{U+{NCݪjU$sY򝅴 ھjIc[rcW嫋&GW˯e5rjda]{%m9SG;U%55ct|Y;Ǔ}I+g"o)MW\M`kbNw|Lm5O^_5 fnϚ{r"~A6؆ ڵI:/IkAY }eϛ3J4T#1KPf\2ABIq{ڹ9W5󢶯TN%oAWgsulbm7]{6H}j-1;>,Aseւ[#2+ڄM{cCjD9V;j󢶯T.EZe_om>6qQ_nְT8ZvTDV^rNs5L?JWCR:T5Z3F6<-bGø %v -7il`n_3Ȓ:gS<ݙseo>wMܦ9fٞ[۽Irp sm&4$k?>,Ascߟ'e󪢯jJTsf.yp~^Eu_ib&!_khAW9iVu~akW,Qͨ ְTQ_~Z'N]v ]s<u}?we7m* *[%sݼ&.ܼݍfm{[Z]=O  &`59+!}L["]_L/aB-*[PnM_IrQ$ }<)ĕO7;W JLY~2j3Qw7~6|>/Iu9|+Oɜlc|s_wrIS]qkYznsۛ&I4XRע:U*օ3s𣢟K~wf=`>{;^˕P6Fk#7m6֍ff< FsH׿0q_ָ9pv8/iBTGv4rrM|D1o 6[$,YhX>m6y#7WJ)ئVRZMm7"מX11g}K31O 5aāl?b-;eDL kb Wǜsy*[gO^s䅱n<c>1RoK[H*S K K K K K K K t0C Q?F+dMKGԇίqzu{ti iϱse;_k /N ; yOH@ֿew.W՗^˺~zCO"̛8 Oѽ$ }~ɍ}S_]O(%Lɷ+EBx]'&v낤Dn|~1Ű~3as-{ﾖ_P]k7o-n~p-Xn^)Iy﫻Jc~}G7IyN)#;'ŲC"](a7$J_$ή%!/2m6tSo3&M/B$>I.bW?uDn4 j(=:"G˒B7FӋR2|~ kIܫK*.ZՇkiqMj4qiOuH`}K2oL$$< '}IH Us~'j. ɯ]ܵc;>٘SJO/\ k `vütm45>j^SY˾;]ĂT0osݛћ"Q\Znm|[B ժfk$n{gg-oS5syT.dGQvՎbatA ~j vq-۴kWsn߮N`׌mqsö@)X[$XcL`.Hzmjɷ7ƜWA }e6xݫϨU1rILQQ|kφmoAțmU|^e1Hĺ7{;JOxWUCEIlsC=}:sOIiʶ)5oף7뷵V;7j};6>mׯBoYI[&r-;ژ?y-,Ap1$@C$`6)az76 &?o*eE 65 ކP}dy;QU_%lnLF9wƭO:U%$6ҥR6v;?!%V[r?5ozz۷i`|ڕW4sձ.9$s#دj$}3αZghґ7+[=ףZ7E\*fnƫgx|g~oN4 CtxJ51Hsec!YC@t΍"v#5-N[MxLM`]3_lH_Y~vzmW[Jy*7ޱ 湗rLh/f^ ŦBoˏchn̂Nyb>WUCdM"Jn^`g렙+h=xmçlW57}a +J$su -AEscq\f9,[5 ~LI]wH`dBVOo:Hm"Λ D }[Ma[nZ7?8@y/ ?moRI?>V9)>NexN||%s96M+:&;ھjHڧuvy<ڞM37nWTl".մjY^ڿ_﷉ Essڱ>=6|2Ww1yеrJ^ NT  ,u4 )LйӔfGl6I\ر 3>)+ +6]; ߵZF$J77%r3}ҾuUjI9{ɸ6۫ooye)s[u_ͪcd.d8mUCZJcܸe^-em_$W77k05+YL]}w$Zc}ɵ}';6h XҿiW(GQobF߹,AHX7K`<~\鄣j\AX弪nA_:A_AW Ijtsq9/'e^ףTag]{mqf?G]{l/IAW-]j ^ Nm6%(lP:/fpWfj㹸yopUj =b>[;wy^hX;W7ǺU|^* m6h!iR,E̡kq˼ |z]+I(FT͍xP 7{ ߘZt~kF/nZc+Uӥ:q4 VFnOòڔLnn&6D7놽 re=o.>oPK%ě2cʬ;Fn +󳷟jU|^*h]۠+_'ٰgYy[;7[Gs=Z랋K M}"㫙jQ;3j~p)8*s΍p_r-{LK.]WhV5op|M]~rl<|?O{f$`}7ur֟ 9Zy*71wk7-پo 7@o ʌl?dW}U4i?!6sɛocn>/J~6ɟ5u\{Ds ߭$6W<^חޜˍO.ɮyzdEY \Ƈx -~moTd_\GLV IܰcOAkÃq Lrp ["]_LYk7:Ee ʭ+? jOOnp7ʥ3bKm{,A?}q(ۻI8؛ClyU>:ٜ f>T|nE $ʴ$lZ2z$ )=jkzdΟ _5Ј֥bnW 0Ba' b:NJP7s8kL1'ZVJ /|>9tkd0 rꫮau"?{ٹK+!_^ú1$y,Ik?D%u^RN^%a5X{3{:s)}cBSti0oӰl$rxm07/-%}wuoyrDj]ppgkhW IRDŽc<608ZkM\FnTף޾-DW_Bkp??Ffq{.ō^1{y}(H !.M86bdni^%ޛ>o]oں>Nvk5UIwֹ~n>6rjBuY=7.뇒I,}=Zj^(KV(^ {⾊wK )WkCQ N$+7΍z~r.qҼyϞ70VIsMI̫=ﱷ tl|>g>03GX=񼪍zpjf^*@t7vB>Թj>/l9|42kO9^bWgm̙iFD͵X/`7xm}*4ʹE-'~>n~v1ϩ?]m?n#5DcBs^Mӊys|ԹڐE9n6sjs$^.=r-F\r~E 08gQP b,/զƛAzq\oK>$_7 bp>ms].$wu}^re6׮=7V֯w;e1j;687D_\sc+s$cQ{l|m?qڴl fI^9=LvsC2N8wZD`_]#noXS5F-\1J˶}]ޞ{ה]s>ScmʸpSLV 1_ o\]so7#5`srlm+{lۜ[|v#|X0ooj׌!.oKlc)nNi l}f 9sæ2 gWrCT|6kҴآ5joYJ"߫W6Fί! {V[9˛7QPH]qnI/gS2F-\>JK21sky 9?%J[н^pl,Y뤸qCuE3ϫ1U[w*&Ò~ײ}&V;qU1Gބ~ Z^hl3&_ 1I'`sl[^c6*6q&9$6om9ﶛEblz]F\־iCͱ4jo5(X\WrkaO<΂~ccb-$:rcsltƹP'tMk_aգMUչzx.3c۴MJ苩eq7]M_k?yYϕǪ㝴<˖፭k\6' :<-*6ۮ7uϮU1G Z.y? FI\y 1cbXcmlJ7].썧Imf66,0l;7yoo Qs5Z Ǯ]1Xj {}_ǫۋ_s#^wz-W^;F-BU2]fίmIƹh7kߩ*|6|hط;Dٍu~mlM[4WkhiܰeH꼟~Nz^ժX}~W9)XG(jP?xmX[|E{~ j迥j9A= vem6݆Sn#:|`dfcXϛ Yjesur֟c1+in=Gh#f.Ĉh4m(:vAn{0UtmϯZ {c?q1 N$'ߒxf5>׳xy1jl%szyfn+I<;L}b線[606ǞBwMsfgtlؚƧ.Lky!W~{63־ҿ5̩랂r? Nײ^m׉mC|v筋9a54~ l6xiX72x䛍̱rFYbO8lLyi9Ʃq`n7N`eνKyL{gqTh`~K7׾\]״[ekP;Ě+4^%ן>Z8^bw$^dvcUrldA/-G1z䎍C^ $0ii)1X|>>&^3v↑ˬ[C34}ծ⺾;eO_riñZjYU1 $6Nl7Y͟6<,J` :M47ZK{ߟ=;ըg|=x5oe}~W.doDWvbqu{g\3<ڼA79yU5u_ު;{N7Y-W?Z8kn~صw0^9[6״s;ףY}BWrn>;Ookq=ZQ|n~ﯖs>;ʽ cߚ\SL\u5OvCsG|vSL0T̫ )}1ݏ˦KFWm`VN`5~_wޟea[P /V},~C+?%;D|2sMr$DAhM^zυ$;/+GvZ[e+H`KA47DJao{-{ A+?Ď`~ x}ڿqz ~.qs{c(sU&sIj;!7k1~ZbZ 6o| GbǟսqI qJО77:I[p~CW:nDx m)Zy57H#GbǟI?IEIhϜkx%JuSostoZ6mą ]? 6" )Z}ެL_<Xp)Xp)Xp)Xp)Xp)Xp)Xp)X[8π{ꂟ a_01~qkE۞6>4ρoW^IbZ$Kuk?a#繰mv`-<c$Gy>s 6ߍx}6%Ui5uf<֗mCSti0hkB7Oú,^{7mߒrY?oM={^j[vfu"īڹA̩@̑cҙ?=]s];7K%؎8 y1)W'Rg]q|}.{{ZCnuu; _@C؍+6 f۸.jߚsi?I6F]?7Qyc+wpnssOH`ubYI:"^7) _9:6nT2V Hki>X$>x.#1쯽~~li'6;ܻyWAQ ivm\rGaKfA~$^a-5u)?riq=x}1@S$>x87/?Xw `Dm#s4XcH`nߢ>nt=xeӑJO04ﻍ?36Nf|$ݰnRǮ~70p%GxJl^}Uon1skOywez}k!&:u~׎Ѭ=rjym&^-s+3K\Pԙ1Gծܢ0Oy_%ys(9/K*r~)xWfn,-qv(G*ߕj 5.~ݗ)[iwk`̣R}fV{+WvOfZ$qMx qz^Ě%woT2=Rδ֡ף;p*>ҵ$?2\[kx6Uph8LW?u "%!K 8Aps*X bJcRA]wu?o6+͆dzhfs.WogߜT ւURX:~>emhU7ͫC}ī,bC~՘cFXt>\7u7XޤH9#WMc#_3>ču;/>Ho5]cEI|EcyS=0YL|j-sum^H`dsjSHoi6A\ OO n6ې瘳jPsEr&sRnncA[ɖ ^m9sY bHѢq{sI(-J|QU=i[6U(]7+U ꜯrv-sl=W5A6L{ќ_=t|m缷|u߂~ 8'^:E"z.1gU5G@1X/ usnH6tNXopJ͛yB?'꿽gÎImnb&>d~9g3@[gQ]e%n~kD9Ĝd #OkWnIҝI烫ƵqË%tj,픬{W7 +.I?+~S4WOܱ̝Jv~*9Jύc%; Nu? Sׄ(S:6bC~^em8m9gͶsւiXJ7k~s>9֯qBSrejt>m O۞;kz~_i-7Yxy ; iMYjI7Ɯ&H`U6KF *Ϡ-G7xyN+X'o(64]{X_HwW~v,O}Y&׫~\?6l>_ڤ EnN>hyz^zU[WKs5ҴXb]O9G6X-󣾯Jb]9sBNѽ6{PW6[cSn_LҸVL;u_Aw]ϔp߭=scO?$}FkgǮ$y f8 efgp!qXCmjcKͿM3N窤DwThzsWkASkޭ9] o6vǹr|m%^%sc}s|Ϻr}5TW[c0nqCVv|._M_9F;Ek^12!ROv s,t{=Hli?fD{Q{*pPFol֘7Ә̟ZMyc%ͨTB@hig'\F׿0;o.lTvssFk6Os\4ukZXn;{NٷY-_;uD(WC5u1dz70ĉwsi%NJ4I fUq;>oī͍N`5czC- 7V.gm8N+-GwǫVz9?C+U _& 'eQ&&SM $ܢj @yK'{MHI~fҷZ$P$μ7~}[&s};]7\>}~sS @?:l8 (ӽqI'+ @jtP 797Zw$L>y.ɫ\V\V\V\V\V\V\V\V u0C |5N ~#X} "]O8N#s WMӾ8 }s0 |~oe#@V|nz U6sa?7{0ks|1%Fp݈Wanc_I`[H^uޅֶ[r#)4?(a},m>jSyY?o۷{xM}_-ز LY9m-BĜ /io?:&s_58wsT8Sxu:ep{MWWj6Vw_wї]ۄXT>]gu۵[; p'X=\=XuQ3KM>67ֹ~N~W{ 11G;VO)&#yzr-熛MJ^aعg Mou1ck-?;퍣7]y18 W?w㷾9 ~~lioLa5x%bΟfƅwY*>xabWkŸ. kX}k]7\WVj#<֏=^o+{XuPpb%~d < ╨mbΟFkX~>xq2 'kΟ}@k[Q|fX?`LlmkOrz3y1!o#^aj7S>se4IAq}ah~n+w+~Wfn=.^׵l۞@_t-DQArFt߱c4zEc\Z^W$̒9 :u&x'Ǩm̑'+W^Vy_%xs(9/K*r~)xWFyZ6sy|..ժf^XZ;eO>|/p:+-/f+s`|e V];(CRyU\Eo򅎝5hۺ51r=ڏsi'CGk -7ӫ<tǚz{7_v qL{R}joM?jBLt(,<?ho9e#)|"8NjnsP!ѹ31'c=6jM}7j-hOB߫3""^c*ꬊW1kFu{1wK{ђib❬̶-u}UD2|K}Ucdd>K/uAok iąvݰ-W0Jw[6>בڂy7O+>>k% 1N/͛)l]$"y0mnF7>8,cY:Pd#e?7+ uݾϋ1un׼ў78])1~~PRXjT?FXeCڴk?n*1ru7u.M?GH`}CFFa!v t|Q?\:qCsS~To"=<瘳jPsEr&sRCǂ뷒-cAs<11ԹE9>(7 ە[IzҶmwQnWr9_W,ecnϱ1NΫq{C"M6:G϶mW:5sWζo?]'l?,>W'NWoO9'o)AuՌQd}er *z.Z(j'"T>6owwy;G'7xl1Imz۾xcy0.[ڲst;7Z+b1;Y>)ȓ~ڕ+/SW[ڸRWruv\>Wg!mo%W|N7iW:Ee}Q=UctK|cc';2`|}{ʶ3F{V|?fo!qUp$T=TP~^,?˵n(| ۶ɴ~Q|.Z4mPA־ *ībĜb1Gaް\yھ'{~m?ȄӶg^}Wr MV~$^ihk_Y{2r+]ʮ/߷1=xE?7+&S5F#>`|ϩ[~Jr߱jt)֯Ts# IgmP~>2o|0ZrkҴX=e +ש@ s>~5HҲ\yھ'=f2IC 0r MVɹ~)^i(k rwW^=pH`۸Q,ɰ7iW:쫶2S5F$>`|| ysɾ_decv)֯uM$b!xAg"{y96-`3<>l`T|6kҴز/lt;*R3bΎ ǖq6W>)ȓ~ڕ+/SWd{~5b~3R[ C[nzceغ̸hPylQTgw6J({x)I_G91j_s 7y.7L s>K曦 ^U?I99mZ1wb*9?V-/*Pֶ̓k?I,1hrxاxRPq l^^F\j,Mj-=Ik_XwYYux!^5WĜ8Mj-=sTЇOO`U=QF7GҵcΜן\vfnԴWo[n>5#?~>k 6P^v~Nkj4mO|.=:OϦ񷠞4m9er=W:|sA vז?v-DؾSe$jy~N;>?;{xf~l=Aޙ4ه9 :jnVM\ւiCk<~o5F=׾/uD_b s,{cLaخܢMJU_X;bsƜk;g5q##r M\NxP7q-U/8mI!϶+ U?m_Z]WP5Fض'>ΥmM]d_u^ʶӏ66Fn*,HQxH`Ul[Z?[>>ms]Y:y݆O)~@V-Xq4tscO Ռ+]ǵR{T_>_WgAʵbcBI2o!̓q֍ø}ARdȃz!b`S*)$'Qt@kASkޭ9] x+|nבVXb1? 1Gχ+gZ3A}o{< {6|Q7de2*īc$FLX8ᘧkQ=,2rʯ+ ;\򌦟?}ƾyV9rZUݱ¹HSb4=63}q#ou #O812j}U_~ dyfNa޴0.|hϳ+?8,yxxc_?{vBQ oY }5}/k[1\3ڼ}?׭MwqoScrp>J1ǐAMwA ;wqr}u5}SpP.FUx-l/j1:5cĵsyo< ō}ߺo>o9VjGrJ)t-}˶;jsߓwyU4Fv\ݱ5s>;ʽdה6s#Nuܘ<;}c%\?F}{rߟX&2/q+H`8M4%523.a(/+?8yMN5u]\K%6$ p:/idN`־J.'G$ͥo&=$\{;㩉槏7 gXWI|Ϥqܸb8m$\-dI5KŒSR%~u_-W#8ơg܀ƋCO: ^;y-YMI+Jo+q^$H=y;G k; [I^#"""""""x]?L?߫{ꂟH` 0/`@t]? 85"^}~|8ף pn1^^$V/Ma, <s_c9|.aFB*p%.$e޲֗k=[H`}5 iX`'(Mvohk^S=܂-p:okoU T |I{1̟"ڮ.𝛥lqWī x{'3ᦿ~1ڸC&A%}]κ'{/6H`}Km6 Cqz=0d3}ls-7ֹ~N~W{ 11G;VO)&#UzNƭm$V_&{{;ozt~;ENqz3G!!ޔr2!_{ʝ~٦_0N&m!i x%bΟfƅwY*>xabWxfuݸ=W{3Kףڔ5f}] QH`}7b?n]8$"^F!i$g+qJҮ#X=Q{3EkpmkOr^/#Y+H`mkqyM+,3nC>&)MFq[wW_[#{^]kٶ="mg_ZΣEHFt߱c4zEc\Z^W$̒9 :u&x'Ǩm̑'+W^Vy_%Eys(9/K*r~)xWjnW{]Cw\ 3{q=wgpkXy+.NcXȼz`!(WQGcyn~ ڶk! w|\|/٣g$ `?n)ՀW)ɫy5"yRog7jts7l_ ޚ~^լ< PYTho9ec4|"8NjnsP!ѹ31'c=6jM}7j~OB߫3""^c*ꬊW303Bm?b[6ƺ^UuJ{Kc-;h' [A:y= _nM^n#~kX|;H`m<\n?M=t[ >O=Thfc Wo6y~nr4z)kv^ug޼:ԧA"8Ĝ_9vmd[[n*Q'l?N}UO:\vcc[co#^+ۦ1ZmdHXǹCh5+ ip~j9hޛ-hf׺s~]ݼٍy=o*qRb^q=~~PRXϩ#[X32scGi~pzk%T-c=o\~hq;zɆSզT#Fn~>Mv g&_f@E?ǜ=V:+s4n6rw Jjo[ĜjPGr#oWnѦIbY߭F!^mP|]c&8@:&͙X}mۢtWζo?]3FPxjoK>jqQ9'o&Pd介ټm&i6오6o)Яs6Zuek_^[V{nnF[x%B }'K'y[rejt>yk\7x~x] JWΒ׎su6 F=MJh~4-w?oٔ*?6a]|d6#-Z4m>V0G}OYJ8uj~+49Ĝ_9Һ,W^IgL?W`iPylxW^[xN){1gGӆcƸM{+a{sIlʕz=\͚ 1o%|il)--exդkQ|{h%u||T]:Y,jZ\Mͩ0?ǜ}WORN;nN5)z]cX~N)j'FT{wkۇv3O nj۶^+T<$p7qWa\ւiCͱz- ͋4h͂ۆ~35+&JzFkҴص 6\[aϵpdEǗjC˞Ę3o+h]W;1·؜1ZuYMȈ܂y%=ׯūFsEJ~eڼ%U|ܰ8M_ikj>0NN۫XڹԠq=Jдص/%b,W~L1r7W鿝%' XռVgϖϣ`WֱNރCnic*6B78|=GhobjV6[1_^7z}Wo:"^- b Jӆc9v>1Mb]̏*v>fu %ZhFK|6﹏ײC'^)PtlmRʋWu{y dM2VL;v4+ u;jsY2hw+X'sym5pcsI|#W滎k_ r}I#W;+B %  lӰne.6$E>7|9Cmņ֦'sURHNL7fׂ\]״[esRn;fSx+|nבVXb1? 1Gχ+gZ3A}o{< ; !|Q7de2*īcdySvY?֢tcoMg+G ActKsǖ_Cs#h;s}Oaվg3FF-eo_Fo<(6o[1o?>6Y<4? gN3{Ax5oe}~ˋ`|?~f6^7y纵)c?_-6ysʾixZn#GI"5)c?9y'Nt?N[n㽦v U 1èﶾy{%^f^GK}ʌ8u_)ɯ {WDZܛȮ+c;n=![z(76KѾڱcm?žk Fk8\s}H`H|mnomKɫ|k̼yx/\֧^`6ԅ>ou)YV7Fn%~2o_3۷{xM}7s ;\C;'EWsS#%WǤ3"{kwnJq^bSN]ϥκ.i{U7]6wև%Wlyv:q3N&\Ծ5~~l?~nz:Wjo1U T#}G{bs1$uDjoSXr|uldr|3 H`}7\bG`c{c_{͝~٦_0N&mvֹw;s@ڸ02K/6xCHZ}ZjS~{bH`}7b?qn&^8$"^F!i$'ǐ0E}~{ʮ '#^ae#n5[iw"gl$h7I .!aݤZ]M0na4?K껕 b֮u]˶ ikM?JBLt(l7'3Y7{(#LZW&1gѹ31;>9Fmc<9]E a'J Pr^ƍUX3\S.j?V X[77QtT2+tk\tSF/S0AGb̮.W1͖;8 -H6B-6p:E75KXeߨx$t WVdfi8W=>W5k!&:u&g7kbNjht+mx['TfHt.(L ~ϮrS ;ƥھ'{CDWA:L37|;e|wqc]/{i٭CYy-GwU||kI<e-smk'Z - q^~vD&JjC@pTjcG%@,ż֥d`~lV 3ɦ-\l89Ͼ9=ͱu}/hϫn̛W4^5WY|1Ǯwk'U=|puۍ&n$>oIx%/wOsGl hG~g}8w^|ߒ1jEѓw(ȓPڕ[zҶmwQnWr9_W[;,f{|{kʭg9m~+9zےyo&ؿpNruE\c bΪjb$^@q̑l蜼$|wqW?7~N{φT܆!M|<sfg΢ϻl kJ~/x"^s>9uI1G׮ܒ;]_ՓW?okoK"^Y1)YK nW\n~.W@hί:sc+;U3s╢K\wAk3O@bj Q$jcIul@ņ}0?;*qh&sϖmҭKUK77n臿xV!^#|s_9ΩU=|lA&ԟ=w#Җ[0o#J;F;E wr.ՒoxGOܱ?;/-㕢@?2~5ڕ[tzm n>Oh^d>-`dvvJ=+雚˔ۤ%Z OU<{&e>{3m־ 5'w}-JdJ\wAh1OCQ͹ <-c]ߖ&fOsl@ņ-ohn6e-7j,M*-ZJ@k~K)e9#hPylioy%lb<]2}UO6痫Y3! -e]Ynzceϊ,6ikA 2%IV]:s$0ǴR{Ok]J-照jb$jyIU#ۍ,IXm9l i7v*6 fʷēZ4m9'}aeei[x,^s4m9bQA>=UWD6)|?J׆cKi<7D7Ɋrs7A{GOĹ5o6??4~|mxg[\cꔵH`mu4,1 fI\y "cRh# z-Ϳ.썧po67ۼ7lUM\ւiC񱁷nxE`WֱNQ`m6?)hڻرͿﮔ6?RYoՙۗLW8~6m|#IW71s5Z +Mݜ|/h}^v>̫vd 1gkpiCѱĜgzs [lb .[G}_mXsf3:4q{%fm>k١m(:6^)hh-2^?qv/ 꾂64g )Ss[q={|K ^G16Ǟx-Iƙ╛ϥւώ]I>Ak͒qM>`C9$61a:ٯ7zgUI!92 &\殮ׂ\]״[esR9ls喯-:J:K#~!0ulBk&mXax'7jㆬ\&^4^x9rv-+;6ucd٫C hs%X{1p~r+U1ʯ ٬1o1oY?_7x,JQaӁgN3gyMa}Ys߽\$ب2 mh?n-hʽ؏~nwo;:[~wxQ9d jʽbgmo`މӖK~髝{hRA0ƻw|7oa{W;9֩[ߝj8vч7[Xoף[s]xϞqV[ﮏW5is'Y@VMN$ʢMlM$;xIE"*#uN&<oH`_I`yo  *(u$qz.Q{M3=o_7VCO"1W"*+^;2JuSostoZ6H|6\W        a>^kW G$x~0L}AEqFjSs^}U !O+[qsqa._S:FG+ Rևlޟ~n`k#9b1K؍ 8\ǿ% \q mZGSti05s[xU;7992_~puL:羶kp |fq?/>t\*ԯm޽pF/$ %$}]kwwN$>ĥ{{ fgd}lsos#^ bN5bw .6=\SL"+ GīZVO 7/$U>%Ò5s߷ϦA>>;F~ݍc#צ[DwGovbp !~; Co}s@̝~٦_0ހ=&kJ>79 Ĝ?ͮ 7(T|>biد2?=7\&ֺo܍">3Fx{0&6%o ǟ8FW$$>c??pi?ĺKx+Qۈ9:Ĝ?ְ|leN2?}-Vu<:Q~ڴמf8c$CFk+]?^4o8|=9!}6 h`0@q=v=w7øV,9«VW{^]kٶ="mg_ZΣE|ckhH~6I̙%s@t.(LOQۘ#OiW̭'J"Pr^ƍUX3\S.j?V1˵lWFU{u?]x](UͼZyvnˮ+}fϷ^:guPW%T9?WZ^(-EgW筴XwP"[A:r ;skжu] kc{%O҇?$[sJ6>kX|:_؃\:X !_$ڻa!(WQ[ٹas51r6m|!#0n׫݃kW!}'}hJAb!!;v5_ڛ7SغH6D.y`<܌nxc3}y+7scŭ~nr4z)kv^ug޼:ԧA"8Ĝ_9vmd[[n*!l?N}UO:\vcc[bo"^+ۦ1ZٹQH|^yqX'Kh-t^-ס894F~nW}UCc49?>Eݼٍy=o*qRb^q=ͱ5Զ~60scti~pzk%T-c=o\~hqz֍dC@~?t㦇l6=lD>{xZ1gՠ-M椴o%[ƂxxbYcd5s#9Gr}P̑o+hRWm۬VqtT6s1ڭOY\ȋc;/cW;j!8@uEltmۢtjUm N*N~4BիY|Ώ(^O&nߞrN2FyEMSn:mckˬ1U\ʵQND$n}=l?|;!`Cߒ.gvO oذcj8<$}OhE?ǜ`:@[gQ]e%vn4^W"ĜbNw}Ȓ'+W^I烫ƵqË7tj,-}!o >{B&9?%J+ށlSY?oӤtGJ8>{'tdžN2w*ٹeW ʝ0gm?g# ,?5.B7Iz:6}X~kP<@miy\`iڠj}a{F5^UWň9Wcxüa2}UO:6~ m5H̛sHҎײ ; i{dV$]\_ocz<~nW:u9WMH㳧jTiG|.FS.&1_dcsٵ1R_E?'Gk  b˝M[?Ͷdb klч`̛ۻ׳Uuu[]X}̒N0@Hox^ryм9/Wc4ɵcUޜY\{sޗ']W$6mh*p]?޳I_)N`_mka}Qr| e+c|gy+= p ]Jjr{͸d*oE?ʮ;oZRx&_>C%q[PlB/>_lnh AM ˮ7No*1֜6]7۴wl;9I?۝7}U./؋[3gRڧݞt?M"[;X?^m . ײ6]UfYm&q^3_E=xU&}Ug]<~ar}Ngm_c1֮2OxiCaٽs1DW2[sVI`%UM})[~Ēc_<|WbJoa߃͋'rlk6 AMJʮ-Ns?y皚UWW֜i5m()5ъ>|ֺ*uލ׍9Q? %eזyflt-(io$1-B1Btǘ~~2k}SQ6}{.~'?~~ E* %eזs>W:tO5p1Zc΅ *Zїq/9K/Ξ?ykmL|LYW-u~ۨhFsSӆUeKH~} 7t5C\m7#ս~arvjڰ5QB=7!-Oy_ YcüxhژY7׬k7}ܝ;UUEV-]Ǩ-Zبiot6I/v\giE{]I<^WDv |sUqk\yjc9ߩ>:VK{OOkPI_Fx5cԟVǮpܹ['s߿}ʹք5 E_l=\—q㄃/_Z+ 1]z/xb?%,9g5i̓~. 5筫l<6mк Kryߡyz`T֚3f͉~ax;o,!5gJjh56sݸmڦ˷J׍sODz*a[^_?FYqњ8gKl$lZ.6WVq\Q&αdu.vk)yU\OAdz^>efF"1V8͌kh¦e?61Nco2rэy;ϭq׌Q?[^ˊ?DFnO2|>}Bz旀eqKƇ'~e޽;!U nOYI'r8s7s5}w{*Ffš9qFq<-2ُKl.ԜUe? sd2yߑydfr`y_U5'ҵ7wMj+ۨ,髑*+֌VѺqk>5^۔핌kYcfoO5o? W1J^Bb-6?Ќ۹_L7xsu$[r%3N=a?}՟;>v9|h 8% |K^KVl8wK[ Wѹ/IjKNt=|)˒WI``WXؕVv%]I``WXؕVv%x^k;.| I`ndrVƛ8zLr+ɯd/!-NKcKB.eӸgOh} |# |t6Fm K`ʎq&s:tXߝzW"u[G.ݬ|&z6fu.9{dhvxی&4}>]'s3ڻҸB8MWֹDͿ~}jJ˅1J\.#X'o:ݯZyuR}fn?W3Y^&u/t,~ W֫ ɹ$c]IwJx ob 8Āh۞&~=oׇx/I`}f{myUl)}MQNLJu~%vVz\ԯQc1lq >ԏ_s3 ͡3h^I`}osFOvd]ɉsm?_ItxIl,X_iykaf2;xYN"u97gk ǯSs3HO}臎Q^| [9z7:ߞ*~>36¦]<6'v2&7ݱ2KSSBQ}f6_Q}֨> |B01k<<:Ǧ;who"c[WsJGy+?n~ZW;FCS1*_2Ғ0Wƹ?{1(۶vuUcުdҤ~ʺG%g\(J;G2֫:[}N mXZOv{cs,>-l7؀@yQ&j6dSqcs/܅ $}BD1|s6c<;^mrG\scߒWnLMΛ:&: ڛS&ݓ^qU^mZ<ƲjްNM/֎Q}5c:ٖ8oEF*zXVk5e׹P~Med^̴w #u~zz1gY8Vua`>-i>emVm0 $76j6d˹JNTPdM1wԲ^֫\+Ա)r_ SOh1g'ԯCr6׋67o7k6!{ӱ??&,Tr?ϵ(ym^{DFz-mՔgsA9<$ ,Wok֫LcW΅Xnoyhfʍ~,zm޵ V 5ݠuNW׊u>orkF9Uy\5OmYX˾SWSV[ykrڻlo8uiU<΅hyifʍ~,ն7ozbMLy~Ύeք9kǨյb75M3V3DVO%sxi,rB֫]U܇lsƨbnu]7"u3Ѽ7Rf6Ҋ67oԳjlB]2ߜzν-:WF"2ۏe7Vn5mjM7X2ۛܒ~_zƉc晬[';62:gq;qm1 1׽|cX?N֎8dvrߤ~/_ Rr"EהX>V5%.ϙd X~|ʙwK q5z=o{*oE?Ϫ"u ӉfUl=Ko 8 wGk:lCp)$'<|{7w]s ~Pӆs2.k]f{su*_8qp<9:gq;q'nEuhqRM;w5uvǩX's׿i}wK` "Eה8>VF+V>Ic83W#?^̻qd*oE?ʮ;Zj7Ή'm q[6j6k&lܽg4ژv&a,u՛[nfkԴmu眐׫6N&Rgy6gX;FغS'oOfIoNJɭ;N:ok^:V>VFOKk׸X^*V\5E$֊6Ғ7$7mH&6ڟ>nڍFu?G& ,n. mmjUDF"B;EOdu+و-Ih5mX]m5Fpq_W76uʹ0םdXǨ=VצlY ƶߧVlާmT`C1iXM~5pFcЕ7f'Fc4~mqkoWm:tHm”cm4;5mXUtֺcYNǨ^z?Uz59_5Ʋ*OK{s_T;ߵ_]Gc3'HSrZM_tN&XNVQkNL!gH '5^sS=CނkKB5%n㥽5}Uz8F9ou*sJKd=F}_[9Rš&a}I``Sz679pY Ǽ'<&?Dc A<L3v3<'Q>;uQ۴'M4ѡ.~y<M;nD2m>=ϻvjn m^ݒL[;tX'6-K&Ʃx:3\ saVkΚc4^2k)$jYb֫)5kƨUOu!R =h)>Y}JRz^8wesě~k6nO؉7 ~,t{Ja=t= ԟ c7՞3iơ9qFq:=1zR/$3{=ϚsB'1'^`XI`%* ]qV%yβdCh+ffr>z*|h 8ݣG+< 6 u8o Xp=y韴4O ߪ}ʲU[I``WXؕVv%]I``WXؕVv%x|t^Nk @߿zkr_ p~B>}w8]/cXH`CsEMĤҁկvvovцF>}OLw$zn7z67fu.9{цMlۭ}.K|/^Mh>LiiL~xK4}>-χ͔(su66FcTE[oSjޗW@1G/h >qU|&(%M}7E]}ޡ Cs#gR4Ch,&5֗ UmFizwI~}=6>xX+w;m~syoaLg6ڽ*iaZ{Vs] vW֢)ѽ׌TUlV|51G7^vFmX+Z| PDLx"a,J/^,}+?)č s{`9\S3'_&ׯ7T7Z\7}6=u#o4)Xߎj5_.{jDǺZUzjxocՆw?8FM{$? sFJ>Lڻ翬Fa|f!QR}_<_uq|+ۯ5_2sl|{ܶimy>-i4$~JXF8;|O~hcQgWjUW}7i\(5`5 [i|\'teyn207cjK®lw쿟ԗQ}f|q?Y% <2͎C$#u?ΛJ.:vLT{j=֮q Gk{=ϰ }2ʶ=FB,}l}Žh{RMl\V5}i'{:=vxܟFE?O_ש}~J; 11ꮃ}xoq-bV _ϊr?3+m2ƃz{ &u us{:߹/,`f 1]{'q|<ϴyˊU\9F6 EC`lhO/>F[{ a1Gckbr;5` V~Om0,X?+*֔oA\v/bs곢/[qh^ѓױU_+^ۻqd\kjbxN1fL?UF}Չk1y4۾Ay<1ib]9w} Ԕts{5ctj} 2֎ }|5Y}BKXS 45e_1֍q 6PǥxXseͩWj.JfݨtL4u _q (G0g͜]a.w2d*6TH-#ccC|Ƕd}mu.\9Xdާƪ5@rn>l`gї9WyST );Ya0yhqݶΛ8g5 51Yjbc0α'XߚZ.|aT~QEKF?gY6=ccdp%2y<}|.ml/x sDucԗtwBh֍kkե8ɊD};Qzc5Sc4~m|RyCLtxal}Gƶږ+֧JxI~hI`AKoh/o3n'?,ԔM(Pw?mS.Mݓ~(hnW\*ʾh.}gPMb#scЙ8;952\vU_v~13]9cH%9(5 Α8oݺѨA?.=M{,+6֤Se*Q臜 ̬Ж麭bk]GlXvjc2[yfSޭ~,6}Tld<\7)37?l& u_|lIP!`~^e<`<2:˦6q߃-QzԌ筺/L1Z?*\W1:6 d#-Oj,BhmKSF̈͌gq5jkNld19Oyr4/[m{E1NXopUM1)̹>]ϙ.߷Nek0֍q$6"mȉ'չ7Ys!첵޳gccukO+ƨsDC>&gGl?T:9g菵sQjƴ19g_2ߟVٹRkYl|xl|: X0o̍0 m 7kKC>4E_Vzxǫl{OiGzAi?`oԺUɘ_J_HLk-﫜sOf_֌=ֲܺm35B?(}U;ek{MLv~qs!wL8um|~^sw*.sSs&v(qp J*.[υnL&nCN\<΅z ?HdBv~^w:fFu_N` }XMٽ7Uuczucp1*Q6?&p+cXIoh[ly6ƌOp]^Akˊs_tq[nkKC69lب}U;[*1y>g8Cޘ}2ǭNJpڞPӆ²/ȘIeﯖq+,[Oq$6"ˉ'y6ʬx[Jv٭i{Ѿymד}\wmű޽76kƨ+{[\܎}t/7&WQa?61՝=xW`LGΙs-Q6nk+cfs>266uoxɵw0w\C'=X=H`%N}s AqZ?o$(pw?OY犲!vJ>6a1W{lt=)[avVFUEu\?+jm쫼6f dZ;΅g5Q53v|\' l2c1ݾh$~9C}g̅ɸ(s!kLCFƫb9XQ{9g~մ2F81q>]σ2,>BU_mAv2"u5uK0Ov٭o,sXu-wilDZsmVu[\fݓVc#}ǯ]7j,o%Oq< uS$^'bc>266&EecrmFb#{ `@k7,~}6scnw`ޟAc/ 7O4te۲ɪ/( ̨hr|Z'^ύGFkqWZ1˜N]œHU1&=;_.uq(YspJU([05e_4׍q&66,EXs~\n=̅{4ȼn-~Q~ٍHN= S46u_r]WWA16m;ߗ^QԬ5)1+{?U+}G>Rlo|al|F{o8ncUL_CLc}?˟OHZ-mnF{ut><XˍćKSm{O͸q_Eɗk-} \7F}ɇ1Owc/֎Q˗0ss6eE~hb9ni山zlo[b"wyt{;WeIgþj1t=꫅/UŸkf̅`Ul`鋴]Fm1mWLNol׹;+ﯢz=mZL)x\\7ad!O=۬95V\(3CcTcؚ5{~|wL`-kUu>蛮n|s_?ޞҭxhUqF2My׍{lgH|UlԨ#Q1ƻ^kbe߸L{n{܇>;{-{F胂S'uC͍xa0?h<ܘ_5q~}X@x9 Vއ/@n_7^{ngseQ/γa%jW/e{ݿ _&ߵRd71uh-md?~j'Ɵm[o11>F_NlT}POvfFf.4Jl)s!]}k;Ƹbs-/Vϣob[Q}߱:6&odŵU1o?__Gަl,6"a6r=5eW2ۘ~^d;΅ň{<Sk:?+:d#b %}OkvgNߋok뱞M[g܍yݺ;XO{%c57Ec2V֍~^&'~m:6O9˷ݮeslh?6vg:Y}7?,igV}{`~u ;bXr|;B&mj&3hGMYVp saЎ5 )vV'9o%&Onm}5eY=̅x;^5OXޞ Tdwƅ[?]pho)s_#ޝk7/N$^ V'9u>iJr߈Zr95eY=.~r.H7 ,s>< PC+ۓw;ηk>%zS|S暲q_ Ql]ד ixs_ PO+ $+ J+ $+ }X.a^r8]/ɿx??p=]br:$^xo1IE1~!smC`X zy%KLO+:CGfNs\+.jxKb.t5~·롙C<|Lz eGkEܹ}濳pft=f1ٯ_M-]_F-nJ`~ 5֞: =}w5-ĥnw[$oEkmXsoHZ+9MKkՔSu>䁽ԣ+ʎҦ/U2Ygkۘs SʮG:2!%Uj?+&_?}\{?\]F1 O٤g?_ǀkz1Nۦ/G &Zzn½Ľ;q&5kS8lߓi7X۸{"`DBDuِ n6݌loA;.O|+ۛLo WSAM=2_rkϑӞNIٕcoMh ʩ׸-)Ua2bozt5 >MOۿo}-Km0^3al.}nb!}N|˜ֿ,[#Es'9Ѹ9xJ/k}=vƥ+ ƨ5NNϑkly7PW{\7^|I`mOK%LooD2Q~aBm{uOi42/lrl4qب);'hgGhurZMs"-KIe iOc)Du02^k$c'?ZYska~j] ʘ% cHIy!qvO;nq&(6Xq_UQl}m5v[Yk{7Z7ޡ|_oMO|=&nt˹QAfC.[loaz=iq;W{wnyNc d_0 2$198ZN>? vף^g)| e}sy{}a~YcS?}"&qFse<ǎ`'|kDښEƺcoƊj1 ﵹ}b9_Eƛ3XfZoz66q  Us6մ7c#Ǩh}̓[ua[ɵ -]7ޡ|_o/%m=s>w%+Tw ֞ob)1ڤ)['nUǁ$ӹkfswneh^?}?H`}=z`S^LDke9ׯ},cs0~F Z3+XM4, &6zmsvX~BAe_^w<ܮu>.ZXW]ގۍQD;v=c+7&˩Y8h%`yTy:m8:Vw;wZ6h}eS(w<Txl`|x9Mm1j˖ϣm煚j $pV _:T^hS9)YN a:FcM{ g6{k[bs}VSS;u32%&+a=yNln\\f]2Fk]S繾"&{}}$vjG5ׅ>3IkBM,MZ6sqKhλp-+YcKnlmye/-b=8Ymvc{zgT;ɮ kSMLVn&Kvj C4wk긺8/|Mk6o:'{hM4?0.SpP!=vK Ho쪟&{8 SeƊ[Iڿ$c5e4>`u.b$IeIMݞ=k4.1oMuMrP}LvH`LQ|lRlԹW|-5Q,skwuiC;rckۘ$sq>2\k\υvצ#[mm׾yoncLU]LUݒ{dX۹&ݷ*yڥY^TY+/Sbn *c gx7J`MWxoa >%Bu2C x84퉒r|qy1kj:!#H`%(O.<\s yt?}znV3֑'4H`] <fvy3 wa'dׅ)ѓL'd7yO.IB>3W&\r7ߞt6~Le*ѡ9t^r;ىJ[ն|mމ~^~:'ϛhlaM$,'JvՌυ/&WY 1;V7% 1 3c]?"i>']F M<8&v|os?#95e#y7ge )Oi%2[$Gc1A$Qi-84=θ#!g[yyx%*te}rX]9jƷ3Bk!.䂰$dq`¯d8d}gc8 t71M>[Sxa<@J` .'עd6!rs0ċdJ4| $5f3e;ܟ̶{VczfIx꓀fw'*MKߦ̣}RŹzSy}]B Xam_SbrN/'7".׿81t*N3C.h}2׌oqٚLL ; j-%F)&%&51y\3NdDɫkWWd|cMUMY|-}MkHDMĈ)&*!)Ӫc$9Xސ,2Wj¡|QV4F5O=>t͓o&a(~] ^3ekdVk6>)&LÜܲ?)M;\<82>hKdL]+ʊ珊g(5 [<1uO9fMS ˓JX cн| 9JǨ;FMϵAs'̙Nbjϣ-*[1rb=>-&l`m-S1'18N}Ϲ'ڷ%zLIBzOEYߟ%.m%DOps̚$[P;4IYk7jλ>%4}beY\6j7GUql\ȉ8OFwYsXLocH<Ͻ?x6Y7) [19`\'4 ΉdUǬIr*[ׯ}1;8$wWQ#Qr{v4eyT3e+BN[6-}dL6B7ZsXL4Dtj֥׈5G1h֪،Wv{*ʊ>/`$%",oNh69fMS>!3~x*L?g޾*kG+^+ Gd#)[dڞ[VL>m1qYֹx~ 3&5kS?#9 $&,p$Id'lcu{kso3=s{}eYr;6`&sY|jsl=Ftي0Y9Ia)ﴶghoR%31N"jymc|y#f|OkOH\ϧcaIk NJGy}1&ɩ maRʡ D?nos<]]f yg\WmM久X$4WDiuf|ʖ΅n׵7N ǝ_7䂰L`}}Eߊ6jyO:l&T7ɶac76]=kݽMFxleU7uԻl?הŒxK<@J`%F i%<,&X޿2smK|_eu18,mr I.i9)oD(Qn|kct. FnT\brAH[Z5k{ubޜYMkCIϏtՔ#)֗%OM%L\.'If*S֎OLOT'zX;>~muf̺'MtQ;/M;OO \,S6Z5[esq(Y|퍉Y]?66ھubPFɹ vɶsS㧌fX[!yVLvu)PXx> u?N) |; L <V&H`C+$! X $+ J+ $+ J+ \}>]tms۞x=dr{8ޒz:>7m9$0&uCt_SEՓ|]c\z]k/d2:=Yx&ߦɹ.G(5]$mIy(z 'xO)u_Sۤ(DcޒMzO(  5퍒_cOm'nA{OӶOm({z Iy(z{Ns4yM.4ik.O407j։zw&O<_I3O \L({'fxVIj3YSύCS|ÇIluض/庶OյK{dܖ ^W][s8O c7}|2&oui/X鸵٘ae_'=kY&q\+5J827H$Jk>rቌˉVio4#U獓g'}}nZ:e'e мC}q7ٽ'u̍ըvz֔o$iʘwXkS:Sy0^IX+ǖ;w ̃Ά!^nI+r_Ncx5'ν\S3W_>%f$8$m𗭲퓟&Ԟw&90cJN[a0,U__mb7u`.ͱ`$iνOGh9Sc%D5)!ͻg2&Kɗ9]OrT$ĝA p6IUNt` 㹺226d>o}Q Ʒio*p_uj.H2/Q2Uxꣾۧq'tX<>𩫗^fx0n['~Bɗ9ͳ= !&O*AgXdq T6ho!l;8"*emU8;:s䙛 p8f%nI'σc3W1w3_e~@J*&W99}uh#uM&'^I]:&zbFYI*Om2FinN۴~}շUk/ϓד8y5+apzN߷52<u}LNw?u5}zͨU1YNjY+ ֍'=|r& 6koտY5UM(rc7m[cZ~x5N^^Rk!m"c5kKn'V]y[^֓/{XSD?ttjm>|=OV\jgyxA[S3FiyjWy2V뫾E Ϝ o4x#9S h$>y_NlYثד(ߓ_Fez'% m(-$_EK'1՝fQT⼃ddr±Ɖndٯԝx$-~SO|5b%{֪.oyb|uUky (>OE äx&%Npz<F5ǝLiO4*x5{]'v5?FO~=%zq{>73 t[TWB5n뽏W%dIc7c}PBF;J6zy?ߤF҉hqRz:v :w֍Q aB^&l;U_4Uwuy s}u9%F RqؙCp>]߭*К 垲 #ݭ|K`mπi.mIvA$qr቟nOK%=)gm{$'wY?wOk{X骓eoI]q]2VrBg&e:|\U&m}՗I`mdKt89[MkX:[mXo}r颏ioFh?in4{SC]d(83ל|l2>nss}+ BbacE?H`pOO>UH`X1J^M<; q垴*y@X>Nz!%]I``WXؕVv%]I``WXؕVv%]I``WXؕVv%]I``WXؕVv%]I``WXؕVv%]I``WXؕVv%]I``WXؕVv%]I``WXؕVv%]I``WXؕVv%]I``WXؕVv%x/|=޿WzH$V9\O.3# U+]i%' zpɟ۟LvI?vlO~N؄$$nM |]xO*m+neRN'}J[$%}>xSRkXsjj|^xnI`+5JR9HLk><ϲ͠=$mX;]{(Q4gu*L`vlGeؘddXS&y /J`H ȚĻwI`$&۳]k!JʜVUu5\vX$d'k3O)'9I`]_/%s8t_H`'5+J'^Χ8N ?ֲ$նz)]XcXx% #8G?&f{Yk7OX'Β O %Mu38 PF:X:eω喭8V$'l3xaf*r9 Oh. 5x(>$ߓz%wzL'}>lBc*i3J`L=De c&v$tִ/lE<϶MkQ\Β]% mbz< ,O%yz<FIzǝLlOj4I#}%&%Rퟨe?05N=GkM<ƾko;Akc6 W%qfB25\Fr8o '9rž ɒ'qFI.ӱK'Z~b^.n(N]i?xX.XؕVv%]I``WXؕVv%]I``WXؕVv%]I``WXؕVv%]I``WXؕVv%]I``WXؕVv%]I``WXؕVv%]I``WXؕVv%]I``WXؕVv%]I``WXؕVv%]I``WXؕVv%]I``WXؕVv%]I``WXؕVv%]I``WXؕVv%]I``WXؕVv%]I``WXؕVv%]I``WXؕVv%]I``WXؕVv%]I``WXؕVv%]I``WX]/Cu$χb~rxw1~|󬘴>iZO$v&MssƱW_I>^Cg>^K+X[e|=N,SrldM)F GF=6Z״֏&Z5'uϫY_s ׍==׽izl7#UI2 exH4f;vm䀤yec7.Hz9g uϯe}Ey?\u9ݖOo__ & |%~ӰOd9^Ϸ^dәhC*6 Gn|u?m|Ԇ ROT?ky kY鄱nDwhb[myI_U:v a3nc6qLܒ ؾ\oz] T%kΫS&XY_LG(}_xv[zXg,5=ܞkՓpV䌾]6S[p/PV}t\lxz,`unu:_/ulw?'u]H[]L26ƨ:[91=z;o87 iuO8T\wq+֫۹Ge9.4f6V}3Q|<̏OkלmƷ:>&#Ul}<Ɣ9/& %-׍~nʝU:ohuyTgUlSWk4PP$~c;sq\ro0NyPO؄^4:FMs6u}#?x~,j=L(NQ <.`mߏG3J wu/39xSphm/:66_[%wӛƛ=묍'F.ѓrͽ䀸qNFS,> 'tMn:Vx9_OGǎ72o7D4kx]acо8q}}]9(7{#7'3eUM{ 慨K1>s^4q{s?z6>QŨX,s}3VWQ8v߿5}ծSOR)9{5um˘K;n4ct,ɿ+9XܘG:YnԜwCX_ޢuc~M{ 15ף\kbnV aSt' ˎ%f$flE&`oi~0q`&UZ xQ2Aa-);!)">w/7_+h`Mm}_Ụظ+_ޒ)YkhSp։ -mdzW'm& bom\-);!c4ϭz*n䈹j];s(o'OǹxicIխ)kNoR韛-yXHsvPu23OnEX-]72M`u0**_{&|>s7ރ& ˩ͽ CcԞ'f;cP߾'r⹕Q\+bu Fx5?Uޢ9xb#ga}^stOYK宻ޚuc~c5M`Ụbb|x/o6V$=U617gjsoA$O69?Wz3/K Uc۾ژeUgjWM{swƳӷS ou! 5}U3F )]}Z(I'g Ʒ:Xs+dVU>OW_sWυrwhoNl/A"D=j`?bm/oXOYE97(7p/onnFf$Wx|*ݮ8t[(_SvBv3bcXUcGε"V[ϝ=7ùf ڵ9Xoy.䶡*h\מT4}?L9;Xl[sF_,V<6ծNh.,MÊd.4unqA{gKQksﯘym\}|vm//^ 1ژOXrrEVxSpmNS8h0]yγ|8^ ھr [(_SvBv- ܪXn_U#oJ<5'~=5Ӿ8vˎ~]c*(tQWsLvR$g)ߥ1js<}|sܚϱ`}^'nt;j.<>zHkc͵'94Z!FUھMl]Q:Gm_q<[(_SvBv+6wkhR<*c:WUX 3 wNaRB3V׷81Guﱽs.;1'͝wMv|ڲۧZcmgS~ܺ\'nO{dkv.coNM@6dM_ZQXt:?ַcƬI`93qio]?Mѓ5jL53k|qn9xun˹k u1*V΁N<-Vޤ)]o*cg,-T99g|\<M`mznݨCk_ЖgѻųMg>Bkbi{>CH2i\ڟgphOC4g1 {g}~_t8]/D%ѓ^HL'3$XzNSt.% Kɩ9k꒮ ߥ4u*Au)M]$T^[%]AV*Q55+w)I`mVc/i꒮ ߥ4UjK|ɫ. ]jX[ɫ. ]H`BSt.XؕVv%]I``WXؕVv%]I``WXؕVv wsNOIENDB`Light.GuardClauses-12.0.0/LICENSE000066400000000000000000000021301470750352700162350ustar00rootroot00000000000000The MIT License (MIT) Copyright (c) 2016 - 2023 Kenny Pflug mailto:kenny.pflug@live.de Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. Light.GuardClauses-12.0.0/Light.GuardClauses.SingleFile.cs000066400000000000000000014602661470750352700232520ustar00rootroot00000000000000/* ------------------------------ Light.GuardClauses 10.3.0 ------------------------------ License information for Light.GuardClauses The MIT License (MIT) Copyright (c) 2016, 2023 Kenny Pflug mailto:kenny.pflug@live.de Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and / or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ using System; using System.Collections; using System.Collections.Generic; using System.Collections.ObjectModel; using System.Diagnostics.CodeAnalysis; using System.Linq; using System.Linq.Expressions; using System.Reflection; using System.Runtime.CompilerServices; using System.Runtime.Serialization; using System.Text; using System.Text.RegularExpressions; using JetBrains.Annotations; using Light.GuardClauses.Exceptions; using Light.GuardClauses.FrameworkExtensions; #nullable enable annotations namespace Light.GuardClauses { ///

/// The class provides access to all assertions of Light.GuardClauses. /// internal static class Check { /// /// Ensures that the specified object reference is not null, or otherwise throws an . /// /// The object reference to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static T MustNotBeNull([ValidatedNotNull, NoEnumeration] this T? parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : class { if (parameter is null) Throw.ArgumentNull(parameterName, message); return parameter; } /// /// Ensures that the specified object reference is not null, or otherwise throws your custom exception. /// /// The reference to be checked. /// The delegate that creates your custom exception. /// Your custom exception thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; exceptionFactory:null => halt")] public static T MustNotBeNull([ValidatedNotNull, NoEnumeration] this T? parameter, Func exceptionFactory) where T : class { if (parameter is null) Throw.CustomException(exceptionFactory); return parameter; } /// /// Ensures that the specified parameter is not the default value, or otherwise throws an /// for reference types, or an for value types. /// /// The value to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is a reference type and null. /// Thrown when is a value type and the default value. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static T MustNotBeDefault([ValidatedNotNull] this T parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (default(T)is null) { if (parameter is null) Throw.ArgumentNull(parameterName, message); return parameter; } if (EqualityComparer.Default.Equals(parameter, default !)) Throw.ArgumentDefault(parameterName, message); return parameter; } /// /// Ensures that the specified parameter is not the default value, or otherwise throws your custom exception. /// /// The value to be checked. /// The delegate that creates your custom exception. /// Your custom exception thrown when is the default value. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; exceptionFactory:null => halt")] public static T MustNotBeDefault([ValidatedNotNull] this T parameter, Func exceptionFactory) { if (default(T)is null) { if (parameter is null) Throw.CustomException(exceptionFactory); return parameter; } if (EqualityComparer.Default.Equals(parameter, default !)) Throw.CustomException(exceptionFactory); return parameter; } /// /// Ensures that the specified parameter is not null when is a reference type, or otherwise /// throws an . PLEASE NOTICE: you should only use this assertion in generic contexts, /// use by default. /// /// The value to be checked for null. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is a reference type and is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static T MustNotBeNullReference([ValidatedNotNull, NoEnumeration] this T parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (default(T) != null) return parameter; if (parameter is null) Throw.ArgumentNull(parameterName, message); return parameter; } /// /// Ensures that the specified parameter is not null when is a reference type, or otherwise /// throws your custom exception. PLEASE NOTICE: you should only use this assertion in generic contexts, /// use by default. /// /// The value to be checked for null. /// The delegate that creates your custom exception. /// Your custom exception thrown when is a reference type and is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; exceptionFactory:null => halt")] public static T MustNotBeNullReference([ValidatedNotNull, NoEnumeration] this T parameter, Func exceptionFactory) { if (default(T) != null) return parameter; if (parameter is null) Throw.CustomException(exceptionFactory); return parameter; } /// /// Ensures that can be cast to and returns the cast value, or otherwise throws a . /// /// The value to be cast. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when cannot be cast to . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static T MustBeOfType([ValidatedNotNull, NoEnumeration] this object? parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.MustNotBeNull(parameterName, message)is T castValue) return castValue; Throw.InvalidTypeCast(parameter, typeof(T), parameterName, message); return default; } /// /// Ensures that can be cast to and returns the cast value, or otherwise throws your custom exception. /// /// The value to be cast. /// The delegate that creates your custom exception. The is passed to this delegate. /// Your custom exception thrown when cannot be cast to . [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; exceptionFactory:null => halt")] public static T MustBeOfType([ValidatedNotNull, NoEnumeration] this object? parameter, Func exceptionFactory) { if (parameter is T castValue) return castValue; Throw.CustomException(exceptionFactory, parameter); return default; } /// /// Checks if the specified value is a valid enum value of its type. This is true when the specified value /// is one of the constants defined in the enum, or a valid flags combination when the enum type is marked /// with the . /// /// The type of the enum. /// The enum value to be checked. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsValidEnumValue(this T parameter) where T : Enum => EnumInfo.IsValidEnumValue(parameter); /// /// Ensures that the specified enum value is valid, or otherwise throws an . An enum value /// is valid when the specified value is one of the constants defined in the enum, or a valid flags combination when the enum type /// is marked with the . /// /// The type of the enum. /// The value to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is no valid enum value. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T MustBeValidEnumValue(this T parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : Enum { if (!EnumInfo.IsValidEnumValue(parameter)) Throw.EnumValueNotDefined(parameter, parameterName, message); return parameter; } /// /// Ensures that the specified enum value is valid, or otherwise throws your custom exception. An enum value /// is valid when the specified value is one of the constants defined in the enum, or a valid flags combination when the enum type /// is marked with the . /// /// The type of the enum. /// The value to be checked. /// The delegate that creates your custom exception. The is passed to this delegate. /// Your custom exception thrown when is no valid enum value, or when is no enum type. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("exceptionFactory:null => halt")] public static T MustBeValidEnumValue(this T parameter, Func exceptionFactory) where T : Enum { if (!EnumInfo.IsValidEnumValue(parameter)) Throw.CustomException(exceptionFactory, parameter); return parameter; } /// /// Checks if the specified GUID is an empty one. /// /// The GUID to be checked. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsEmpty(this Guid parameter) => parameter == Guid.Empty; /// /// Ensures that the specified GUID is not empty, or otherwise throws an . /// /// The GUID to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is an empty GUID. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Guid MustNotBeEmpty(this Guid parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter == Guid.Empty) Throw.EmptyGuid(parameterName, message); return parameter; } /// /// Ensures that the specified GUID is not empty, or otherwise throws your custom exception. /// /// The GUID to be checked. /// The delegate that creates your custom exception. /// Your custom exception thrown when is an empty GUID. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("exceptionFactory:null => halt")] public static Guid MustNotBeEmpty(this Guid parameter, Func exceptionFactory) { if (parameter == Guid.Empty) Throw.CustomException(exceptionFactory); return parameter; } /// /// Checks if the specified is true and throws an in this case. /// /// The condition to be checked. The exception is thrown when it is true. /// The message that will be passed to the (optional). /// Thrown when is true. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static void InvalidOperation(bool condition, string? message = null) { if (condition) Throw.InvalidOperation(message); } /// /// Checks if the specified is true and throws an in this case. /// /// The condition to be checked. The exception is thrown when it is true. /// The message that will be passed to the . /// Thrown when is true. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static void InvalidState(bool condition, string? message = null) { if (condition) Throw.InvalidState(message); } /// /// Checks if the specified is true and throws an in this case. /// /// The condition to be checked. The exception is thrown when it is true. /// The name of the parameter (optional). /// The message that will be passed to the (optional). /// Thrown when is true. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static void InvalidArgument(bool condition, string? parameterName = null, string? message = null) { if (condition) Throw.Argument(parameterName, message); } /// /// Checks if the specified is true and throws your custom exception in this case. /// /// The condition to be checked. The exception is thrown when it is true. /// The delegate that creates your custom exception. /// Your custom exception thrown when is true. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("exceptionFactory:null => halt")] public static void InvalidArgument(bool condition, Func exceptionFactory) { if (condition) Throw.CustomException(exceptionFactory); } /// /// Checks if the specified is true and throws your custom exception in this case. /// /// The condition to be checked. The exception is thrown when it is true. /// The value that is checked in the . This value is passed to the . /// The delegate that creates your custom exception. The is passed to this delegate. /// Your custom exception thrown when is true. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("exceptionFactory:null => halt")] public static void InvalidArgument(bool condition, T parameter, Func exceptionFactory) { if (condition) Throw.CustomException(exceptionFactory, parameter); } /// /// Ensures that the specified nullable has a value and returns it, or otherwise throws a . /// /// The nullable to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when has no value. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T MustHaveValue([NoEnumeration] this T? parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : struct { if (!parameter.HasValue) Throw.NullableHasNoValue(parameterName, message); return parameter.Value; } /// /// Ensures that the specified nullable has a value and returns it, or otherwise throws your custom exception. /// /// The nullable to be checked. /// The delegate that creates your custom exception. /// Thrown when has no value. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("exceptionFactory:null => halt")] public static T MustHaveValue([NoEnumeration] this T? parameter, Func exceptionFactory) where T : struct { if (!parameter.HasValue) Throw.CustomException(exceptionFactory); return parameter.Value; } /// /// Checks if and point to the same object. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] // ReSharper disable StringLiteralTypo [ContractAnnotation("parameter:notNull => true, other:notnull; parameter:notNull => false, other:canbenull; other:notnull => true, parameter:notnull; other:notnull => false, parameter:canbenull")] // ReSharper restore StringLiteralTypo public static bool IsSameAs([NoEnumeration] this T? parameter, [NoEnumeration] T? other) where T : class => ReferenceEquals(parameter, other); /// /// Ensures that and do not point to the same object instance, or otherwise /// throws a . /// /// The first reference to be checked. /// The second reference to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when both and point to the same object. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T? MustNotBeSameAs([NoEnumeration] this T? parameter, [NoEnumeration] T? other, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : class { if (ReferenceEquals(parameter, other)) Throw.SameObjectReference(parameter, parameterName, message); return parameter; } /// /// Ensures that and do not point to the same object instance, or otherwise /// throws your custom exception. /// /// The first reference to be checked. /// The second reference to be checked. /// The delegate that creates your custom exception. is passed to this delegate. /// Thrown when both and point to the same object. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T? MustNotBeSameAs([NoEnumeration] this T? parameter, T? other, Func exceptionFactory) where T : class { if (ReferenceEquals(parameter, other)) Throw.CustomException(exceptionFactory, parameter); return parameter; } /// /// Ensures that is equal to using the default equality comparer, or otherwise throws a . /// /// The first value to be compared. /// The other value to be compared. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when and are not equal. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T MustBe(this T parameter, T other, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (!EqualityComparer.Default.Equals(parameter, other)) Throw.ValuesNotEqual(parameter, other, parameterName, message); return parameter; } /// /// Ensures that is equal to using the default equality comparer, or otherwise throws your custom exception. /// /// The first value to be compared. /// The other value to be compared. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when and are not equal. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T MustBe(this T parameter, T other, Func exceptionFactory) { if (!EqualityComparer.Default.Equals(parameter, other)) Throw.CustomException(exceptionFactory, parameter, other); return parameter; } /// /// Ensures that is equal to using the specified equality comparer, or otherwise throws a . /// /// The first value to be compared. /// The other value to be compared. /// The equality comparer used for comparing the two values. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when and are not equal. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("equalityComparer:null => halt")] public static T MustBe(this T parameter, T other, IEqualityComparer equalityComparer, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (!equalityComparer.MustNotBeNull(nameof(equalityComparer), message).Equals(parameter, other)) Throw.ValuesNotEqual(parameter, other, parameterName, message); return parameter; } /// /// Ensures that is equal to using the specified equality comparer, or otherwise throws your custom exception. /// /// The first value to be compared. /// The other value to be compared. /// The equality comparer used for comparing the two values. /// The delegate that creates your custom exception. , , and are passed to this delegate. /// Your custom exception thrown when and are not equal, or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("equalityComparer:null => halt")] public static T MustBe(this T parameter, T other, IEqualityComparer equalityComparer, Func, Exception> exceptionFactory) { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (equalityComparer is null || !equalityComparer.Equals(parameter, other)) Throw.CustomException(exceptionFactory, parameter, other, equalityComparer!); return parameter; } /// /// Ensures that is not equal to using the default equality comparer, or otherwise throws a . /// /// The first value to be compared. /// The other value to be compared. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when and are equal. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T MustNotBe(this T parameter, T other, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (EqualityComparer.Default.Equals(parameter, other)) Throw.ValuesEqual(parameter, other, parameterName, message); return parameter; } /// /// Ensures that is not equal to using the default equality comparer, or otherwise throws your custom exception. /// /// The first value to be compared. /// The other value to be compared. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when and are equal. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static T MustNotBe(this T parameter, T other, Func exceptionFactory) { if (EqualityComparer.Default.Equals(parameter, other)) Throw.CustomException(exceptionFactory, parameter, other); return parameter; } /// /// Ensures that is not equal to using the specified equality comparer, or otherwise throws a . /// /// The first value to be compared. /// The other value to be compared. /// The equality comparer used for comparing the two values. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when and are equal. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("equalityComparer:null => halt")] public static T MustNotBe(this T parameter, T other, IEqualityComparer equalityComparer, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (equalityComparer.MustNotBeNull(nameof(equalityComparer), message).Equals(parameter, other)) Throw.ValuesEqual(parameter, other, parameterName, message); return parameter; } /// /// Ensures that is not equal to using the specified equality comparer, or otherwise throws your custom exception. /// /// The first value to be compared. /// The other value to be compared. /// The equality comparer used for comparing the two values. /// The delegate that creates your custom exception. , , and are passed to this delegate. /// Your custom exception thrown when and are equal, or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("equalityComparer:null => halt")] public static T MustNotBe(this T parameter, T other, IEqualityComparer equalityComparer, Func, Exception> exceptionFactory) { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (equalityComparer is null || equalityComparer.Equals(parameter, other)) Throw.CustomException(exceptionFactory, parameter, other, equalityComparer!); return parameter; } /// /// Checks if the specified value is approximately the same as the other value, using the given tolerance. /// /// The first value to be compared. /// The second value to be compared. /// The tolerance indicating how much the two values may differ from each other. /// /// True if and are equal or if their absolute difference /// is smaller than the given , otherwise false. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsApproximately(this double value, double other, double tolerance) => Math.Abs(value - other) < tolerance; /// /// Checks if the specified value is approximately the same as the other value, using the default tolerance of 0.0001. /// /// The first value to be compared. /// The second value to be compared. /// /// True if and are equal or if their absolute difference /// is smaller than 0.0001, otherwise false. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsApproximately(this double value, double other) => Math.Abs(value - other) < 0.0001; /// /// Checks if the specified value is approximately the same as the other value, using the given tolerance. /// /// The first value to compare. /// The second value to compare. /// The tolerance indicating how much the two values may differ from each other. /// /// True if and are equal or if their absolute difference /// is smaller than the given , otherwise false. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsApproximately(this float value, float other, float tolerance) => Math.Abs(value - other) < tolerance; /// /// Checks if the specified value is approximately the same as the other value, using the default tolerance of 0.0001f. /// /// The first value to be compared. /// The second value to be compared. /// /// True if and are equal or if their absolute difference /// is smaller than 0.0001f, otherwise false. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsApproximately(this float value, float other) => Math.Abs(value - other) < 0.0001f; /// /// Checks if the specified value is greater than or approximately the same as the other value, using the given tolerance. /// /// The first value to compare. /// The second value to compare. /// The tolerance indicating how much the two values may differ from each other. /// /// True if is greater than or if their absolute difference /// is smaller than the given , otherwise false. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsGreaterThanOrApproximately(this double value, double other, double tolerance) => value > other || value.IsApproximately(other, tolerance); /// /// Checks if the specified value is greater than or approximately the same as the other value, using the default tolerance of 0.0001. /// /// The first value to compare. /// The second value to compare. /// /// True if is greater than or if their absolute difference /// is smaller than 0.0001, otherwise false. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsGreaterThanOrApproximately(this double value, double other) => value > other || value.IsApproximately(other); /// /// Checks if the specified value is greater than or approximately the same as the other value, using the given tolerance. /// /// The first value to compare. /// The second value to compare. /// The tolerance indicating how much the two values may differ from each other. /// /// True if is greater than or if their absolute difference /// is smaller than the given , otherwise false. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsGreaterThanOrApproximately(this float value, float other, float tolerance) => value > other || value.IsApproximately(other, tolerance); /// /// Checks if the specified value is greater than or approximately the same as the other value, using the default tolerance of 0.0001f. /// /// The first value to compare. /// The second value to compare. /// /// True if is greater than or if their absolute difference /// is smaller than 0.0001, otherwise false. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsGreaterThanOrApproximately(this float value, float other) => value > other || value.IsApproximately(other); /// /// Checks if the specified value is less than or approximately the same as the other value, using the given tolerance. /// /// The first value to compare. /// The second value to compare. /// The tolerance indicating how much the two values may differ from each other. /// /// True if is less than or if their absolute difference /// is smaller than the given , otherwise false. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsLessThanOrApproximately(this double value, double other, double tolerance) => value < other || value.IsApproximately(other, tolerance); /// /// Checks if the specified value is less than or approximately the same as the other value, using the default tolerance of 0.0001. /// /// The first value to compare. /// The second value to compare. /// /// True if is less than or if their absolute difference /// is smaller than 0.0001, otherwise false. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsLessThanOrApproximately(this double value, double other) => value < other || value.IsApproximately(other); /// /// Checks if the specified value is less than or approximately the same as the other value, using the given tolerance. /// /// The first value to compare. /// The second value to compare. /// The tolerance indicating how much the two values may differ from each other. /// /// True if is less than or if their absolute difference /// is smaller than the given , otherwise false. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsLessThanOrApproximately(this float value, float other, float tolerance) => value < other || value.IsApproximately(other, tolerance); /// /// Checks if the specified value is less than or approximately the same as the other value, using the default tolerance of 0.0001f. /// /// The first value to compare. /// The second value to compare. /// /// True if is less than or if their absolute difference /// is smaller than 0.0001f, otherwise false. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsLessThanOrApproximately(this float value, float other) => value < other || value.IsApproximately(other); /* * ------------------------------------- * Must Not Be Less Than * Must Be Greater Than or Equal To * ------------------------------------- */ /// /// Ensures that the specified is not less than the given value, or otherwise throws an . /// /// The comparable to be checked. /// The boundary value that must be less than or equal to . /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when the specified is less than . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static T MustNotBeLessThan([ValidatedNotNull] this T parameter, T other, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable { if (parameter.MustNotBeNullReference(parameterName, message).CompareTo(other) < 0) Throw.MustNotBeLessThan(parameter, other, parameterName, message); return parameter; } /// /// Ensures that the specified is not less than the given value, or otherwise throws your custom exception. /// /// The comparable to be checked. /// The boundary value that must be less than or equal to . /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when the specified is less than , or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; exceptionFactory:null => halt")] public static T MustNotBeLessThan([ValidatedNotNull] this T parameter, T other, Func exceptionFactory) where T : IComparable { // ReSharper disable once ConditionIsAlwaysTrueOrFalse - caller might have NRTs turned off if (parameter is null || parameter.CompareTo(other) < 0) Throw.CustomException(exceptionFactory, parameter!, other); return parameter; } /// /// Ensures that the specified is not less than the given value, or otherwise throws an . /// /// The comparable to be checked. /// The boundary value that must be less than or equal to . /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when the specified is less than . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static T MustBeGreaterThanOrEqualTo([ValidatedNotNull] this T parameter, T other, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable { if (parameter.MustNotBeNullReference(parameterName, message).CompareTo(other) < 0) Throw.MustBeGreaterThanOrEqualTo(parameter, other, parameterName, message); return parameter; } /// /// Ensures that the specified is not less than the given value, or otherwise throws your custom exception. /// /// The comparable to be checked. /// The boundary value that must be less than or equal to . /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when the specified is less than , or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; exceptionFactory:null => halt")] public static T MustBeGreaterThanOrEqualTo([ValidatedNotNull] this T parameter, T other, Func exceptionFactory) where T : IComparable { // ReSharper disable once ConditionIsAlwaysTrueOrFalse - caller might have NRTs turned off if (parameter is null || parameter.CompareTo(other) < 0) Throw.CustomException(exceptionFactory, parameter!, other); return parameter; } /* * ------------------------------------- * Must Be Less Than * Must Not Be Greater Than or Equal To * ------------------------------------- */ /// /// Ensures that the specified is less than the given value, or otherwise throws an . /// /// The comparable to be checked. /// The boundary value that must be greater than . /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when the specified is not less than . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static T MustBeLessThan([ValidatedNotNull] this T parameter, T other, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable { if (parameter.MustNotBeNullReference(parameterName, message).CompareTo(other) >= 0) Throw.MustBeLessThan(parameter, other, parameterName, message); return parameter; } /// /// Ensures that the specified is less than the given value, or otherwise throws your custom exception. /// /// The comparable to be checked. /// The boundary value that must be greater than . /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when the specified is not less than , or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; exceptionFactory:null => halt")] public static T MustBeLessThan([ValidatedNotNull] this T parameter, T other, Func exceptionFactory) where T : IComparable { // ReSharper disable once ConditionIsAlwaysTrueOrFalse - caller might have NRTs turned off if (parameter is null || parameter.CompareTo(other) >= 0) Throw.CustomException(exceptionFactory, parameter!, other); return parameter; } /// /// Ensures that the specified is less than the given value, or otherwise throws an . /// /// The comparable to be checked. /// The boundary value that must be greater than . /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when the specified is not less than . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static T MustNotBeGreaterThanOrEqualTo([ValidatedNotNull] this T parameter, T other, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable { if (parameter.MustNotBeNullReference(parameterName, message).CompareTo(other) >= 0) Throw.MustNotBeGreaterThanOrEqualTo(parameter, other, parameterName, message); return parameter; } /// /// Ensures that the specified is less than the given value, or otherwise throws your custom exception. /// /// The comparable to be checked. /// The boundary value that must be greater than . /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when the specified is not less than , or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; exceptionFactory:null => halt")] public static T MustNotBeGreaterThanOrEqualTo([ValidatedNotNull] this T parameter, T other, Func exceptionFactory) where T : IComparable { // ReSharper disable once ConditionIsAlwaysTrueOrFalse - caller might have NRTs turned off if (parameter is null || parameter.CompareTo(other) >= 0) Throw.CustomException(exceptionFactory, parameter!, other); return parameter; } /* * ------------------------------------- * Must Be Greater Than * Must Not Be Less Than or Equal To * ------------------------------------- */ /// /// Ensures that the specified is greater than the given value, or otherwise throws an . /// /// The comparable to be checked. /// The boundary value that must be less than . /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when the specified is less than or equal to . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static T MustBeGreaterThan([ValidatedNotNull] this T parameter, T other, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable { if (parameter.MustNotBeNullReference(parameterName, message).CompareTo(other) <= 0) Throw.MustBeGreaterThan(parameter, other, parameterName, message); return parameter; } /// /// Ensures that the specified is greater than the given value, or otherwise throws your custom exception. /// /// The comparable to be checked. /// The boundary value that must be less than . /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when the specified is less than or equal to , or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; exceptionFactory:null => halt")] public static T MustBeGreaterThan([ValidatedNotNull] this T parameter, T other, Func exceptionFactory) where T : IComparable { // ReSharper disable once ConditionIsAlwaysTrueOrFalse - caller might have NRTs turned off if (parameter is null || parameter.CompareTo(other) <= 0) Throw.CustomException(exceptionFactory, parameter!, other); return parameter; } /// /// Ensures that the specified is greater than the given value, or otherwise throws an . /// /// The comparable to be checked. /// The boundary value that must be less than . /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when the specified is less than or equal to . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static T MustNotBeLessThanOrEqualTo([ValidatedNotNull] this T parameter, T other, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable { if (parameter.MustNotBeNullReference(parameterName, message).CompareTo(other) <= 0) Throw.MustNotBeLessThanOrEqualTo(parameter, other, parameterName, message); return parameter; } /// /// Ensures that the specified is greater than the given value, or otherwise throws your custom exception. /// /// The comparable to be checked. /// The boundary value that must be less than . /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when the specified is less than or equal to , or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; exceptionFactory:null => halt")] public static T MustNotBeLessThanOrEqualTo([ValidatedNotNull] this T parameter, T other, Func exceptionFactory) where T : IComparable { // ReSharper disable once ConditionIsAlwaysTrueOrFalse - caller might have NRTs turned off if (parameter is null || parameter.CompareTo(other) <= 0) Throw.CustomException(exceptionFactory, parameter!, other); return parameter; } /* * ------------------------------------- * Must Not Be Greater Than * Must Be Less Than or Equal To * ------------------------------------- */ /// /// Ensures that the specified is not greater than the given value, or otherwise throws an . /// /// The comparable to be checked. /// The boundary value that must be greater than or equal to . /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when the specified is greater than . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static T MustNotBeGreaterThan([ValidatedNotNull] this T parameter, T other, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable { if (parameter.MustNotBeNullReference(parameterName, message).CompareTo(other) > 0) Throw.MustNotBeGreaterThan(parameter, other, parameterName, message); return parameter; } /// /// Ensures that the specified is not greater than the given value, or otherwise throws your custom exception. /// /// The comparable to be checked. /// The boundary value that must be greater than or equal to . /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when the specified is greater than , or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; exceptionFactory:null => halt")] public static T MustNotBeGreaterThan([ValidatedNotNull] this T parameter, T other, Func exceptionFactory) where T : IComparable { // ReSharper disable once ConditionIsAlwaysTrueOrFalse - caller might have NRTs turned off if (parameter is null || parameter.CompareTo(other) > 0) Throw.CustomException(exceptionFactory, parameter!, other); return parameter; } /// /// Ensures that the specified is not greater than the given value, or otherwise throws an . /// /// The comparable to be checked. /// The boundary value that must be greater than or equal to . /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when the specified is greater than . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static T MustBeLessThanOrEqualTo([ValidatedNotNull] this T parameter, T other, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable { if (parameter.MustNotBeNullReference(parameterName, message).CompareTo(other) > 0) Throw.MustBeLessThanOrEqualTo(parameter, other, parameterName, message); return parameter; } /// /// Ensures that the specified is not greater than the given value, or otherwise throws your custom exception. /// /// The comparable to be checked. /// The boundary value that must be greater than or equal to . /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when the specified is greater than , or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; exceptionFactory:null => halt")] public static T MustBeLessThanOrEqualTo([ValidatedNotNull] this T parameter, T other, Func exceptionFactory) where T : IComparable { // ReSharper disable once ConditionIsAlwaysTrueOrFalse - caller might have NRTs turned off if (parameter is null || parameter.CompareTo(other) > 0) Throw.CustomException(exceptionFactory, parameter!, other); return parameter; } /* * ------------------------------------- * Ranges * ------------------------------------- */ /// /// Checks if the value is within the specified range. /// /// The comparable to be checked. /// The range where must be in-between. /// True if the parameter is within the specified range, else false. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsIn([ValidatedNotNull] this T parameter, Range range) where T : IComparable => range.IsValueWithinRange(parameter); /// /// Checks if the value is not within the specified range. /// /// The comparable to be checked. /// The range where must not be in-between. /// True if the parameter is not within the specified range, else false. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsNotIn([ValidatedNotNull] this T parameter, Range range) where T : IComparable => !range.IsValueWithinRange(parameter); /// /// Ensures that is within the specified range, or otherwise throws an . /// /// The type of the parameter to be checked. /// The parameter to be checked. /// The range where must be in-between. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is not within . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static T MustBeIn([ValidatedNotNull] this T parameter, Range range, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable { if (!range.IsValueWithinRange(parameter.MustNotBeNullReference(parameterName, message))) Throw.MustBeInRange(parameter, range, parameterName, message); return parameter; } /// /// Ensures that is within the specified range, or otherwise throws your custom exception. /// /// The parameter to be checked. /// The range where must be in-between. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when is not within , or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; exceptionFactory:null => halt")] public static T MustBeIn([ValidatedNotNull] this T parameter, Range range, Func, Exception> exceptionFactory) where T : IComparable { // ReSharper disable once ConditionIsAlwaysTrueOrFalse - caller might have NRTs turned off if (parameter is null || !range.IsValueWithinRange(parameter)) Throw.CustomException(exceptionFactory, parameter!, range); return parameter; } /// /// Ensures that is not within the specified range, or otherwise throws an . /// /// The type of the parameter to be checked. /// The parameter to be checked. /// The range where must not be in-between. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is within . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static T MustNotBeIn([ValidatedNotNull] this T parameter, Range range, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable { if (range.IsValueWithinRange(parameter.MustNotBeNullReference(parameterName, message))) Throw.MustNotBeInRange(parameter, range, parameterName, message); return parameter; } /// /// Ensures that is not within the specified range, or otherwise throws your custom exception. /// /// The parameter to be checked. /// The range where must not be in-between. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when is within , or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; exceptionFactory:null => halt")] public static T MustNotBeIn([ValidatedNotNull] this T parameter, Range range, Func, Exception> exceptionFactory) where T : IComparable { // ReSharper disable once ConditionIsAlwaysTrueOrFalse - caller might have NRTs turned off if (parameter is null || range.IsValueWithinRange(parameter)) Throw.CustomException(exceptionFactory, parameter!, range); return parameter; } /// /// Ensures that the specified uses , or otherwise throws an . /// /// The date time to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when does not use . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static DateTime MustBeUtc(this DateTime parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.Kind != DateTimeKind.Utc) Throw.MustBeUtcDateTime(parameter, parameterName, message); return parameter; } /// /// Ensures that the specified uses , or otherwise throws your custom exception. /// /// The date time to be checked. /// The delegate that creates your custom exception. is passed to this delegate. /// Your custom exception thrown when does not use . [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("exceptionFactory:null => halt")] public static DateTime MustBeUtc(this DateTime parameter, Func exceptionFactory) { if (parameter.Kind != DateTimeKind.Utc) Throw.CustomException(exceptionFactory, parameter); return parameter; } /// /// Ensures that the specified uses , or otherwise throws an . /// /// The date time to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when does not use . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static DateTime MustBeLocal(this DateTime parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.Kind != DateTimeKind.Local) Throw.MustBeLocalDateTime(parameter, parameterName, message); return parameter; } /// /// Ensures that the specified uses , or otherwise throws your custom exception. /// /// The date time to be checked. /// The delegate that creates your custom exception. is passed to this delegate. /// Your custom exception thrown when does not use . [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("exceptionFactory:null => halt")] public static DateTime MustBeLocal(this DateTime parameter, Func exceptionFactory) { if (parameter.Kind != DateTimeKind.Local) Throw.CustomException(exceptionFactory, parameter); return parameter; } /// /// Ensures that the specified uses , or otherwise throws an . /// /// The date time to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when does not use . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static DateTime MustBeUnspecified(this DateTime parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.Kind != DateTimeKind.Unspecified) Throw.MustBeUnspecifiedDateTime(parameter, parameterName, message); return parameter; } /// /// Ensures that the specified uses , or otherwise throws your custom exception. /// /// The date time to be checked. /// The delegate that creates your custom exception. is passed to this delegate. /// Your custom exception thrown when does not use . [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("exceptionFactory:null => halt")] public static DateTime MustBeUnspecified(this DateTime parameter, Func exceptionFactory) { if (parameter.Kind != DateTimeKind.Unspecified) Throw.CustomException(exceptionFactory, parameter); return parameter; } /// /// Ensures that the collection has the specified number of items, or otherwise throws an . /// /// The collection to be checked. /// The number of items the collection must have. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when does not have the specified number of items. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static TCollection MustHaveCount([ValidatedNotNull] this TCollection? parameter, int count, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where TCollection : class, IEnumerable { if (parameter!.Count(parameterName, message) != count) Throw.InvalidCollectionCount(parameter!, count, parameterName, message); return parameter!; } /// /// Ensures that the collection has the specified number of items, or otherwise throws your custom exception. /// /// The collection to be checked. /// The number of items the collection must have. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when does not have the specified number of items, or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static TCollection MustHaveCount([ValidatedNotNull] this TCollection? parameter, int count, Func exceptionFactory) where TCollection : class, IEnumerable { if (parameter is null || parameter.Count() != count) Throw.CustomException(exceptionFactory, parameter, count); return parameter; } /// /// Checks if the specified collection is null or empty. /// /// The collection to be checked. /// True if the collection is null or empty, else false. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("=> true, collection:canbenull; => false, collection:notnull")] public static bool IsNullOrEmpty([NotNullWhen(false)] this IEnumerable? collection) => collection is null || collection.Count() == 0; /// /// Ensures that the collection is not null or empty, or otherwise throws an . /// /// The collection to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when has no items. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static TCollection MustNotBeNullOrEmpty([ValidatedNotNull] this TCollection? parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where TCollection : class, IEnumerable { if (parameter.Count(parameterName, message) == 0) Throw.EmptyCollection(parameterName, message); return parameter!; } /// /// Ensures that the collection is not null or empty, or otherwise throws your custom exception. /// /// The collection to be checked. /// The delegate that creates your custom exception. /// Thrown when has no items, or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static TCollection MustNotBeNullOrEmpty([ValidatedNotNull] this TCollection? parameter, Func exceptionFactory) where TCollection : class, IEnumerable { if (parameter is null || parameter.Count() == 0) Throw.CustomException(exceptionFactory, parameter); return parameter; } /// /// Ensures that the collection contains the specified item, or otherwise throws a . /// /// The collection to be checked. /// The item that must be part of the collection. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when does not contain . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static TCollection MustContain([ValidatedNotNull] this TCollection? parameter, TItem item, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where TCollection : class, IEnumerable { if (parameter is ICollection collection) { if (!collection.Contains(item)) Throw.MissingItem(parameter, item, parameterName, message); return parameter; } if (!parameter.MustNotBeNull(parameterName, message).Contains(item)) Throw.MissingItem(parameter!, item, parameterName, message); return parameter!; } /// /// Ensures that the collection contains the specified item, or otherwise throws your custom exception. /// /// The collection to be checked. /// The item that must be part of the collection. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when does not contain , or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static TCollection MustContain([ValidatedNotNull] this TCollection? parameter, TItem item, Func exceptionFactory) where TCollection : class, IEnumerable { if (parameter is ICollection collection) { if (!collection.Contains(item)) Throw.CustomException(exceptionFactory, parameter, item); return parameter; } if (parameter is null || !parameter.Contains(item)) Throw.CustomException(exceptionFactory, parameter, item); return parameter; } /// /// Ensures that the collection does not contain the specified item, or otherwise throws an . /// /// The collection to be checked. /// The item that must not be part of the collection. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when contains . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static TCollection MustNotContain([ValidatedNotNull] this TCollection? parameter, TItem item, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where TCollection : class, IEnumerable { if (parameter is ICollection collection) { if (collection.Contains(item)) Throw.ExistingItem(parameter, item, parameterName, message); return parameter; } if (parameter.MustNotBeNull(parameterName, message).Contains(item)) Throw.ExistingItem(parameter!, item, parameterName, message); return parameter!; } /// /// Ensures that the collection does not contain the specified item, or otherwise throws your custom exception. /// /// The collection to be checked. /// The item that must not be part of the collection. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when contains . [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static TCollection MustNotContain([ValidatedNotNull] this TCollection? parameter, TItem item, Func exceptionFactory) where TCollection : class, IEnumerable { if (parameter is ICollection collection) { if (collection.Contains(item)) Throw.CustomException(exceptionFactory, parameter, item); return parameter; } if (parameter is null || parameter.Contains(item)) Throw.CustomException(exceptionFactory, parameter, item); return parameter; } /// /// Checks if the given is one of the specified . /// /// The item to be checked. /// The collection that might contain the . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("items:null => halt")] public static bool IsOneOf(this TItem item, [ValidatedNotNull] IEnumerable items) { if (items is ICollection collection) return collection.Contains(item); if (items is string @string && item is char character) return @string.IndexOf(character) != -1; return items.MustNotBeNull(nameof(items)).ContainsViaForeach(item); } /// /// Ensures that the value is one of the specified items, or otherwise throws a . /// /// The value to be checked. /// The items that should contain the value. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is not equal to one of the specified . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("items:null => halt")] public static TItem MustBeOneOf(this TItem parameter, [ValidatedNotNull] IEnumerable items, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { // ReSharper disable PossibleMultipleEnumeration if (!parameter.IsOneOf(items.MustNotBeNull(nameof(items), message))) Throw.ValueNotOneOf(parameter, items, parameterName, message); return parameter; // ReSharper restore PossibleMultipleEnumeration } /// /// Ensures that the value is one of the specified items, or otherwise throws your custom exception. /// /// The value to be checked. /// The items that should contain the value. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when is not equal to one of the specified , or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("items:null => halt")] public static TItem MustBeOneOf(this TItem parameter, [ValidatedNotNull] TCollection items, Func exceptionFactory) where TCollection : class, IEnumerable { // ReSharper disable once ConditionIsAlwaysTrueOrFalse - caller might have NRTs turned off if (items is null || !parameter.IsOneOf(items)) Throw.CustomException(exceptionFactory, parameter, items!); return parameter; } /// /// Ensures that the value is not one of the specified items, or otherwise throws a . /// /// The value to be checked. /// The items that must not contain the value. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is equal to one of the specified . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("items:null => halt")] public static TItem MustNotBeOneOf(this TItem parameter, [ValidatedNotNull] IEnumerable items, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { // ReSharper disable PossibleMultipleEnumeration if (parameter.IsOneOf(items.MustNotBeNull(nameof(items), message))) Throw.ValueIsOneOf(parameter, items, parameterName, message); return parameter; // ReSharper restore PossibleMultipleEnumeration } /// /// Ensures that the value is not one of the specified items, or otherwise throws your custom exception. /// /// The value to be checked. /// The items that must not contain the value. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when is equal to one of the specified , or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("items:null => halt")] public static TItem MustNotBeOneOf(this TItem parameter, [ValidatedNotNull] TCollection items, Func exceptionFactory) where TCollection : class, IEnumerable { // ReSharper disable once ConditionIsAlwaysTrueOrFalse - caller might have NRTs turned off if (items is null || parameter.IsOneOf(items)) Throw.CustomException(exceptionFactory, parameter, items!); return parameter; } /// /// Ensures that the collection has at least the specified number of items, or otherwise throws an . /// /// The collection to be checked. /// The number of items the collection should have at least. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when does not contain at least the specified number of items. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static TCollection MustHaveMinimumCount([ValidatedNotNull] this TCollection? parameter, int count, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where TCollection : class, IEnumerable { if (parameter.Count(parameterName, message) < count) Throw.InvalidMinimumCollectionCount(parameter!, count, parameterName, message); return parameter!; } /// /// Ensures that the collection has at least the specified number of items, or otherwise throws your custom exception. /// /// The collection to be checked. /// The number of items the collection should have at least. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when does not contain at least the specified number of items, or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static TCollection MustHaveMinimumCount([ValidatedNotNull] this TCollection? parameter, int count, Func exceptionFactory) where TCollection : class, IEnumerable { if (parameter is null || parameter.Count() < count) Throw.CustomException(exceptionFactory, parameter, count); return parameter; } /// /// Ensures that the collection has at most the specified number of items, or otherwise throws an . /// /// The collection to be checked. /// The number of items the collection should have at most. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when does not contain at most the specified number of items. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static TCollection MustHaveMaximumCount([ValidatedNotNull] this TCollection? parameter, int count, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where TCollection : class, IEnumerable { if (parameter.Count(parameterName, message) > count) Throw.InvalidMaximumCollectionCount(parameter!, count, parameterName, message); return parameter!; } /// /// Ensures that the collection has at most the specified number of items, or otherwise throws your custom exception. /// /// The collection to be checked. /// The number of items the collection should have at most. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when does not contain at most the specified number of items, or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static TCollection MustHaveMaximumCount([ValidatedNotNull] this TCollection? parameter, int count, Func exceptionFactory) where TCollection : class, IEnumerable { if (parameter is null || parameter.Count() > count) Throw.CustomException(exceptionFactory, parameter, count); return parameter; } /// /// Ensures that the span has the specified length, or otherwise throws an . /// /// The span to be checked. /// The length that the span must have. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when does not have the specified length. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Span MustHaveLength(this Span parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.Length != length) Throw.InvalidSpanLength(parameter, length, parameterName, message); return parameter; } /// /// Ensures that the span has the specified length, or otherwise throws your custom exception. /// /// The span to be checked. /// The length that the span must have. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when does not have the specified length. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Span MustHaveLength(this Span parameter, int length, SpanExceptionFactory exceptionFactory) { if (parameter.Length != length) Throw.CustomSpanException(exceptionFactory, parameter, length); return parameter; } /// /// Ensures that the span has the specified length, or otherwise throws your custom exception. /// /// The span to be checked. /// The length that the span must have. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Your custom exception thrown when does not have the specified length. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ReadOnlySpan MustHaveLength(this ReadOnlySpan parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.Length != length) Throw.InvalidSpanLength(parameter, length, parameterName, message); return parameter; } /// /// Ensures that the span has the specified length, or otherwise throws your custom exception. /// /// The span to be checked. /// The length that the span must have. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when does not have the specified length. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ReadOnlySpan MustHaveLength(this ReadOnlySpan parameter, int length, ReadOnlySpanExceptionFactory exceptionFactory) { if (parameter.Length != length) Throw.CustomSpanException(exceptionFactory, parameter, length); return parameter; } /// /// Ensures that the span is longer than the specified length, or otherwise throws an . /// /// The span to be checked. /// The value that the span must be longer than. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is shorter than or equal to . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Span MustBeLongerThan(this Span parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.Length <= length) Throw.SpanMustBeLongerThan(parameter, length, parameterName, message); return parameter; } /// /// Ensures that the span is longer than the specified length, or otherwise throws your custom exception. /// /// The span to be checked. /// The length value that the span must be longer than. /// The delegate that creates your custom exception. and are passed to it. /// Your custom exception thrown when is shorter than or equal to . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Span MustBeLongerThan(this Span parameter, int length, SpanExceptionFactory exceptionFactory) { if (parameter.Length <= length) Throw.CustomSpanException(exceptionFactory, parameter, length); return parameter; } /// /// Ensures that the span is longer than the specified length, or otherwise throws an . /// /// The span to be checked. /// The value that the span must be longer than. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is shorter than or equal to . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ReadOnlySpan MustBeLongerThan(this ReadOnlySpan parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.Length <= length) Throw.SpanMustBeLongerThan(parameter, length, parameterName, message); return parameter; } /// /// Ensures that the span is longer than the specified length, or otherwise throws your custom exception. /// /// The span to be checked. /// The length value that the span must be longer than. /// The delegate that creates your custom exception. and are passed to it. /// Your custom exception thrown when is shorter than or equal to . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ReadOnlySpan MustBeLongerThan(this ReadOnlySpan parameter, int length, ReadOnlySpanExceptionFactory exceptionFactory) { if (parameter.Length <= length) Throw.CustomSpanException(exceptionFactory, parameter, length); return parameter; } /// /// Ensures that the span is longer than or equal to the specified length, or otherwise throws an . /// /// The span to be checked. /// The value that the span must be longer than or equal to. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is shorter than . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Span MustBeLongerThanOrEqualTo(this Span parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.Length < length) Throw.SpanMustBeLongerThanOrEqualTo(parameter, length, parameterName, message); return parameter; } /// /// Ensures that the span is longer than or equal to the specified length, or otherwise throws your custom exception. /// /// The span to be checked. /// The value that the span must be longer than or equal to. /// The delegate that creates your custom exception. and are passed to it. /// Your custom exception thrown when is shorter than . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Span MustBeLongerThanOrEqualTo(this Span parameter, int length, SpanExceptionFactory exceptionFactory) { if (parameter.Length < length) Throw.CustomSpanException(exceptionFactory, parameter, length); return parameter; } /// /// Ensures that the span is longer than or equal to the specified length, or otherwise throws an . /// /// The span to be checked. /// The value that the span must be longer than or equal to. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is shorter than . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ReadOnlySpan MustBeLongerThanOrEqualTo(this ReadOnlySpan parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.Length < length) Throw.SpanMustBeLongerThanOrEqualTo(parameter, length, parameterName, message); return parameter; } /// /// Ensures that the span is longer than or equal to the specified length, or otherwise throws your custom exception. /// /// The span to be checked. /// The value that the span must be longer than or equal to. /// The delegate that creates your custom exception. and are passed to it. /// Your custom exception thrown when is shorter than . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ReadOnlySpan MustBeLongerThanOrEqualTo(this ReadOnlySpan parameter, int length, ReadOnlySpanExceptionFactory exceptionFactory) { if (parameter.Length < length) Throw.CustomSpanException(exceptionFactory, parameter, length); return parameter; } /// /// Ensures that the span is shorter than the specified length, or otherwise throws an . /// /// The span to be checked. /// The length value that the span must be shorter than. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is longer than or equal to . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Span MustBeShorterThan(this Span parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.Length >= length) Throw.SpanMustBeShorterThan(parameter, length, parameterName, message); return parameter; } /// /// Ensures that the span is shorter than the specified length, or otherwise throws your custom exception. /// /// The span to be checked. /// The length value that the span must be shorter than. /// The delegate that creates your custom exception. and are passed to it. /// Your custom exception thrown when is longer than or equal to . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Span MustBeShorterThan(this Span parameter, int length, SpanExceptionFactory exceptionFactory) { if (parameter.Length >= length) Throw.CustomSpanException(exceptionFactory, parameter, length); return parameter; } /// /// Ensures that the span is shorter than the specified length, or otherwise throws an . /// /// The span to be checked. /// The length value that the span must be shorter than. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is longer than or equal to . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ReadOnlySpan MustBeShorterThan(this ReadOnlySpan parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.Length >= length) Throw.SpanMustBeShorterThan(parameter, length, parameterName, message); return parameter; } /// /// Ensures that the span is shorter than the specified length, or otherwise throws your custom exception. /// /// The span to be checked. /// The length value that the span must be shorter than. /// The delegate that creates your custom exception. and are passed to it. /// Your custom exception thrown when is longer than or equal to . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ReadOnlySpan MustBeShorterThan(this ReadOnlySpan parameter, int length, ReadOnlySpanExceptionFactory exceptionFactory) { if (parameter.Length >= length) Throw.CustomSpanException(exceptionFactory, parameter, length); return parameter; } /// /// Ensures that the span is shorter than or equal to the specified length, or otherwise throws an . /// /// The span to be checked. /// The length value that the span must be shorter than or equal to. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is longer than . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Span MustBeShorterThanOrEqualTo(this Span parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.Length > length) Throw.SpanMustBeShorterThanOrEqualTo(parameter, length, parameterName, message); return parameter; } /// /// Ensures that the span is shorter than or equal to the specified length, or otherwise throws your custom exception. /// /// The span to be checked. /// The length value that the span must be shorter than or equal to. /// The delegate that creates your custom exception. and are passed to it. /// Your custom exception thrown when is longer than . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Span MustBeShorterThanOrEqualTo(this Span parameter, int length, SpanExceptionFactory exceptionFactory) { if (parameter.Length > length) Throw.CustomSpanException(exceptionFactory, parameter, length); return parameter; } /// /// Ensures that the span is shorter than or equal to the specified length, or otherwise throws an . /// /// The span to be checked. /// The length value that the span must be shorter than or equal to. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is longer than . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ReadOnlySpan MustBeShorterThanOrEqualTo(this ReadOnlySpan parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.Length > length) Throw.SpanMustBeShorterThanOrEqualTo(parameter, length, parameterName, message); return parameter; } /// /// Ensures that the span is shorter than or equal to the specified length, or otherwise throws your custom exception. /// /// The span to be checked. /// The length value that the span must be shorter than or equal to. /// The delegate that creates your custom exception. and are passed to it. /// Your custom exception thrown when is longer than . [MethodImpl(MethodImplOptions.AggressiveInlining)] public static ReadOnlySpan MustBeShorterThanOrEqualTo(this ReadOnlySpan parameter, int length, ReadOnlySpanExceptionFactory exceptionFactory) { if (parameter.Length > length) Throw.CustomSpanException(exceptionFactory, parameter, length); return parameter; } /// /// Checks if the specified string is null or empty. /// /// The string to be checked. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("=> false, string:notnull; => true, string:canbenull")] public static bool IsNullOrEmpty([NotNullWhen(false)] this string? @string) => string.IsNullOrEmpty(@string); /// /// Ensures that the specified string is not null or empty, or otherwise throws an or . /// /// The string to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is an empty string. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustNotBeNullOrEmpty([ValidatedNotNull] this string? parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter is null) Throw.ArgumentNull(parameterName, message); if (parameter.Length == 0) Throw.EmptyString(parameterName, message); return parameter; } /// /// Ensures that the specified string is not null or empty, or otherwise throws your custom exception. /// /// The string to be checked. /// The delegate that creates your custom exception. is passed to this delegate. /// Your custom exception thrown when is an empty string or null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; exceptionFactory:null => halt")] public static string MustNotBeNullOrEmpty([ValidatedNotNull] this string? parameter, Func exceptionFactory) { if (string.IsNullOrEmpty(parameter)) Throw.CustomException(exceptionFactory, parameter); #if NETSTANDARD2_0 return parameter!; #else return parameter; #endif } /// /// Checks if the specified string is null, empty, or contains only white space. /// /// The string to be checked. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("=> false, string:notnull; => true, string:canbenull")] public static bool IsNullOrWhiteSpace([NotNullWhen(false)] this string? @string) => string.IsNullOrWhiteSpace(@string); /// /// Ensures that the specified string is not null, empty, or contains only white space, or otherwise throws an , an , or a . /// /// The string to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when contains only white space. /// Thrown when is an empty string. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustNotBeNullOrWhiteSpace([ValidatedNotNull] this string? parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { parameter.MustNotBeNullOrEmpty(parameterName, message); foreach (var character in parameter!) { if (!character.IsWhiteSpace()) return parameter; } Throw.WhiteSpaceString(parameter, parameterName, message); return null; } /// /// Ensures that the specified string is not null, empty, or contains only white space, or otherwise throws your custom exception. /// /// The string to be checked. /// The delegate that creates your custom exception. is passed to this delegate. /// Your custom exception thrown when is null, empty, or contains only white space. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; exceptionFactory: null => halt")] public static string MustNotBeNullOrWhiteSpace([ValidatedNotNull] this string? parameter, Func exceptionFactory) { if (parameter.IsNullOrWhiteSpace()) Throw.CustomException(exceptionFactory, parameter); return parameter; } /// /// Checks if the specified character is a white space character. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsWhiteSpace(this char character) => char.IsWhiteSpace(character); /// /// Checks if the specified character is a letter. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsLetter(this char character) => char.IsLetter(character); /// /// Checks if the specified character is a letter or digit. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsLetterOrDigit(this char character) => char.IsLetterOrDigit(character); /// /// Checks if the specified character is a digit. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsDigit(this char character) => char.IsDigit(character); /// /// Ensures that the two strings are equal using the specified , or otherwise throws a . /// /// The first string to be compared. /// The second string to be compared. /// The enum value specifying how the two strings should be compared. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is not equal to . /// Thrown when is not a valid value from the enum. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static string? MustBe(this string? parameter, string? other, StringComparison comparisonType, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (!string.Equals(parameter, other, comparisonType)) Throw.ValuesNotEqual(parameter, other, parameterName, message); return parameter; } /// /// Ensures that the two strings are equal using the specified , or otherwise throws your custom exception. /// /// The first string to be compared. /// The second string to be compared. /// The enum value specifying how the two strings should be compared. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when is not equal to . /// Thrown when is not a valid value from the enum. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static string? MustBe(this string? parameter, string? other, StringComparison comparisonType, Func exceptionFactory) { if (!string.Equals(parameter, other, comparisonType)) Throw.CustomException(exceptionFactory, parameter, other); return parameter; } /// /// Ensures that the two strings are equal using the specified , or otherwise throws a . /// /// The first string to be compared. /// The second string to be compared. /// The enum value specifying how the two strings should be compared. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is not equal to . /// Thrown when is not a valid value from the enum. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static string? MustBe(this string? parameter, string? other, StringComparisonType comparisonType, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (!parameter.Equals(other, comparisonType)) Throw.ValuesNotEqual(parameter, other, parameterName, message); return parameter; } /// /// Ensures that the two strings are equal using the specified , or otherwise throws your custom exception. /// /// The first string to be compared. /// The second string to be compared. /// The enum value specifying how the two strings should be compared. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when is not equal to . /// Thrown when is not a valid value from the enum. public static string? MustBe(this string? parameter, string? other, StringComparisonType comparisonType, Func exceptionFactory) { if (!parameter.Equals(other, comparisonType)) Throw.CustomException(exceptionFactory, parameter, other); return parameter; } /// /// Ensures that the two strings are not equal using the specified , or otherwise throws a . /// /// The first string to be compared. /// The second string to be compared. /// The enum value specifying how the two strings should be compared. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is equal to . /// Thrown when is not a valid value from the enum. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static string? MustNotBe(this string? parameter, string? other, StringComparison comparisonType, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (string.Equals(parameter, other, comparisonType)) Throw.ValuesEqual(parameter, other, parameterName, message); return parameter; } /// /// Ensures that the two strings are not equal using the specified , or otherwise throws your custom exception. /// /// The first string to be compared. /// The second string to be compared. /// The enum value specifying how the two strings should be compared. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when is equal to . /// Thrown when is not a valid value from the enum. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static string? MustNotBe(this string? parameter, string? other, StringComparison comparisonType, Func exceptionFactory) { if (string.Equals(parameter, other, comparisonType)) Throw.CustomException(exceptionFactory, parameter, other); return parameter; } /// /// Ensures that the two strings are not equal using the specified , or otherwise throws a . /// /// The first string to be compared. /// The second string to be compared. /// The enum value specifying how the two strings should be compared. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is equal to . /// Thrown when is not a valid value from the enum. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static string? MustNotBe(this string? parameter, string? other, StringComparisonType comparisonType, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.Equals(other, comparisonType)) Throw.ValuesEqual(parameter, other, parameterName, message); return parameter; } /// /// Ensures that the two strings are not equal using the specified , or otherwise throws your custom exception. /// /// The first string to be compared. /// The second string to be compared. /// The enum value specifying how the two strings should be compared. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when is equal to . /// Thrown when is not a valid value from the enum. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static string? MustNotBe(this string? parameter, string? other, StringComparisonType comparisonType, Func exceptionFactory) { if (parameter.Equals(other, comparisonType)) Throw.CustomException(exceptionFactory, parameter, other); return parameter; } /// /// Ensures that the string matches the specified regular expression, or otherwise throws a . /// /// The string to be checked. /// The regular expression used for pattern matching. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when does not match the specified regular expression. /// Thrown when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; regex:null => halt")] public static string MustMatch([ValidatedNotNull] this string? parameter, Regex regex, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (!regex.MustNotBeNull(nameof(regex), message).IsMatch(parameter.MustNotBeNull(parameterName, message))) Throw.StringDoesNotMatch(parameter!, regex, parameterName, message); return parameter!; } /// /// Ensures that the string matches the specified regular expression, or otherwise throws your custom exception. /// /// The string to be checked. /// The regular expression used for pattern matching. /// The delegate that creates your custom exception. and are passed to this delegate. /// /// Your custom exception thrown when does not match the specified regular expression, /// or when is null, /// or when is null. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static string MustMatch([ValidatedNotNull] this string? parameter, Regex regex, Func exceptionFactory) { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (parameter is null || regex is null || !regex.IsMatch(parameter)) Throw.CustomException(exceptionFactory, parameter, regex!); return parameter; } /// /// Checks if the specified strings are equal, using the given comparison rules. /// /// The first string to compare. /// The second string to compare. /// One of the enumeration values that specifies the rules for the comparison. /// True if the two strings are considered equal, else false. /// Thrown when is no valid enum value. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool Equals(this string? @string, string? value, StringComparisonType comparisonType) { if ((int)comparisonType < 6) return string.Equals(@string, value, (StringComparison)comparisonType); if (comparisonType == StringComparisonType.OrdinalIgnoreWhiteSpace) return @string.EqualsOrdinalIgnoreWhiteSpace(value); if (comparisonType == StringComparisonType.OrdinalIgnoreCaseIgnoreWhiteSpace) return @string.EqualsOrdinalIgnoreCaseIgnoreWhiteSpace(value); Throw.EnumValueNotDefined(comparisonType, nameof(comparisonType)); return false; } /// /// Ensures that the string contains the specified substring, or otherwise throws a . /// /// The string to be checked. /// The substring that must be part of . /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when does not contain . /// Thrown when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustContain([ValidatedNotNull] this string? parameter, string? value, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (!parameter.MustNotBeNull(parameterName, message).Contains(value.MustNotBeNull(nameof(value), message))) Throw.StringDoesNotContain(parameter!, value!, parameterName, message); return parameter!; } /// /// Ensures that the string contains the specified value, or otherwise throws your custom exception. /// /// The string to be checked. /// The substring that must be part of . /// The delegate that creates you custom exception. and are passed to this delegate. /// /// Your custom exception thrown when does not contain , /// or when is null, /// or when is null. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustContain([ValidatedNotNull] this string? parameter, string value, Func exceptionFactory) { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (parameter is null || value is null || !parameter.Contains(value)) Throw.CustomException(exceptionFactory, parameter, value!); return parameter; } /// /// Ensures that the string contains the specified value, or otherwise throws a . /// /// The string to be checked. /// The substring that must be part of . /// One of the enumeration values that specifies the rules for the search. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when does not contain . /// Thrown when or is null. /// Thrown when is not a valid value. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustContain([ValidatedNotNull] this string? parameter, string value, StringComparison comparisonType, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.MustNotBeNull(parameterName, message).IndexOf(value.MustNotBeNull(nameof(value), message), comparisonType) < 0) Throw.StringDoesNotContain(parameter!, value, comparisonType, parameterName, message); return parameter!; } /// /// Ensures that the string contains the specified value, or otherwise throws your custom exception. /// /// The string to be checked. /// The substring that must be part of . /// One of the enumeration values that specifies the rules for the search. /// The delegate that creates you custom exception. , , and are passed to this delegate. /// /// Your custom exception thrown when does not contain , /// or when is null, /// or when is null, /// or when is not a valid value from the enum. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustContain([ValidatedNotNull] this string? parameter, string value, StringComparison comparisonType, Func exceptionFactory) { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (parameter is null || value is null || !comparisonType.IsValidEnumValue() || parameter.IndexOf(value, comparisonType) < 0) Throw.CustomException(exceptionFactory, parameter, value!, comparisonType); return parameter; } /// /// Ensures that the string does not contain the specified value, or otherwise throws a . /// /// The string to be checked. /// The string that must not be part of . /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when contains . /// Thrown when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustNotContain([ValidatedNotNull] this string? parameter, string value, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.MustNotBeNull(parameterName, message).Contains(value.MustNotBeNull(nameof(value), message))) Throw.StringContains(parameter!, value, parameterName, message); return parameter!; } /// /// Ensures that the string does not contain the specified value, or otherwise throws your custom exception. /// /// The string to be checked. /// The string that must not be part of . /// The delegate that creates your custom exception (optional). and are passed to this /// /// Your custom exception thrown when contains , /// or when is null, /// or when is null. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustNotContain([ValidatedNotNull] this string? parameter, string value, Func exceptionFactory) { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (parameter is null || value is null || parameter.Contains(value)) Throw.CustomException(exceptionFactory, parameter, value!); return parameter; } /// /// Ensures that the string does not contain the specified value, or otherwise throws a . /// /// The string to be checked. /// The string that must not be part of . /// One of the enumeration values that specifies the rules for the search. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when contains . /// Thrown when or is null. /// Thrown when is not a valid value. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustNotContain([ValidatedNotNull] this string? parameter, string value, StringComparison comparisonType, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.MustNotBeNull(parameterName, message).IndexOf(value.MustNotBeNull(nameof(value), message), comparisonType) >= 0) Throw.StringContains(parameter!, value, comparisonType, parameterName, message); return parameter!; } /// /// Ensures that the string does not contain the specified value, or otherwise throws your custom exception. /// /// The string to be checked. /// The string that must not be part of . /// One of the enumeration values that specifies the rules for the search. /// The delegate that creates your custom exception (optional). , , and are passed to this delegate. /// /// Your custom exception thrown when contains , /// or when is null, /// or when is null, /// or when is not a valid value of the enum. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustNotContain([ValidatedNotNull] this string? parameter, string value, StringComparison comparisonType, Func exceptionFactory) { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (parameter is null || value is null || !comparisonType.IsValidEnumValue() || parameter.IndexOf(value, comparisonType) >= 0) Throw.CustomException(exceptionFactory, parameter, value!, comparisonType); return parameter; } /// /// Checks if the string contains the specified value using the given comparison type. /// /// The string to be checked. /// The other string. /// One of the enumeration values that specifies the rules for the search. /// True if contains , else false. /// Thrown when or is null. /// Thrown when is not a valid value. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("string:null => halt; value:null => halt")] public static bool Contains([ValidatedNotNull] this string @string, string value, StringComparison comparisonType) => @string.MustNotBeNull(nameof(@string)).IndexOf(value.MustNotBeNull(nameof(value)), comparisonType) >= 0; /// /// Checks if the string is a substring of the other string. /// /// The string to be checked. /// The other string. /// True if is a substring of , else false. /// Thrown when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("value:null => halt; other:null => halt")] public static bool IsSubstringOf([ValidatedNotNull] this string value, [ValidatedNotNull] string other) => other.MustNotBeNull(nameof(other)).Contains(value); /// /// Checks if the string is a substring of the other string. /// /// The string to be checked. /// The other string. /// One of the enumeration values that specifies the rules for the search. /// True if is a substring of , else false. /// Thrown when or is null. /// Thrown when is not a valid value. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("value:null => halt; other:null => halt")] public static bool IsSubstringOf(this string value, string other, StringComparison comparisonType) => other.MustNotBeNull(nameof(other)).IndexOf(value, comparisonType) != -1; /// /// Ensures that the string is a substring of the specified other string, or otherwise throws a . /// /// The string to be checked. /// The other string that must contain . /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when does not contain . /// Thrown when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; value:null => halt")] public static string MustBeSubstringOf([ValidatedNotNull] this string? parameter, string value, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (!value.MustNotBeNull(nameof(value), message).Contains(parameter.MustNotBeNull(parameterName, message))) Throw.NotSubstring(parameter!, value, parameterName, message); return parameter!; } /// /// Ensures that the string is a substring of the specified other string, or otherwise throws your custom exception. /// /// The string to be checked. /// The other string that must contain . /// The delegate that creates your custom exception. and are passed to this delegate. /// /// Your custom exception thrown when does not contain , /// or when is null, /// or when is null. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; value:null => halt")] public static string MustBeSubstringOf([ValidatedNotNull] this string? parameter, string value, Func exceptionFactory) { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (parameter is null || value is null || !value.Contains(parameter)) Throw.CustomException(exceptionFactory, parameter, value!); return parameter; } /// /// Ensures that the string is a substring of the specified other string, or otherwise throws a . /// /// The string to be checked. /// The other string that must contain . /// One of the enumeration values that specifies the rules for the search. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when does not contain . /// Thrown when or is null. /// Thrown when is not a valid value. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; value:null => halt")] public static string MustBeSubstringOf([ValidatedNotNull] this string? parameter, string value, StringComparison comparisonType, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (value.MustNotBeNull(nameof(value), message).IndexOf(parameter.MustNotBeNull(parameterName, message), comparisonType) == -1) Throw.NotSubstring(parameter!, value, comparisonType, parameterName, message); return parameter!; } /// /// Ensures that the string is a substring of the specified other string, or otherwise throws your custom exception. /// /// The string to be checked. /// The other string that must contain . /// One of the enumeration values that specifies the rules for the search. /// The delegate that creates your custom exception. , , and are passed to this delegate. /// /// Your custom exception thrown when does not contain , /// or when is null, /// or when is null, /// or when is not a valid value of the enum. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; value:null => halt")] public static string MustBeSubstringOf([ValidatedNotNull] this string? parameter, string value, StringComparison comparisonType, Func exceptionFactory) { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (parameter is null || value is null || !comparisonType.IsValidEnumValue() || value.IndexOf(parameter, comparisonType) == -1) Throw.CustomException(exceptionFactory, parameter, value!, comparisonType); return parameter; } /// /// Ensures that the string is not a substring of the specified other string, or otherwise throws a . /// /// The string to be checked. /// The other string that must not contain . /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when contains . /// Thrown when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; value:null => halt")] public static string MustNotBeSubstringOf([ValidatedNotNull] this string? parameter, string value, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (value.MustNotBeNull(nameof(value), message).Contains(parameter.MustNotBeNull(parameterName, message))) Throw.Substring(parameter!, value, parameterName, message); return parameter!; } /// /// Ensures that the string is not a substring of the specified other string, or otherwise throws your custom exception. /// /// The string to be checked. /// The other string that must not contain . /// The delegate that creates your custom exception. and are passed to this delegate. /// /// Your custom exception thrown when contains , /// or when is null, /// or when is null. /// /// Thrown when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; value:null => halt")] public static string MustNotBeSubstringOf([ValidatedNotNull] this string? parameter, string value, Func exceptionFactory) { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (parameter is null || value is null || value.Contains(parameter)) Throw.CustomException(exceptionFactory, parameter, value!); return parameter; } /// /// Ensures that the string is not a substring of the specified other string, or otherwise throws a . /// /// The string to be checked. /// The other string that must not contain . /// One of the enumeration values that specifies the rules for the search. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when contains . /// Thrown when or is null. /// Thrown when is not a valid value. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; value:null => halt")] public static string MustNotBeSubstringOf([ValidatedNotNull] this string? parameter, string value, StringComparison comparisonType, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (value.MustNotBeNull(nameof(value), message).IndexOf(parameter.MustNotBeNull(parameterName, message), comparisonType) != -1) Throw.Substring(parameter!, value, comparisonType, parameterName, message); return parameter!; } /// /// Ensures that the string is not a substring of the specified other string, or otherwise throws your custom exception. /// /// The string to be checked. /// The other string that must not contain . /// One of the enumeration values that specifies the rules for the search. /// The delegate that creates your custom exception. and are passed to this delegate. /// /// Your custom exception thrown when contains , /// or when is null, /// or when is null. /// /// Thrown when is not a valid value. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; value:null => halt")] public static string MustNotBeSubstringOf([ValidatedNotNull] this string? parameter, string value, StringComparison comparisonType, Func exceptionFactory) { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (parameter is null || value is null || !comparisonType.IsValidEnumValue() || value.IndexOf(parameter, comparisonType) != -1) Throw.CustomException(exceptionFactory, parameter, value!, comparisonType); return parameter; } /// /// Checks if the specified string is an email address using the default email regular expression /// defined in . /// /// The string to be checked if it is an email address. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("emailAddress:null => false")] public static bool IsEmailAddress([NotNullWhen(true)] this string? emailAddress) => emailAddress != null && RegularExpressions.EmailRegex.IsMatch(emailAddress); /// /// Checks if the specified string is an email address using the provided regular expression for validation. /// /// The string to be checked. /// The regular expression that determines whether the input string is an email address. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("emailAddress:null => false; emailAddressPattern:null => halt")] public static bool IsEmailAddress([NotNullWhen(true)] this string? emailAddress, Regex emailAddressPattern) => emailAddress != null && emailAddressPattern.MustNotBeNull(nameof(emailAddressPattern)).IsMatch(emailAddress); /// /// Ensures that the string is a valid email address using the default email regular expression /// defined in , or otherwise throws an . /// /// The email address that will be validated. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is no valid email address. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeEmailAddress([ValidatedNotNull] this string? parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (!parameter.MustNotBeNull(parameterName, message).IsEmailAddress()) Throw.InvalidEmailAddress(parameter!, parameterName, message); return parameter!; } /// /// Ensures that the string is a valid email address using the default email regular expression /// defined in , or otherwise throws your custom exception. /// /// The email address that will be validated. /// The delegate that creates your custom exception. is passed to this delegate. /// Your custom exception thrown when is null or no valid email address. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeEmailAddress([ValidatedNotNull] this string? parameter, Func exceptionFactory) { if (!parameter.IsEmailAddress()) Throw.CustomException(exceptionFactory, parameter); return parameter; } /// /// Ensures that the string is a valid email address using the provided regular expression, /// or otherwise throws an . /// /// The email address that will be validated. /// The regular expression that determines if the input string is a valid email. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is no valid email address. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; emailAddressPattern:null => halt")] public static string MustBeEmailAddress([ValidatedNotNull] this string? parameter, Regex emailAddressPattern, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (!parameter.MustNotBeNull(parameterName, message).IsEmailAddress(emailAddressPattern)) Throw.InvalidEmailAddress(parameter!, parameterName, message); return parameter!; } /// /// Ensures that the string is a valid email address using the provided regular expression, /// or otherwise throws your custom exception. /// /// The email address that will be validated. /// The regular expression that determines if the input string is a valid email. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when is null or no valid email address. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; emailAddressPattern:null => halt")] public static string MustBeEmailAddress([ValidatedNotNull] this string? parameter, Regex emailAddressPattern, Func exceptionFactory) { // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract - caller might have NRTs turned off if (emailAddressPattern is null || !parameter.IsEmailAddress(emailAddressPattern)) Throw.CustomException(exceptionFactory, parameter, emailAddressPattern!); return parameter; } /// /// Ensures that the string is shorter than the specified length, or otherwise throws a . /// /// The string to be checked. /// The length that the string must be shorter than. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when has a length greater than or equal to . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeShorterThan([ValidatedNotNull] this string? parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.MustNotBeNull(parameterName, message).Length >= length) Throw.StringNotShorterThan(parameter!, length, parameterName, message); return parameter!; } /// /// Ensures that the string is shorter than the specified length, or otherwise throws your custom exception. /// /// The string to be checked. /// The length that the string must be shorter than. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when is null or when it has a length greater than or equal to . [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeShorterThan([ValidatedNotNull] this string? parameter, int length, Func exceptionFactory) { if (parameter is null || parameter.Length >= length) Throw.CustomException(exceptionFactory, parameter, length); return parameter; } /// /// Ensures that the string is shorter than or equal to the specified length, or otherwise throws a . /// /// The string to be checked. /// The length that the string must be shorter than or equal to. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when has a length greater than . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeShorterThanOrEqualTo([ValidatedNotNull] this string? parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.MustNotBeNull(parameterName, message).Length > length) Throw.StringNotShorterThanOrEqualTo(parameter!, length, parameterName, message); return parameter!; } /// /// Ensures that the string is shorter than or equal to the specified length, or otherwise throws your custom exception. /// /// The string to be checked. /// The length that the string must be shorter than or equal to. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when is null or when it has a length greater than . [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeShorterThanOrEqualTo([ValidatedNotNull] this string? parameter, int length, Func exceptionFactory) { if (parameter is null || parameter.Length > length) Throw.CustomException(exceptionFactory, parameter, length); return parameter; } /// /// Ensures that the string has the specified length, or otherwise throws a . /// /// The string to be checked. /// The asserted length of the string. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when has a length different than . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustHaveLength([ValidatedNotNull] this string? parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.MustNotBeNull(parameterName, message).Length != length) Throw.StringLengthNotEqualTo(parameter!, length, parameterName, message); return parameter!; } /// /// Ensures that the string has the specified length, or otherwise throws your custom exception. /// /// The string to be checked. /// The asserted length of the string. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when is null or when it has a length different than . [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustHaveLength([ValidatedNotNull] this string? parameter, int length, Func exceptionFactory) { if (parameter is null || parameter.Length != length) Throw.CustomException(exceptionFactory, parameter, length); return parameter; } /// /// Ensures that the string is longer than the specified length, or otherwise throws a . /// /// The string to be checked. /// The length that the string must be longer than. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when has a length shorter than or equal to . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeLongerThan([ValidatedNotNull] this string? parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.MustNotBeNull(parameterName, message).Length <= length) Throw.StringNotLongerThan(parameter!, length, parameterName, message); return parameter!; } /// /// Ensures that the string is longer than the specified length, or otherwise throws your custom exception. /// /// The string to be checked. /// The length that the string must be longer than. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when is null or when it has a length shorter than or equal to . [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeLongerThan([ValidatedNotNull] this string? parameter, int length, Func exceptionFactory) { if (parameter is null || parameter.Length <= length) Throw.CustomException(exceptionFactory, parameter, length); return parameter; } /// /// Ensures that the string is longer than or equal to the specified length, or otherwise throws a . /// /// The string to be checked. /// The length that the string must be longer than or equal to. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when has a length shorter than . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeLongerThanOrEqualTo([ValidatedNotNull] this string? parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.MustNotBeNull(parameterName, message).Length < length) Throw.StringNotLongerThanOrEqualTo(parameter!, length, parameterName, message); return parameter!; } /// /// Ensures that the string is longer than or equal to the specified length, or otherwise throws your custom exception. /// /// The string to be checked. /// The length that the string must be longer than or equal to. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when is null or when it has a length shorter than . [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeLongerThanOrEqualTo([ValidatedNotNull] this string? parameter, int length, Func exceptionFactory) { if (parameter is null || parameter.Length < length) Throw.CustomException(exceptionFactory, parameter, length); return parameter; } /// /// Ensures that the string's length is within the specified range, or otherwise throws a . /// /// The string to be checked. /// The range where the string's length must be in-between. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when the length of is not with the specified . /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustHaveLengthIn([ValidatedNotNull] this string? parameter, Range range, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (!range.IsValueWithinRange(parameter.MustNotBeNull(parameterName, message).Length)) Throw.StringLengthNotInRange(parameter!, range, parameterName, message); return parameter!; } /// /// Ensures that the string's length is within the specified range, or otherwise throws your custom exception. /// /// The string to be checked. /// The range where the string's length must be in-between. /// The delegate that creates your custom exception. and are passed to this delegate. /// Your custom exception thrown when is null or its length is not within the specified range. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustHaveLengthIn([ValidatedNotNull] this string? parameter, Range range, Func, Exception> exceptionFactory) { if (parameter is null || !range.IsValueWithinRange(parameter.Length)) Throw.CustomException(exceptionFactory, parameter, range); return parameter; } /// /// Checks if the string is either "\n" or "\r\n". This is done independently of the current value of . /// /// The string to be checked. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("=> false, parameter:canbenull; => true, parameter:notnull")] public static bool IsNewLine([NotNullWhen(true)] this string? parameter) => parameter == "\n" || parameter == "\r\n"; /// /// Ensures that the string is either "\n" or "\r\n", or otherwise throws a . This is done independently of the current value of . /// /// The string to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is not equal to "\n" or "\r\n". /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeNewLine([ValidatedNotNull] this string? parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (!parameter.MustNotBeNull(parameterName, message).IsNewLine()) Throw.NotNewLine(parameter!, parameterName, message); return parameter!; } /// /// Ensures that the string is either "\n" or "\r\n", or otherwise throws your custom exception. This is done independently of the current value of . /// /// The string to be checked. /// The delegate that creates your custom exception. is passed to this delegate. /// Your custom exception thrown when is not equal to "\n" or "\r\n". [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeNewLine([ValidatedNotNull] this string? parameter, Func exceptionFactory) { if (!parameter.IsNewLine()) Throw.CustomException(exceptionFactory, parameter); return parameter; } /// /// Checks if the specified string is trimmed, i.e. it does not start or end with /// white space characters. Inputting an empty string will return true. When null is passed, /// you can control the return value with which will /// return true by default. /// /// The string to be checked. /// /// The value indicating whether true or false should be returned from this method when the /// is null. The default value is true. /// /// /// True if the is trimmed, else false. An empty string will result in true. /// You can control the return value with when the /// is null. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsTrimmed(this string? parameter, bool regardNullAsTrimmed = true) => parameter is null ? regardNullAsTrimmed : parameter.AsSpan().IsTrimmed(); /// /// Checks if the specified character span is trimmed, i.e. it does not start or end with /// white space characters. Inputting an empty span will return true. /// /// The character span to be checked. /// True if the is trimmed, else false. An empty span will result in true. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsTrimmed(this ReadOnlySpan parameter) => parameter.Length == 0 || !parameter[0].IsWhiteSpace() && !parameter[parameter.Length - 1].IsWhiteSpace(); /// /// Ensures that the string is not null and trimmed, or otherwise throws a . /// Empty strings are regarded as trimmed. /// /// The string to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// /// Thrown when is not trimmed, i.e. they start or end with white space characters. /// Empty strings are regarded as trimmed. /// /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeTrimmed([ValidatedNotNull] this string? parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (!parameter.MustNotBeNull(parameterName, message).IsTrimmed()) Throw.NotTrimmed(parameter, parameterName, message); return parameter!; } /// /// Ensures that the string is not null and trimmed, or otherwise throws your custom exception. /// Empty strings are regarded as trimmed. /// /// The string to be checked. /// The delegate that creates your custom exception. is passed to this delegate. /// Your custom exception thrown when is null or not trimmed. Empty strings are regarded as trimmed. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeTrimmed([ValidatedNotNull] this string? parameter, Func exceptionFactory) { if (!parameter.IsTrimmed(regardNullAsTrimmed: false)) Throw.CustomException(exceptionFactory, parameter); return parameter!; } /// /// Checks if the specified string is trimmed at the start, i.e. it does not start with /// white space characters. Inputting an empty string will return true. /// /// The string to be checked. /// /// The value indicating whether true or false should be returned from this method when the /// is null. The default value is true. /// /// /// True if the is trimmed at the start, else false. /// An empty string will result in true. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsTrimmedAtStart(this string? parameter, bool regardNullAsTrimmed = true) => parameter is null ? regardNullAsTrimmed : parameter.AsSpan().IsTrimmedAtStart(); /// /// Checks if the specified character span is trimmed at the start, i.e. it does not start with /// white space characters. Inputting an empty span will return true. /// /// The character span to be checked. /// /// True if the is trimmed at the start, else false. /// An empty span will result in true. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsTrimmedAtStart(this ReadOnlySpan parameter) => parameter.Length == 0 || !parameter[0].IsWhiteSpace(); /// /// Ensures that the string is not null and trimmed at the start, or otherwise throws a . /// Empty strings are regarded as trimmed. /// /// The string to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// /// Thrown when is not trimmed at the start, i.e. they start with white space characters. /// Empty strings are regarded as trimmed. /// /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeTrimmedAtStart([ValidatedNotNull] this string? parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (!parameter.MustNotBeNull(parameterName, message).IsTrimmedAtStart()) Throw.NotTrimmedAtStart(parameter, parameterName, message); return parameter!; } /// /// Ensures that the string is not null and trimmed at the start, or otherwise throws your custom exception. /// Empty strings are regarded as trimmed. /// /// The string to be checked. /// The delegate that creates your custom exception. is passed to this delegate. /// Your custom exception thrown when is null or not trimmed at the start. Empty strings are regarded as trimmed. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeTrimmedAtStart([ValidatedNotNull] this string? parameter, Func exceptionFactory) { if (!parameter.IsTrimmedAtStart(regardNullAsTrimmed: false)) Throw.CustomException(exceptionFactory, parameter); return parameter!; } /// /// Checks if the specified string is trimmed at the end, i.e. it does not end with /// white space characters. Inputting an empty string will return true. /// /// The string to be checked. /// /// The value indicating whether true or false should be returned from this method when the /// is null. The default value is true. /// /// /// True if the is trimmed at the start, else false. /// An empty string will result in true. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsTrimmedAtEnd(this string? parameter, bool regardNullAsTrimmed = true) => parameter is null ? regardNullAsTrimmed : parameter.AsSpan().IsTrimmedAtEnd(); /// /// Checks if the specified character span is trimmed at the end, i.e. it does not end with /// white space characters. Inputting an empty span will return true. /// /// The character span to be checked. /// /// True if the is trimmed at the end, else false. /// An empty span will result in true. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsTrimmedAtEnd(this ReadOnlySpan parameter) => parameter.Length == 0 || !parameter[parameter.Length - 1].IsWhiteSpace(); /// /// Ensures that the string is not null and trimmed at the end, or otherwise throws a . /// Empty strings are regarded as trimmed. /// /// The string to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// /// Thrown when is not trimmed at the end, i.e. they end with white space characters. /// Empty strings are regarded as trimmed. /// /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeTrimmedAtEnd([ValidatedNotNull] this string? parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (!parameter.MustNotBeNull(parameterName, message).IsTrimmedAtEnd()) Throw.NotTrimmedAtEnd(parameter, parameterName, message); return parameter!; } /// /// Ensures that the string is not null and trimmed at the end, or otherwise throws your custom exception. /// Empty strings are regarded as trimmed. /// /// The string to be checked. /// The delegate that creates your custom exception. is passed to this delegate. /// Your custom exception thrown when is null or not trimmed at the end. Empty strings are regarded as trimmed. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static string MustBeTrimmedAtEnd([ValidatedNotNull] this string? parameter, Func exceptionFactory) { if (!parameter.IsTrimmedAtEnd(regardNullAsTrimmed: false)) Throw.CustomException(exceptionFactory, parameter); return parameter!; } /// /// Checks if the two specified types are equivalent. This is true when both types are equal or /// when one type is a constructed generic type and the other type is the corresponding generic type definition. /// /// The first type to be checked. /// The other type to be checked. /// /// True if both types are null, or if both are equal, or if one type /// is a constructed generic type and the other one is the corresponding generic type definition, else false. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsEquivalentTypeTo(this Type? type, Type? other) => ReferenceEquals(type, other) || !(type is null) && !(other is null) && (type == other || type.IsConstructedGenericType != other.IsConstructedGenericType && CheckTypeEquivalency(type, other)); private static bool CheckTypeEquivalency(Type type, Type other) { if (type.IsConstructedGenericType) return type.GetGenericTypeDefinition() == other; return other.GetGenericTypeDefinition() == type; } /// /// Checks if the type implements the specified interface type. Internally, this method uses /// so that constructed generic types and their corresponding generic type definitions are regarded as equal. /// /// The type to be checked. /// The interface type that should implement. /// Thrown when or is null. [ContractAnnotation("type:null => halt; interfaceType:null => halt")] public static bool Implements([ValidatedNotNull] this Type type, [ValidatedNotNull] Type interfaceType) { interfaceType.MustNotBeNull(nameof(interfaceType)); var implementedInterfaces = type.MustNotBeNull(nameof(type)).GetInterfaces(); for (var i = 0; i < implementedInterfaces.Length; ++i) { if (interfaceType.IsEquivalentTypeTo(implementedInterfaces[i])) return true; } return false; } /// /// Checks if the type implements the specified interface type. This overload uses the specified /// to compare the interface types. /// /// The type to be checked. /// The interface type that should implement. /// The equality comparer used to compare the interface types. /// Thrown when , or , or is null. [ContractAnnotation("type:null => halt; interfaceType:null => halt; typeComparer:null => halt")] public static bool Implements([ValidatedNotNull] this Type type, [ValidatedNotNull] Type interfaceType, [ValidatedNotNull] IEqualityComparer typeComparer) { interfaceType.MustNotBeNull(nameof(interfaceType)); typeComparer.MustNotBeNull(nameof(typeComparer)); var implementedInterfaces = type.MustNotBeNull(nameof(type)).GetInterfaces(); for (var i = 0; i < implementedInterfaces.Length; ++i) { if (typeComparer.Equals(implementedInterfaces[i], interfaceType)) return true; } return false; } /// /// Checks if the given is equal to the specified or if it implements it. Internally, this /// method uses so that constructed generic types and their corresponding generic type definitions are regarded as equal. /// /// The type to be checked. /// The type that is equivalent to or the interface type that implements. /// Thrown when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("type:null => halt; otherType:null => halt")] public static bool IsOrImplements([ValidatedNotNull] this Type type, [ValidatedNotNull] Type otherType) => type.IsEquivalentTypeTo(otherType.MustNotBeNull(nameof(otherType))) || type.Implements(otherType); /// /// Checks if the given is equal to the specified or if it implements it. This overload uses the specified /// to compare the types. /// /// , /// The type to be checked. /// The type that is equivalent to or the interface type that implements. /// The equality comparer used to compare the interface types. /// Thrown when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("type:null => halt; otherType:null => halt")] public static bool IsOrImplements([ValidatedNotNull] this Type type, [ValidatedNotNull] Type otherType, [ValidatedNotNull] IEqualityComparer typeComparer) => typeComparer.MustNotBeNull(nameof(typeComparer)).Equals(type.MustNotBeNull(nameof(type)), otherType.MustNotBeNull(nameof(otherType))) || type.Implements(otherType, typeComparer); /// /// Checks if the specified type derives from the other type. Internally, this method uses /// by default so that constructed generic types and their corresponding generic type definitions are regarded as equal. /// /// The type info to be checked. /// The base class that should derive from. /// Thrown when or is null. [ContractAnnotation("type:null => halt; baseClass:null => halt")] public static bool DerivesFrom([ValidatedNotNull] this Type type, [ValidatedNotNull] Type baseClass) { baseClass.MustNotBeNull(nameof(baseClass)); var currentBaseType = type.MustNotBeNull(nameof(type)).BaseType; while (currentBaseType != null) { if (currentBaseType.IsEquivalentTypeTo(baseClass)) return true; currentBaseType = currentBaseType.BaseType; } return false; } /// /// Checks if the specified type derives from the other type. This overload uses the specified /// to compare the types. /// /// The type info to be checked. /// The base class that should derive from. /// The equality comparer used to compare the types. /// Thrown when , or , or is null. [ContractAnnotation("type:null => halt; baseClass:null => halt; typeComparer:null => halt")] public static bool DerivesFrom([ValidatedNotNull] this Type type, [ValidatedNotNull] Type baseClass, [ValidatedNotNull] IEqualityComparer typeComparer) { baseClass.MustNotBeNull(nameof(baseClass)); typeComparer.MustNotBeNull(nameof(typeComparer)); var currentBaseType = type.MustNotBeNull(nameof(type)).BaseType; while (currentBaseType != null) { if (typeComparer.Equals(currentBaseType, baseClass)) return true; currentBaseType = currentBaseType.BaseType; } return false; } /// /// Checks if the given is equal to the specified or if it derives from it. Internally, this /// method uses so that constructed generic types and their corresponding generic type definitions are regarded as equal. /// /// The type to be checked. /// The type that is equivalent to or the base class type where derives from. /// Thrown when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("type:null => halt; otherType:null => halt")] public static bool IsOrDerivesFrom([ValidatedNotNull] this Type type, [ValidatedNotNull] Type otherType) => type.IsEquivalentTypeTo(otherType.MustNotBeNull(nameof(otherType))) || type.DerivesFrom(otherType); /// /// Checks if the given is equal to the specified or if it derives from it. This overload uses the specified /// to compare the types. /// /// The type to be checked. /// The type that is equivalent to or the base class type where derives from. /// The equality comparer used to compare the types. /// Thrown when , or , or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("type:null => halt; otherType:null => halt; typeComparer:null => halt")] public static bool IsOrDerivesFrom([ValidatedNotNull] this Type type, [ValidatedNotNull] Type otherType, [ValidatedNotNull] IEqualityComparer typeComparer) => typeComparer.MustNotBeNull(nameof(typeComparer)).Equals(type, otherType.MustNotBeNull(nameof(otherType))) || type.DerivesFrom(otherType, typeComparer); /// /// Checks if the given type derives from the specified base class or interface type. Internally, this method uses /// so that constructed generic types and their corresponding generic type definitions are regarded as equal. /// /// The type to be checked. /// The type describing an interface or base class that should derive from or implement. /// Thrown when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("type:null => halt; baseClassOrInterfaceType:null => halt")] public static bool InheritsFrom([ValidatedNotNull] this Type type, [ValidatedNotNull] Type baseClassOrInterfaceType) => baseClassOrInterfaceType.MustNotBeNull(nameof(baseClassOrInterfaceType)).IsInterface ? type.Implements(baseClassOrInterfaceType) : type.DerivesFrom(baseClassOrInterfaceType); /// /// Checks if the given type derives from the specified base class or interface type. This overload uses the specified /// to compare the types. /// /// The type to be checked. /// The type describing an interface or base class that should derive from or implement. /// The equality comparer used to compare the types. /// Thrown when , or , or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("type:null => halt; baseClassOrInterfaceType:null => halt; typeComparer:null => halt")] public static bool InheritsFrom([ValidatedNotNull] this Type type, [ValidatedNotNull] Type baseClassOrInterfaceType, [ValidatedNotNull] IEqualityComparer typeComparer) => baseClassOrInterfaceType.MustNotBeNull(nameof(baseClassOrInterfaceType)).IsInterface ? type.Implements(baseClassOrInterfaceType, typeComparer) : type.DerivesFrom(baseClassOrInterfaceType, typeComparer); /// /// Checks if the given is equal to the specified or if it derives from it or implements it. /// Internally, this method uses so that constructed generic types and their corresponding generic type definitions /// are regarded as equal. /// /// The type to be checked. /// The type that is equivalent to or the base class type where derives from. /// Thrown when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("type:null => halt; otherType:null => halt")] public static bool IsOrInheritsFrom([ValidatedNotNull] this Type type, [ValidatedNotNull] Type otherType) => type.IsEquivalentTypeTo(otherType.MustNotBeNull(nameof(otherType))) || type.InheritsFrom(otherType); /// /// Checks if the given is equal to the specified or if it derives from it or implements it. /// This overload uses the specified to compare the types. /// /// The type to be checked. /// The type that is equivalent to or the base class type where derives from. /// The equality comparer used to compare the types. /// Thrown when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("type:null => halt; otherType:null => halt; typeComparer:null => halt")] public static bool IsOrInheritsFrom([ValidatedNotNull] this Type type, [ValidatedNotNull] Type otherType, [ValidatedNotNull] IEqualityComparer typeComparer) => typeComparer.MustNotBeNull(nameof(typeComparer)).Equals(type, otherType.MustNotBeNull(nameof(otherType))) || type.InheritsFrom(otherType, typeComparer); /// /// Checks if the given is a generic type that has open generic parameters, /// but is no generic type definition. /// /// The type to be checked. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("type:null => halt")] public static bool IsOpenConstructedGenericType([ValidatedNotNull] this Type type) => type.MustNotBeNull(nameof(type)).IsGenericType && type.ContainsGenericParameters && type.IsGenericTypeDefinition == false; /// /// Ensures that the specified URI is an absolute one, or otherwise throws a . /// /// The URI to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is not an absolute URI. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static Uri MustBeAbsoluteUri([ValidatedNotNull] this Uri? parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.MustNotBeNull(parameterName, message).IsAbsoluteUri == false) Throw.MustBeAbsoluteUri(parameter!, parameterName, message); return parameter!; } /// /// Ensures that the specified URI is an absolute one, or otherwise throws your custom exception. /// /// The URI to be checked. /// The delegate that creates the exception to be thrown. is passed to this delegate. /// Your custom exception thrown when is not an absolute URI, or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static Uri MustBeAbsoluteUri([ValidatedNotNull] this Uri? parameter, Func exceptionFactory) { if (parameter is null || parameter.IsAbsoluteUri == false) Throw.CustomException(exceptionFactory, parameter); return parameter; } /// /// Ensures that the specified URI is a relative one, or otherwise throws an . /// /// The URI to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when is an absolute URI. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static Uri MustBeRelativeUri([ValidatedNotNull] this Uri? parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.MustNotBeNull(parameterName, message).IsAbsoluteUri) Throw.MustBeRelativeUri(parameter!, parameterName, message); return parameter!; } /// /// Ensures that the specified URI is a relative one, or otherwise throws your custom exception. /// /// The URI to be checked. /// The delegate that creates your custom exception. is passed to this delegate. /// Your custom exception thrown when is an absolute URI, or when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static Uri MustBeRelativeUri([ValidatedNotNull] this Uri? parameter, Func exceptionFactory) { if (parameter is null || parameter.IsAbsoluteUri) Throw.CustomException(exceptionFactory, parameter); return parameter; } /// /// Ensures that the has the specified scheme, or otherwise throws an . /// /// The URI to be checked. /// The scheme that the URI should have. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when uses a different scheme than the specified one. /// Thrown when is relative and thus has no scheme. /// Throw when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static Uri MustHaveScheme([ValidatedNotNull] this Uri? parameter, string scheme, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (string.Equals(parameter.MustBeAbsoluteUri(parameterName, message).Scheme, scheme) == false) Throw.UriMustHaveScheme(parameter!, scheme, parameterName, message); return parameter!; } /// /// Ensures that the has the specified scheme, or otherwise throws your custom exception. /// /// The URI to be checked. /// The scheme that the URI should have. /// The delegate that creates the exception to be thrown. is passed to this delegate. /// /// Your custom exception thrown when uses a different scheme than the specified one, /// or when is a relative URI, /// or when is null. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static Uri MustHaveScheme([ValidatedNotNull] this Uri? parameter, string scheme, Func exceptionFactory) { if (string.Equals(parameter.MustBeAbsoluteUri(exceptionFactory).Scheme, scheme) == false) Throw.CustomException(exceptionFactory, parameter); return parameter!; } /// /// Ensures that the has the specified scheme, or otherwise throws your custom exception. /// /// The URI to be checked. /// The scheme that the URI should have. /// The delegate that creates the exception to be thrown. and are passed to this delegate. /// /// Your custom exception thrown when uses a different scheme than the specified one, /// or when is a relative URI, /// or when is null. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static Uri MustHaveScheme([ValidatedNotNull] this Uri? parameter, string scheme, Func exceptionFactory) { if (parameter is null || !parameter.IsAbsoluteUri || parameter.Scheme.Equals(scheme) == false) Throw.CustomException(exceptionFactory, parameter, scheme); return parameter; } /// /// Ensures that the specified URI has the "https" scheme, or otherwise throws an . /// /// The URI to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when uses a different scheme than "https". /// Thrown when is relative and thus has no scheme. /// Throw when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static Uri MustBeHttpsUrl([ValidatedNotNull] this Uri? parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => parameter.MustHaveScheme("https", parameterName, message); /// /// Ensures that the specified URI has the "https" scheme, or otherwise throws your custom exception. /// /// The URI to be checked. /// The delegate that creates the exception to be thrown. is passed to this delegate. /// /// Your custom exception thrown when uses a different scheme than "https", /// or when is a relative URI, /// or when is null. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static Uri MustBeHttpsUrl([ValidatedNotNull] this Uri? parameter, Func exceptionFactory) => parameter.MustHaveScheme("https", exceptionFactory); /// /// Ensures that the specified URI has the "http" scheme, or otherwise throws an . /// /// The URI to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when uses a different scheme than "http". /// Thrown when is relative and thus has no scheme. /// Throw when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static Uri MustBeHttpUrl([ValidatedNotNull] this Uri? parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => parameter.MustHaveScheme("http", parameterName, message); /// /// Ensures that the specified URI has the "http" scheme, or otherwise throws your custom exception. /// /// The URI to be checked. /// The delegate that creates the exception to be thrown. is passed to this delegate. /// /// Your custom exception thrown when uses a different scheme than "http", /// or when is a relative URI, /// or when is null. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static Uri MustBeHttpUrl([ValidatedNotNull] this Uri? parameter, Func exceptionFactory) => parameter.MustHaveScheme("http", exceptionFactory); /// /// Ensures that the specified URI has the "http" or "https" scheme, or otherwise throws an . /// /// The URI to be checked. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when uses a different scheme than "http" or "https". /// Thrown when is relative and thus has no scheme. /// Throw when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static Uri MustBeHttpOrHttpsUrl([ValidatedNotNull] this Uri? parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { if (parameter.MustBeAbsoluteUri(parameterName, message).Scheme.Equals("https") == false && parameter!.Scheme.Equals("http") == false) Throw.UriMustHaveOneSchemeOf(parameter, new[] { "https", "http" }, parameterName, message); return parameter!; } /// /// Ensures that the specified URI has the "http" or "https" scheme, or otherwise throws your custom exception. /// /// The URI to be checked. /// The delegate that creates the exception to be thrown. is passed to this delegate. /// /// Your custom exception thrown when uses a different scheme than "http" or "https", /// or when is a relative URI, /// or when is null. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static Uri MustBeHttpOrHttpsUrl([ValidatedNotNull] this Uri? parameter, Func exceptionFactory) { if (parameter.MustBeAbsoluteUri(exceptionFactory).Scheme.Equals("https") == false && parameter!.Scheme.Equals("http") == false) Throw.CustomException(exceptionFactory, parameter); return parameter!; } /// /// Ensures that the URI has one of the specified schemes, or otherwise throws an . /// /// The URI to be checked. /// One of these strings must be equal to the scheme of the URI. /// The name of the parameter (optional). /// The message that will be passed to the resulting exception (optional). /// Thrown when the scheme is not equal to one of the specified schemes. /// Thrown when is relative and thus has no scheme. /// Throw when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull; schemes:null => halt")] public static Uri MustHaveOneSchemeOf([ValidatedNotNull] this Uri? parameter, IEnumerable schemes, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) { // ReSharper disable PossibleMultipleEnumeration parameter.MustBeAbsoluteUri(parameterName, message); if (schemes is ICollection collection) { if (!collection.Contains(parameter!.Scheme)) Throw.UriMustHaveOneSchemeOf(parameter, schemes, parameterName, message); return parameter; } if (!schemes.MustNotBeNull(nameof(schemes), message).Contains(parameter!.Scheme)) Throw.UriMustHaveOneSchemeOf(parameter, schemes, parameterName, message); return parameter; // ReSharper restore PossibleMultipleEnumeration } /// /// Ensures that the URI has one of the specified schemes, or otherwise throws your custom exception. /// /// The URI to be checked. /// One of these strings must be equal to the scheme of the URI. /// The delegate that creates your custom exception. /// /// Your custom exception thrown when the scheme is not equal to one of the specified schemes, /// or when is a relative URI, /// or when is null. /// /// Throw when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("parameter:null => halt; parameter:notnull => notnull")] public static Uri MustHaveOneSchemeOf([ValidatedNotNull] this Uri? parameter, TCollection schemes, Func exceptionFactory) where TCollection : class, IEnumerable { if (parameter is null || !parameter.IsAbsoluteUri) Throw.CustomException(exceptionFactory, parameter, schemes); if (schemes is ICollection collection) { if (!collection.Contains(parameter.Scheme)) Throw.CustomException(exceptionFactory, parameter, schemes); return parameter; } // ReSharper disable once ConditionIsAlwaysTrueOrFalse - caller might have NRTs turned off if (schemes is null || !schemes.Contains(parameter.Scheme)) Throw.CustomException(exceptionFactory, parameter, schemes!); return parameter; } } /// /// Provides meta-information about enum values and the flag bitmask if the enum is marked with the . /// Can be used to validate that an enum value is valid. /// /// The type of the enum. internal static class EnumInfo where T : Enum { // ReSharper disable StaticMemberInGenericType /// /// Gets the value indicating whether the enum type is marked with the flags attribute. /// public static readonly bool IsFlagsEnum = typeof(T).GetCustomAttribute(Types.FlagsAttributeType) != null; /// /// Gets the flags pattern when is true. If the enum is not a flags enum, then 0UL is returned. /// public static readonly ulong FlagsPattern; private static readonly int EnumSize = Unsafe.SizeOf(); private static readonly T[] EnumConstantsArray; /// /// Gets the underlying type that is used for the enum ( for default enums). /// public static readonly Type UnderlyingType; /// /// Gets the values of the enum as a read-only collection. /// public static ReadOnlyMemory EnumConstants { get; } static EnumInfo() { EnumConstantsArray = (T[])Enum.GetValues(typeof(T)); var fields = typeof(T).GetFields(); UnderlyingType = fields[0].FieldType; EnumConstants = new ReadOnlyMemory(EnumConstantsArray); if (!IsFlagsEnum) return; for (var i = 0; i < EnumConstantsArray.Length; ++i) { var convertedValue = ConvertToUInt64(EnumConstantsArray[i]); FlagsPattern |= convertedValue; } } [MethodImpl(MethodImplOptions.AggressiveInlining)] private static bool IsValidFlagsValue(T enumValue) { var convertedValue = ConvertToUInt64(enumValue); return (FlagsPattern & convertedValue) == convertedValue; } private static bool IsValidValue(T parameter) { var comparer = EqualityComparer.Default; for (var i = 0; i < EnumConstantsArray.Length; ++i) if (comparer.Equals(EnumConstantsArray[i], parameter)) return true; return false; } /// /// Checks if the specified enum value is valid. This is true if either the enum is a standard enum and the enum value corresponds /// to one of the enum constant values or if the enum type is marked with the and the given value /// is a valid combination of bits for this type. /// /// The enum value to be checked. /// True if either the enum value is [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsValidEnumValue(T enumValue) => IsFlagsEnum ? IsValidFlagsValue(enumValue) : IsValidValue(enumValue); private static ulong ConvertToUInt64(T value) { switch (EnumSize) { case 1: return Unsafe.As(ref value); case 2: return Unsafe.As(ref value); case 4: return Unsafe.As(ref value); case 8: return Unsafe.As(ref value); default: ThrowUnknownEnumSize(); return default; } } private static void ThrowUnknownEnumSize() { throw new InvalidOperationException($"The enum type \"{typeof(T)}\" has an unknown size of {EnumSize}. This means that the underlying enum type is not one of the supported ones."); } } /// /// Represents an that uses /// to compare types. This check works like the normal type equality comparison, but when two /// generic types are compared, they are regarded as equal when one of them is a constructed generic type /// and the other one is the corresponding generic type definition. /// internal sealed class EquivalentTypeComparer : IEqualityComparer { /// /// Gets a singleton instance of the equality comparer. /// public static readonly EquivalentTypeComparer Instance = new EquivalentTypeComparer(); /// /// Checks if the two types are equivalent (using ). /// This check works like the normal type equality comparison, but when two /// generic types are compared, they are regarded as equal when one of them is a constructed generic type /// and the other one is the corresponding generic type definition. /// /// The first type. /// The second type. [MethodImpl(MethodImplOptions.AggressiveInlining)] public bool Equals(Type? x, Type? y) => x.IsEquivalentTypeTo(y); /// /// Returns the hash code of the given type. When the specified type is a constructed generic type, /// the hash code of the generic type definition is returned instead. /// /// The type whose hash code is requested. [MethodImpl(MethodImplOptions.AggressiveInlining)] public int GetHashCode(Type type) => // ReSharper disable once ConditionIsAlwaysTrueOrFalse type is null ? 0 : type.IsConstructedGenericType ? type.GetGenericTypeDefinition().GetHashCode() : type.GetHashCode(); } /// /// Represents an that compares strings using the /// ordinal sort rules, ignoring the case and the white space characters. /// internal sealed class OrdinalIgnoreCaseIgnoreWhiteSpaceComparer : IEqualityComparer { /// /// Checks if the two strings are equal using ordinal sorting rules as well as ignoring the case and /// the white space of the provided strings. /// /// Thrown when or are null. public bool Equals(string? x, string? y) { x.MustNotBeNull(nameof(x)); y.MustNotBeNull(nameof(y)); return x.EqualsOrdinalIgnoreCaseIgnoreWhiteSpace(y); } /// /// Gets the hash code for the specified string. The hash code is created only from the non-white space characters /// which are interpreted as case-insensitive. /// /// Thrown when is null. public int GetHashCode(string @string) { @string.MustNotBeNull(nameof(@string)); var hashBuilder = MultiplyAddHashBuilder.Create(); foreach (var character in @string) { if (!character.IsWhiteSpace()) hashBuilder.CombineIntoHash(char.ToLowerInvariant(character)); } return hashBuilder.BuildHash(); } } /// /// Represents an that compares strings using the /// ordinal sort rules and ignoring the white space characters. /// internal sealed class OrdinalIgnoreWhiteSpaceComparer : IEqualityComparer { /// /// Checks if the two strings are equal using ordinal sorting rules as well as ignoring the white space /// of the provided strings. /// /// Thrown when or are null. public bool Equals(string? x, string? y) { x.MustNotBeNull(nameof(x)); y.MustNotBeNull(nameof(y)); return x.EqualsOrdinalIgnoreWhiteSpace(y); } /// /// Gets the hash code for the specified string. The hash code is created only from the non-white space characters. /// /// Thrown when is null. public int GetHashCode(string @string) { @string.MustNotBeNull(nameof(@string)); var hashCodeBuilder = MultiplyAddHashBuilder.Create(); foreach (var character in @string) { if (!character.IsWhiteSpace()) hashCodeBuilder.CombineIntoHash(character); } return hashCodeBuilder.BuildHash(); } } /// /// Defines a range that can be used to check if a specified is in between it or not. /// /// The type that the range should be applied to. internal readonly struct Range : IEquatable> where T : IComparable { /// /// Gets the lower boundary of the range. /// public readonly T From; /// /// Gets the upper boundary of the range. /// public readonly T To; /// /// Gets the value indicating whether the From value is included in the range. /// public readonly bool IsFromInclusive; /// /// Gets the value indicating whether the To value is included in the range. /// public readonly bool IsToInclusive; private readonly int _expectedLowerBoundaryResult; private readonly int _expectedUpperBoundaryResult; /// /// Creates a new instance of . /// /// The lower boundary of the range. /// The upper boundary of the range. /// The value indicating whether is part of the range. /// The value indicating whether is part of the range. /// Thrown when is less than . [MethodImpl(MethodImplOptions.AggressiveInlining)] public Range(T from, T to, bool isFromInclusive = true, bool isToInclusive = true) { From = from.MustNotBeNullReference(nameof(from)); To = to.MustNotBeLessThan(from, nameof(to)); IsFromInclusive = isFromInclusive; IsToInclusive = isToInclusive; _expectedLowerBoundaryResult = isFromInclusive ? 0 : 1; _expectedUpperBoundaryResult = isToInclusive ? 0 : -1; } /// /// Checks if the specified is within range. /// /// The value to be checked. /// True if value is within range, otherwise false. [MethodImpl(MethodImplOptions.AggressiveInlining)] public bool IsValueWithinRange(T value) => value.MustNotBeNullReference(nameof(value)).CompareTo(From) >= _expectedLowerBoundaryResult && value.CompareTo(To) <= _expectedUpperBoundaryResult; /// /// Use this method to create a range in a fluent style using method chaining. /// Defines the lower boundary as an inclusive value. /// /// The value that indicates the inclusive lower boundary of the resulting range. /// A value you can use to fluently define the upper boundary of a new range. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static RangeFromInfo FromInclusive(T value) => new RangeFromInfo(value, true); /// /// Use this method to create a range in a fluent style using method chaining. /// Defines the lower boundary as an exclusive value. /// /// The value that indicates the exclusive lower boundary of the resulting range. /// A value you can use to fluently define the upper boundary of a new range. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static RangeFromInfo FromExclusive(T value) => new RangeFromInfo(value, false); /// /// The nested can be used to fluently create a . /// public readonly struct RangeFromInfo { private readonly T _from; private readonly bool _isFromInclusive; /// /// Creates a new RangeFromInfo. /// /// The lower boundary of the range. /// The value indicating whether is part of the range. [MethodImpl(MethodImplOptions.AggressiveInlining)] public RangeFromInfo(T from, bool isFromInclusive) { _from = from; _isFromInclusive = isFromInclusive; } /// /// Use this method to create a range in a fluent style using method chaining. /// Defines the upper boundary as an exclusive value. /// /// The value that indicates the exclusive upper boundary of the resulting range. /// A new range with the specified upper and lower boundaries. /// /// Thrown when is less than the lower boundary value. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public Range ToExclusive(T value) => new Range(_from, value, _isFromInclusive, false); /// /// Use this method to create a range in a fluent style using method chaining. /// Defines the upper boundary as an inclusive value. /// /// The value that indicates the inclusive upper boundary of the resulting range. /// A new range with the specified upper and lower boundaries. /// /// Thrown when is less than the lower boundary value. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public Range ToInclusive(T value) => new Range(_from, value, _isFromInclusive); } /// public override string ToString() => $"Range from {CreateRangeDescriptionText()}"; /// /// Returns either "inclusive" or "exclusive", depending whether is true or false. /// public string LowerBoundaryText {[MethodImpl(MethodImplOptions.AggressiveInlining)] get => GetBoundaryText(IsFromInclusive); } /// /// Returns either "inclusive" or "exclusive", depending whether is true or false. /// public string UpperBoundaryText {[MethodImpl(MethodImplOptions.AggressiveInlining)] get => GetBoundaryText(IsToInclusive); } /// /// Returns a text description of this range with the following pattern: From (inclusive | exclusive) to To (inclusive | exclusive). /// public string CreateRangeDescriptionText(string fromToConnectionWord = "to") => From + " (" + LowerBoundaryText + ") " + fromToConnectionWord + ' ' + To + " (" + UpperBoundaryText + ")"; [MethodImpl(MethodImplOptions.AggressiveInlining)] private static string GetBoundaryText(bool isInclusive) => isInclusive ? "inclusive" : "exclusive"; /// public bool Equals(Range other) { if (IsFromInclusive != other.IsFromInclusive || IsToInclusive != other.IsToInclusive) return false; var comparer = EqualityComparer.Default; return comparer.Equals(From, other.From) && comparer.Equals(To, other.To); } /// public override bool Equals(object? other) { if (other is null) return false; return other is Range range && Equals(range); } /// public override int GetHashCode() => MultiplyAddHash.CreateHashCode(From, To, IsFromInclusive, IsToInclusive); /// /// Checks if two ranges are equal. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool operator ==(Range first, Range second) => first.Equals(second); /// /// Checks if two ranges are not equal. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool operator !=(Range first, Range second) => first.Equals(second) == false; } /// /// Provides methods to simplify the creation of instances. /// internal static class Range { /// /// Use this method to create a range in a fluent style using method chaining. /// Defines the lower boundary as an inclusive value. /// /// The value that indicates the inclusive lower boundary of the resulting range. /// A value you can use to fluently define the upper boundary of a new range. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Range.RangeFromInfo FromInclusive(T value) where T : IComparable => new(value, true); /// /// Use this method to create a range in a fluent style using method chaining. /// Defines the lower boundary as an exclusive value. /// /// The value that indicates the exclusive lower boundary of the resulting range. /// A value you can use to fluently define the upper boundary of a new range. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Range.RangeFromInfo FromExclusive(T value) where T : IComparable => new(value, false); /// /// Creates a range for the specified enumerable that encompasses all valid indexes. /// /// /// The count of this enumerable will be used to create the index range. Please ensure that this enumerable /// is actually a collection, not a lazy enumerable. /// /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Range For(IEnumerable enumerable) => new(0, enumerable.Count(), isFromInclusive: true, isToInclusive: false); /// /// Creates a range for the specified enumerable that encompasses all valid indexes. /// /// /// The count of this enumerable will be used to create the index range. Please ensure that this enumerable /// is actually a collection, not a lazy enumerable. /// /// Thrown when is null. public static Range For(IEnumerable enumerable) => new(0, enumerable.GetCount(), isFromInclusive: true, isToInclusive: false); /// /// Creates a range for the specified span that encompasses all valid indexes. /// /// /// The length of the span is used to create a valid index range. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Range For(ReadOnlySpan span) => new(0, span.Length, isFromInclusive: true, isToInclusive: false); /// /// Creates a range for the specified span that encompasses all valid indexes. /// /// /// The length of the span is used to create a valid index range. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Range For(Span span) => new(0, span.Length, isFromInclusive: true, isToInclusive: false); /// /// Creates a range for the specified memory that encompasses all valid indexes. /// /// /// The length of the memory is used to create a valid index range. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Range For(Memory memory) => new(0, memory.Length, isFromInclusive: true, isToInclusive: false); /// /// Creates a range for the specified memory that encompasses all valid indexes. /// /// /// The length of the memory is used to create a valid index range. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Range For(ReadOnlyMemory memory) => new(0, memory.Length, isFromInclusive: true, isToInclusive: false); /// /// Creates a range for the specified memory that encompasses all valid indexes. /// /// /// The count of the segment is used to create a valid index range. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static Range For(ArraySegment segment) => new(0, segment.Count, isFromInclusive: true, isToInclusive: false); } /// /// Provides regular expressions that are used in string assertions. /// internal static class RegularExpressions { /// /// Gets the default regular expression for email validation. /// This pattern is based on https://www.rhyous.com/2010/06/15/csharp-email-regular-expression/ and /// was modified to satisfy all tests of https://blogs.msdn.microsoft.com/testing123/2009/02/06/email-address-test-cases/. /// public static readonly Regex EmailRegex = new Regex(@"^[\w!#$%&'*+\-/=?\^_`{|}~]+(\.[\w!#$%&'*+\-/=?\^_`{|}~]+)*@((((\w+\-?)+\.)+[a-zA-Z]{2,4})|(([0-9]{1,3}\.){3}[0-9]{1,3}))$", RegexOptions.CultureInvariant | RegexOptions.ECMAScript); } /// /// Represents a delegate that receives a span and a value as parameters and that produces an exception. /// internal delegate Exception SpanExceptionFactory(Span span, T value); /// /// Represents a delegate that receives a read-only span and a value as parameters and that produces an exception. /// internal delegate Exception ReadOnlySpanExceptionFactory(ReadOnlySpan span, T value); /// /// Specifies the culture, case , and sort rules when comparing strings. /// /// /// This enum is en extension of , adding /// capabilities to ignore white space when making string equality comparisons. /// See the when /// you want to compare in such a way. /// internal enum StringComparisonType { /// /// Compare strings using culture-sensitive sort rules and the current culture. /// CurrentCulture = 0, /// /// Compare strings using culture-sensitive sort rules, the current culture, and /// ignoring the case of the strings being compared. /// CurrentCultureIgnoreCase = 1, /// /// Compare strings using culture-sensitive sort rules and the invariant culture. /// InvariantCulture = 2, /// /// Compare strings using culture-sensitive sort rules, the invariant culture, and /// ignoring the case of the strings being compared. /// InvariantCultureIgnoreCase = 3, /// /// Compare strings using ordinal sort rules. /// Ordinal = 4, /// /// Compare strings using ordinal sort rules and ignoring the case of the strings /// being compared. /// OrdinalIgnoreCase = 5, /// /// Compare strings using ordinal sort rules and ignoring the white space characters /// of the strings being compared. /// OrdinalIgnoreWhiteSpace = 6, /// /// Compare strings using ordinal sort rules, ignoring the case and ignoring the /// white space characters of the strings being compared. /// OrdinalIgnoreCaseIgnoreWhiteSpace = 7 } /// /// This class caches instances to avoid use of the typeof operator. /// internal abstract class Types { /// /// Gets the type. /// public static readonly Type FlagsAttributeType = typeof(FlagsAttribute); } [AttributeUsage(AttributeTargets.Parameter)] internal sealed class ValidatedNotNullAttribute : Attribute { } } namespace Light.GuardClauses.Exceptions { /// /// This exception indicates that an URI is absolute instead of relative. /// [Serializable] internal class AbsoluteUriException : UriException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public AbsoluteUriException(string? parameterName = null, string? message = null) : base(parameterName, message) { } /// protected AbsoluteUriException(SerializationInfo info, StreamingContext context) : base(info, context) { } } /// /// This exception indicates that a value of a value type is the default value. /// [Serializable] internal class ArgumentDefaultException : ArgumentException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public ArgumentDefaultException(string? parameterName = null, string? message = null) : base(message, parameterName) { } /// protected ArgumentDefaultException(SerializationInfo info, StreamingContext context) : base(info, context) { } } /// /// This exception indicates that the state of a collection is invalid. /// [Serializable] internal class CollectionException : ArgumentException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public CollectionException(string? parameterName = null, string? message = null) : base(message, parameterName) { } /// protected CollectionException(SerializationInfo info, StreamingContext context) : base(info, context) { } } /// /// This exception indicates that a collection has no items. /// [Serializable] internal class EmptyCollectionException : InvalidCollectionCountException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public EmptyCollectionException(string? parameterName = null, string? message = null) : base(parameterName, message) { } /// protected EmptyCollectionException(SerializationInfo info, StreamingContext context) : base(info, context) { } } /// /// This exception indicates that that a GUID is empty. /// [Serializable] internal class EmptyGuidException : ArgumentException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public EmptyGuidException(string? parameterName = null, string? message = null) : base(message, parameterName) { } /// protected EmptyGuidException(SerializationInfo info, StreamingContext context) : base(info, context) { } } /// /// This exception indicates that a string is empty. /// [Serializable] internal class EmptyStringException : StringException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public EmptyStringException(string? parameterName = null, string? message = null) : base(parameterName, message) { } /// protected EmptyStringException(SerializationInfo info, StreamingContext context) : base(info, context) { } } /// /// This exception indicates that a value is not defined in the corresponding enum type. /// [Serializable] internal class EnumValueNotDefinedException : ArgumentException { /// /// Creates a new instance of . /// /// The name of the parameter. /// The message of the exception. public EnumValueNotDefinedException(string? parameterName = null, string? message = null) : base(message, parameterName) { } /// protected EnumValueNotDefinedException(SerializationInfo info, StreamingContext context) : base(info, context) { } } /// /// This exception indicates that a collection contains an item that must not be part of it. /// [Serializable] internal class ExistingItemException : CollectionException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public ExistingItemException(string? parameterName = null, string? message = null) : base(parameterName, message) { } /// protected ExistingItemException(SerializationInfo info, StreamingContext context) : base(info, context) { } } /// /// This exception indicates that a collection has an invalid number of items. /// [Serializable] internal class InvalidCollectionCountException : CollectionException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public InvalidCollectionCountException(string? parameterName = null, string? message = null) : base(parameterName, message) { } /// protected InvalidCollectionCountException(SerializationInfo info, StreamingContext context) : base(info, context) { } } /// /// This exception indicates that configuration data is invalid. /// [Serializable] internal class InvalidConfigurationException : Exception { /// /// Initializes a new instance of . /// /// The message of the exception (optional). /// The exception that is the cause of this one (optional). public InvalidConfigurationException(string? message = null, Exception? innerException = null) : base(message, innerException) { } /// protected InvalidConfigurationException(SerializationInfo info, StreamingContext context) : base(info, context) { } } /// /// This exception indicates that a value is invalid. /// [Serializable] internal class InvalidDateTimeException : ArgumentException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public InvalidDateTimeException(string? parameterName = null, string? message = null) : base(message, parameterName) { } /// protected InvalidDateTimeException(SerializationInfo info, StreamingContext context) : base(info, context) { } } /// /// This exception indicates that an Email address is invalid. /// [Serializable] internal class InvalidEmailAddressException : StringException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public InvalidEmailAddressException(string? parameterName = null, string? message = null) : base(parameterName, message) { } /// protected InvalidEmailAddressException(SerializationInfo info, StreamingContext context) : base(info, context) { } } /// /// This exception indicates that the data is in invalid state. /// [Serializable] internal class InvalidStateException : Exception { /// /// Creates a new instance of . /// /// The message of the exception (optional). /// The exception that is the cause of this one (optional). public InvalidStateException(string? message = null, Exception? innerException = null) : base(message, innerException) { } /// protected InvalidStateException(SerializationInfo info, StreamingContext context) : base(info, context) { } } /// /// This exception indicates that an URI has an invalid scheme. /// [Serializable] internal class InvalidUriSchemeException : UriException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public InvalidUriSchemeException(string? parameterName = null, string? message = null) : base(parameterName, message) { } /// protected InvalidUriSchemeException(SerializationInfo info, StreamingContext context) : base(info, context) { } } /// /// This exception indicates that an item is not present in a collection. /// [Serializable] internal class MissingItemException : CollectionException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public MissingItemException(string? parameterName = null, string? message = null) : base(parameterName, message) { } /// protected MissingItemException(SerializationInfo info, StreamingContext context) : base(info, context) { } } /// /// This exception indicates that a has no value. /// [Serializable] internal class NullableHasNoValueException : ArgumentException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public NullableHasNoValueException(string? parameterName = null, string? message = null) : base(message, parameterName) { } /// protected NullableHasNoValueException(SerializationInfo info, StreamingContext context) : base(info, context) { } } /// /// This exception indicates that an URI is relative instead of absolute. /// [Serializable] internal class RelativeUriException : UriException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public RelativeUriException(string? parameterName = null, string? message = null) : base(parameterName, message) { } /// protected RelativeUriException(SerializationInfo info, StreamingContext context) : base(info, context) { } } /// /// This exception indicates that two references point to the same object. /// [Serializable] internal class SameObjectReferenceException : ArgumentException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public SameObjectReferenceException(string? parameterName = null, string? message = null) : base(message, parameterName) { } /// protected SameObjectReferenceException(SerializationInfo info, StreamingContext context) : base(info, context) { } } /// /// This exception indicates that a string is not matching a regular expression. /// [Serializable] internal class StringDoesNotMatchException : StringException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public StringDoesNotMatchException(string? parameterName = null, string? message = null) : base(parameterName, message) { } /// protected StringDoesNotMatchException(SerializationInfo info, StreamingContext context) : base(info, context) { } } /// /// This exception indicates that a string is in an invalid state. /// [Serializable] internal class StringException : ArgumentException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public StringException(string? parameterName = null, string? message = null) : base(message, parameterName) { } /// protected StringException(SerializationInfo info, StreamingContext context) : base(info, context) { } } /// /// This exception indicates that a string has an invalid length. /// [Serializable] internal class StringLengthException : StringException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public StringLengthException(string? parameterName = null, string? message = null) : base(parameterName, message) { } /// protected StringLengthException(SerializationInfo info, StreamingContext context) : base(info, context) { } } /// /// This exception indicates that a string is in an invalid state. /// [Serializable] internal class SubstringException : StringException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public SubstringException(string? parameterName = null, string? message = null) : base(parameterName, message) { } /// protected SubstringException(SerializationInfo info, StreamingContext context) : base(info, context) { } } /// /// Provides static factory methods that throw default exceptions. /// internal static class Throw { /// /// Throws the default , using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void ArgumentNull(string? parameterName = null, string? message = null) => throw new ArgumentNullException(parameterName, message ?? $"{parameterName ?? "The value"} must not be null."); /// /// Throws the default indicating that a value is the default value of its type, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void ArgumentDefault(string? parameterName = null, string? message = null) => throw new ArgumentDefaultException(parameterName, message ?? $"{parameterName ?? "The value"} must not be the default value."); /// /// Throws the default indicating that a reference cannot be downcast, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void InvalidTypeCast(object? parameter, Type targetType, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new TypeCastException(parameterName, message ?? $"{parameterName ?? "The value"} {parameter.ToStringOrNull()} cannot be cast to \"{targetType}\"."); /// /// Throws the default indicating that a value is not one of the constants defined in an enum, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void EnumValueNotDefined(T parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : Enum => throw new EnumValueNotDefinedException(parameterName, message ?? $"{parameterName ?? "The value"} \"{parameter}\" must be one of the defined constants of enum \"{parameter.GetType()}\", but it actually is not."); /// /// Throws the default indicating that a GUID is empty, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void EmptyGuid(string? parameterName = null, string? message = null) => throw new EmptyGuidException(parameterName, message ?? $"{parameterName ?? "The value"} must be a valid GUID, but it actually is an empty one."); /// /// Throws an using the optional message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void InvalidOperation(string? message = null) => throw new InvalidOperationException(message); /// /// Throws an using the optional message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void InvalidState(string? message = null) => throw new InvalidStateException(message); /// /// Throws an using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void Argument(string? parameterName = null, string? message = null) => throw new ArgumentException(message ?? $"{parameterName ?? "The value"} is invalid.", parameterName); /// /// Throws an using the optional message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void InvalidEmailAddress(string parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidEmailAddressException(parameterName, message ?? $"{parameterName ?? "The string"} must be a valid email address, but it actually is \"{parameter}\"."); /// /// Throws the default indicating that a has no value, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void NullableHasNoValue(string? parameterName = null, string? message = null) => throw new NullableHasNoValueException(parameterName, message ?? $"{parameterName ?? "The nullable"} must have a value, but it actually is null."); /// /// Throws the default indicating that a comparable value must not be less than the given boundary value, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void MustNotBeLessThan(T parameter, T boundary, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable => throw new ArgumentOutOfRangeException(parameterName, message ?? $"{parameterName ?? "The value"} must not be less than {boundary}, but it actually is {parameter}."); /// /// Throws the default indicating that a comparable value must be less than the given boundary value, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void MustBeLessThan(T parameter, T boundary, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable => throw new ArgumentOutOfRangeException(parameterName, message ?? $"{parameterName ?? "The value"} must be less than {boundary}, but it actually is {parameter}."); /// /// Throws the default indicating that a comparable value must not be less than or equal to the given boundary value, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void MustNotBeLessThanOrEqualTo(T parameter, T boundary, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable => throw new ArgumentOutOfRangeException(parameterName, message ?? $"{parameterName ?? "The value"} must not be less than or equal to {boundary}, but it actually is {parameter}."); /// /// Throws the default indicating that a comparable value must not be greater than or equal to the given boundary value, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void MustNotBeGreaterThanOrEqualTo(T parameter, T boundary, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable => throw new ArgumentOutOfRangeException(parameterName, message ?? $"{parameterName ?? "The value"} must not be greater than or equal to {boundary}, but it actually is {parameter}."); /// /// Throws the default indicating that a comparable value must be greater than or equal to the given boundary value, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void MustBeGreaterThanOrEqualTo(T parameter, T boundary, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable => throw new ArgumentOutOfRangeException(parameterName, message ?? $"{parameterName ?? "The value"} must be greater than or equal to {boundary}, but it actually is {parameter}."); /// /// Throws the default indicating that a comparable value must be greater than the given boundary value, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void MustBeGreaterThan(T parameter, T boundary, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable => throw new ArgumentOutOfRangeException(parameterName, message ?? $"{parameterName ?? "The value"} must be greater than {boundary}, but it actually is {parameter}."); /// /// Throws the default indicating that a comparable value must not be greater than the given boundary value, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void MustNotBeGreaterThan(T parameter, T boundary, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable => throw new ArgumentOutOfRangeException(parameterName, message ?? $"{parameterName ?? "The value"} must not be greater than {boundary}, but it actually is {parameter}."); /// /// Throws the default indicating that a comparable value must be less than or equal to the given boundary value, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void MustBeLessThanOrEqualTo(T parameter, T boundary, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable => throw new ArgumentOutOfRangeException(parameterName, message ?? $"{parameterName ?? "The value"} must be less than or equal to {boundary}, but it actually is {parameter}."); /// /// Throws the default indicating that a value is not within a specified range, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void MustBeInRange(T parameter, Range range, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable => throw new ArgumentOutOfRangeException(parameterName, message ?? $"{parameterName ?? "The value"} must be between {range.CreateRangeDescriptionText("and")}, but it actually is {parameter}."); /// /// Throws the default indicating that a value is within a specified range, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void MustNotBeInRange(T parameter, Range range, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : IComparable => throw new ArgumentOutOfRangeException(parameterName, message ?? $"{parameterName ?? "The value"} must not be between {range.CreateRangeDescriptionText("and")}, but it actually is {parameter}."); /// /// Throws the default indicating that two references point to the same object, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void SameObjectReference(T? parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) where T : class => throw new SameObjectReferenceException(parameterName, message ?? $"{parameterName ?? "The reference"} must not point to object \"{parameter}\", but it actually does."); /// /// Throws the default indicating that a string is empty, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void EmptyString(string? parameterName = null, string? message = null) => throw new EmptyStringException(parameterName, message ?? $"{parameterName ?? "The string"} must not be an empty string, but it actually is."); /// /// Throws the default indicating that a string contains only white space, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void WhiteSpaceString(string parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new WhiteSpaceStringException(parameterName, message ?? $"{parameterName ?? "The string"} must not contain only white space, but it actually is \"{parameter}\"."); /// /// Throws the default indicating that a string does not match a regular expression, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void StringDoesNotMatch(string parameter, Regex regex, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new StringDoesNotMatchException(parameterName, message ?? $"{parameterName ?? "The string"} must match the regular expression \"{regex}\", but it actually is \"{parameter}\"."); /// /// Throws the default indicating that a string does not contain another string as a substring, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void StringDoesNotContain(string parameter, string substring, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new SubstringException(parameterName, message ?? $"{parameterName ?? "The string"} must contain {substring.ToStringOrNull()}, but it actually is {parameter.ToStringOrNull()}."); /// /// Throws the default indicating that a string does not contain another string as a substring, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void StringDoesNotContain(string parameter, string substring, StringComparison comparisonType, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new SubstringException(parameterName, message ?? $"{parameterName ?? "The string"} must contain {substring.ToStringOrNull()} ({comparisonType}), but it actually is {parameter.ToStringOrNull()}."); /// /// Throws the default indicating that a string does contain another string as a substring, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void StringContains(string parameter, string substring, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new SubstringException(parameterName, message ?? $"{parameterName ?? "The string"} must not contain {substring.ToStringOrNull()} as a substring, but it actually is {parameter.ToStringOrNull()}."); /// /// Throws the default indicating that a string does contain another string as a substring, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void StringContains(string parameter, string substring, StringComparison comparisonType, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new SubstringException(parameterName, message ?? $"{parameterName ?? "The string"} must not contain {substring.ToStringOrNull()} as a substring ({comparisonType}), but it actually is {parameter.ToStringOrNull()}."); /// /// Throws the default indicating that a string is not a substring of another one, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void NotSubstring(string parameter, string other, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new SubstringException(parameterName, message ?? $"{parameterName ?? "The string"} must be a substring of \"{other}\", but it actually is {parameter.ToStringOrNull()}."); /// /// Throws the default indicating that a string is not a substring of another one, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void NotSubstring(string parameter, string other, StringComparison comparisonType, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new SubstringException(parameterName, message ?? $"{parameterName ?? "The string"} must be a substring of \"{other}\" ({comparisonType}), but it actually is {parameter.ToStringOrNull()}."); /// /// Throws the default indicating that a string is a substring of another one, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void Substring(string parameter, string other, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new SubstringException(parameterName, message ?? $"{parameterName ?? "The string"} must not be a substring of \"{other}\", but it actually is {parameter.ToStringOrNull()}."); /// /// Throws the default indicating that a string is a substring of another one, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void Substring(string parameter, string other, StringComparison comparisonType, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new SubstringException(parameterName, message ?? $"{parameterName ?? "The string"} must not be a substring of \"{other}\" ({comparisonType}), but it actually is {parameter.ToStringOrNull()}."); /// /// Throws the default indicating that a string is not shorter than the given length, using the optional parameter name an message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void StringNotShorterThan(string parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new StringLengthException(parameterName, message ?? $"{parameterName ?? "The string"} must be shorter than {length}, but it actually has length {parameter.Length}."); /// /// Throws the default indicating that a string is not shorter or equal to the given length, using the optional parameter name an message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void StringNotShorterThanOrEqualTo(string parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new StringLengthException(parameterName, message ?? $"{parameterName ?? "The string"} must be shorter or equal to {length}, but it actually has length {parameter.Length}."); /// /// Throws the default indicating that a string has a different length than the specified one, using the optional parameter name an message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void StringLengthNotEqualTo(string parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new StringLengthException(parameterName, message ?? $"{parameterName ?? "The string"} must have length {length}, but it actually has length {parameter.Length}."); /// /// Throws the default indicating that a string is not longer than the given length, using the optional parameter name an message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void StringNotLongerThan(string parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new StringLengthException(parameterName, message ?? $"{parameterName ?? "The string"} must be longer than {length}, but it actually has length {parameter.Length}."); /// /// Throws the default indicating that a string is not longer or equal to the given length, using the optional parameter name an message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void StringNotLongerThanOrEqualTo(string parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new StringLengthException(parameterName, message ?? $"{parameterName ?? "The string"} must be longer than or equal to {length}, but it actually has length {parameter.Length}."); /// /// Throws the default indicating that a string's length is not in between the given range, using the optional parameter name an message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void StringLengthNotInRange(string parameter, Range range, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new StringLengthException(parameterName, message ?? $"{parameterName ?? "The string"} must have its length in between {range.CreateRangeDescriptionText("and")}, but it actually has length {parameter.Length}."); /// /// Throws the default indicating that a string is not equal to "\n" or "\r\n". /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void NotNewLine(string? parameter, string? parameterName, string? message) => throw new StringException(parameterName, message ?? $"{parameterName ?? "The string"} must be either \"\\n\" or \"\\r\\n\", but it actually is {parameter.ToStringOrNull()}."); /// /// Throws the default indicating that a string is not trimmed. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void NotTrimmed(string? parameter, string? parameterName, string? message) => throw new StringException(parameterName, message ?? $"{parameterName ?? "The string"} must be trimmed, but it actually is {parameter.ToStringOrNull()}."); /// /// Throws the default indicating that a string is not trimmed at the start. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void NotTrimmedAtStart(string? parameter, string? parameterName, string? message) => throw new StringException(parameterName, message ?? $"{parameterName ?? "The string"} must be trimmed at the start, but it actually is {parameter.ToStringOrNull()}."); /// /// Throws the default indicating that a string is not trimmed at the end. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void NotTrimmedAtEnd(string? parameter, string? parameterName, string? message) => throw new StringException(parameterName, message ?? $"{parameterName ?? "The string"} must be trimmed at the end, but it actually is {parameter.ToStringOrNull()}."); /// /// Throws the default indicating that two values are not equal, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void ValuesNotEqual(T parameter, T other, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new ValuesNotEqualException(parameterName, message ?? $"{parameterName ?? "The value"} must be equal to {other.ToStringOrNull()}, but it actually is {parameter.ToStringOrNull()}."); /// /// Throws the default indicating that two values are equal, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void ValuesEqual(T parameter, T other, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new ValuesEqualException(parameterName, message ?? $"{parameterName ?? "The value"} must not be equal to {other.ToStringOrNull()}, but it actually is {parameter.ToStringOrNull()}."); /// /// Throws the default indicating that a collection has an invalid number of items, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void InvalidCollectionCount(IEnumerable parameter, int count, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidCollectionCountException(parameterName, message ?? $"{parameterName ?? "The collection"} must have count {count}, but it actually has count {parameter.Count()}."); /// /// Throws the default indicating that a span has an invalid length, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void InvalidSpanLength(in Span parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidCollectionCountException(parameterName, message ?? $"{parameterName ?? "The span"} must have length {length}, but it actually has length {parameter.Length}."); /// /// Throws the default indicating that a span has an invalid length, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void InvalidSpanLength(in ReadOnlySpan parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidCollectionCountException(parameterName, message ?? $"{parameterName ?? "The read-only span"} must have length {length}, but it actually has length {parameter.Length}."); /// /// Throws the default indicating that a collection has less than a minimum number of items, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void InvalidMinimumCollectionCount(IEnumerable parameter, int count, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidCollectionCountException(parameterName, message ?? $"{parameterName ?? "The collection"} must have at least count {count}, but it actually has count {parameter.Count()}."); /// /// Throws the default indicating that a span is not longer than the specified length. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void SpanMustBeLongerThan(in Span parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidCollectionCountException(parameterName, message ?? $"{parameterName ?? "The span"} must be longer than {length}, but it actually has length {parameter.Length}."); /// /// Throws the default indicating that a span is not longer than the specified length. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void SpanMustBeLongerThan(in ReadOnlySpan parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidCollectionCountException(parameterName, message ?? $"{parameterName ?? "The span"} must be longer than {length}, but it actually has length {parameter.Length}."); /// /// Throws the default indicating that a span is not longer than and not equal to the specified length. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void SpanMustBeLongerThanOrEqualTo(in Span parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidCollectionCountException(parameterName, message ?? $"{parameterName ?? "The span"} must be longer than or equal to {length}, but it actually has length {parameter.Length}."); /// /// Throws the default indicating that a span is not longer than and not equal to the specified length. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void SpanMustBeLongerThanOrEqualTo(in ReadOnlySpan parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidCollectionCountException(parameterName, message ?? $"{parameterName ?? "The span"} must be longer than or equal to {length}, but it actually has length {parameter.Length}."); /// /// Throws the default indicating that a span is not shorter than the specified length. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void SpanMustBeShorterThan(in Span parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidCollectionCountException(parameterName, message ?? $"{parameterName ?? "The span"} must be shorter than {length}, but it actually has length {parameter.Length}."); /// /// Throws the default indicating that a span is not shorter than the specified length. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void SpanMustBeShorterThanOrEqualTo(in Span parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidCollectionCountException(parameterName, message ?? $"{parameterName ?? "The span"} must be shorter than or equal to {length}, but it actually has length {parameter.Length}."); /// /// Throws the default indicating that a span is not shorter than the specified length. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void SpanMustBeShorterThanOrEqualTo(in ReadOnlySpan parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidCollectionCountException(parameterName, message ?? $"{parameterName ?? "The span"} must be shorter than or equal to {length}, but it actually has length {parameter.Length}."); /// /// Throws the default indicating that a span is not shorter than the specified length. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void SpanMustBeShorterThan(in ReadOnlySpan parameter, int length, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidCollectionCountException(parameterName, message ?? $"{parameterName ?? "The span"} must be shorter than {length}, but it actually has length {parameter.Length}."); /// /// Throws the default indicating that a collection has more than a maximum number of items, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void InvalidMaximumCollectionCount(IEnumerable parameter, int count, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidCollectionCountException(parameterName, message ?? $"{parameterName ?? "The collection"} must have at most count {count}, but it actually has count {parameter.Count()}."); /// /// Throws the default indicating that a collection has no items, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void EmptyCollection(string? parameterName = null, string? message = null) => throw new EmptyCollectionException(parameterName, message ?? $"{parameterName ?? "The collection"} must not be an empty collection, but it actually is."); /// /// Throws the default indicating that a collection is not containing the specified item, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void MissingItem(IEnumerable parameter, TItem item, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new MissingItemException(parameterName, message ?? new StringBuilder().AppendLine($"{parameterName ?? "The collection"} must contain {item.ToStringOrNull()}, but it actually does not.").AppendCollectionContent(parameter).ToString()); /// /// Throws the default indicating that a collection contains the specified item that should not be part of it, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void ExistingItem(IEnumerable parameter, TItem item, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new ExistingItemException(parameterName, message ?? new StringBuilder().AppendLine($"{parameterName ?? "The collection"} must not contain {item.ToStringOrNull()}, but it actually does.").AppendCollectionContent(parameter).ToString()); /// /// Throws the default indicating that a value is not one of a specified collection of items, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void ValueNotOneOf(TItem parameter, IEnumerable items, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new ValueIsNotOneOfException(parameterName, message ?? new StringBuilder().AppendLine($"{parameterName ?? "The value"} must be one of the following items").AppendItemsWithNewLine(items).AppendLine($"but it actually is {parameter.ToStringOrNull()}.").ToString()); /// /// Throws the default indicating that a value is one of a specified collection of items, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void ValueIsOneOf(TItem parameter, IEnumerable items, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new ValueIsOneOfException(parameterName, message ?? new StringBuilder().AppendLine($"{parameterName ?? "The value"} must not be one of the following items").AppendItemsWithNewLine(items).AppendLine($"but it actually is {parameter.ToStringOrNull()}.").ToString()); /// /// Throws the default indicating that a URI is relative instead of absolute, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void MustBeAbsoluteUri(Uri parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new RelativeUriException(parameterName, message ?? $"{parameterName ?? "The URI"} must be an absolute URI, but it actually is \"{parameter}\"."); /// /// Throws the default indicating that a URI is absolute instead of relative, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void MustBeRelativeUri(Uri parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new AbsoluteUriException(parameterName, message ?? $"{parameterName ?? "The URI"} must be a relative URI, but it actually is \"{parameter}\"."); /// /// Throws the default indicating that a URI has an unexpected scheme, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void UriMustHaveScheme(Uri parameter, string scheme, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidUriSchemeException(parameterName, message ?? $"{parameterName ?? "The URI"} must use the scheme \"{scheme}\", but it actually is \"{parameter}\"."); /// /// Throws the default indicating that a URI does not use one of a set of expected schemes, using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void UriMustHaveOneSchemeOf(Uri parameter, IEnumerable schemes, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidUriSchemeException(parameterName, message ?? new StringBuilder().AppendLine($"{parameterName ?? "The URI"} must use one of the following schemes").AppendItemsWithNewLine(schemes).AppendLine($"but it actually is \"{parameter}\".").ToString()); /// /// Throws the default indicating that a date time is not using , using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void MustBeUtcDateTime(DateTime parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidDateTimeException(parameterName, message ?? $"{parameterName ?? "The date time"} must use kind \"{DateTimeKind.Utc}\", but it actually uses \"{parameter.Kind}\" and is \"{parameter:O}\"."); /// /// Throws the default indicating that a date time is not using , using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void MustBeLocalDateTime(DateTime parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidDateTimeException(parameterName, message ?? $"{parameterName ?? "The date time"} must use kind \"{DateTimeKind.Local}\", but it actually uses \"{parameter.Kind}\" and is \"{parameter:O}\"."); /// /// Throws the default indicating that a date time is not using , using the optional parameter name and message. /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void MustBeUnspecifiedDateTime(DateTime parameter, [CallerArgumentExpression("parameter")] string? parameterName = null, string? message = null) => throw new InvalidDateTimeException(parameterName, message ?? $"{parameterName ?? "The date time"} must use kind \"{DateTimeKind.Unspecified}\", but it actually uses \"{parameter.Kind}\" and is \"{parameter:O}\"."); /// /// Throws the exception that is returned by . /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void CustomException(Func exceptionFactory) => throw exceptionFactory.MustNotBeNull(nameof(exceptionFactory))(); /// /// Throws the exception that is returned by . is passed to . /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void CustomException(Func exceptionFactory, T parameter) => throw exceptionFactory.MustNotBeNull(nameof(exceptionFactory))(parameter); /// /// Throws the exception that is returned by . and are passed to . /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void CustomException(Func exceptionFactory, T1 first, T2 second) => throw exceptionFactory.MustNotBeNull(nameof(exceptionFactory))(first, second); /// /// Throws the exception that is returned by . , , and are passed to . /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void CustomException(Func exceptionFactory, T1 first, T2 second, T3 third) => throw exceptionFactory.MustNotBeNull(nameof(exceptionFactory))(first, second, third); /// /// Throws the exception that is returned by . and are passed to . /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void CustomSpanException(SpanExceptionFactory exceptionFactory, in Span span, T value) => throw exceptionFactory.MustNotBeNull(nameof(exceptionFactory))(span, value); /// /// Throws the exception that is returned by . and are passed to . /// [ContractAnnotation("=> halt")] [DoesNotReturn] public static void CustomSpanException(ReadOnlySpanExceptionFactory exceptionFactory, in ReadOnlySpan span, T value) => throw exceptionFactory.MustNotBeNull(nameof(exceptionFactory))(span, value); } /// /// This exception indicates that a value cannot be cast to another type. /// [Serializable] internal class TypeCastException : ArgumentException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public TypeCastException(string? parameterName = null, string? message = null) : base(message, parameterName) { } /// protected TypeCastException(SerializationInfo info, StreamingContext context) : base(info, context) { } } /// /// This exception indicates that an URI is invalid. /// [Serializable] internal class UriException : ArgumentException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public UriException(string? parameterName = null, string? message = null) : base(message, parameterName) { } /// protected UriException(SerializationInfo info, StreamingContext context) : base(info, context) { } } /// /// This exception indicates that an item is not part of a collection. /// [Serializable] internal class ValueIsNotOneOfException : ArgumentException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public ValueIsNotOneOfException(string? parameterName = null, string? message = null) : base(message, parameterName) { } /// protected ValueIsNotOneOfException(SerializationInfo info, StreamingContext context) : base(info, context) { } } /// /// This exception indicates that an item is part of a collection. /// [Serializable] internal class ValueIsOneOfException : ArgumentException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public ValueIsOneOfException(string? parameterName = null, string? message = null) : base(message, parameterName) { } /// protected ValueIsOneOfException(SerializationInfo info, StreamingContext context) : base(info, context) { } } /// /// This exception indicates that two values are equal. /// [Serializable] internal class ValuesEqualException : ArgumentException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public ValuesEqualException(string? parameterName = null, string? message = null) : base(message, parameterName) { } /// protected ValuesEqualException(SerializationInfo info, StreamingContext context) : base(info, context) { } } /// /// This exception indicates that two values are not equal. /// [Serializable] internal class ValuesNotEqualException : ArgumentException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public ValuesNotEqualException(string? parameterName = null, string? message = null) : base(message, parameterName) { } /// protected ValuesNotEqualException(SerializationInfo info, StreamingContext context) : base(info, context) { } } /// /// This exception indicates that a string contains only white space. /// [Serializable] internal class WhiteSpaceStringException : StringException { /// /// Creates a new instance of . /// /// The name of the parameter (optional). /// The message of the exception (optional). public WhiteSpaceStringException(string? parameterName = null, string? message = null) : base(parameterName, message) { } /// protected WhiteSpaceStringException(SerializationInfo info, StreamingContext context) : base(info, context) { } } } namespace Light.GuardClauses.FrameworkExtensions { /// /// Provides extension methods for the interface. /// internal static class EnumerableExtensions { /// /// Tries to cast the specified enumerable to an , or /// creates a new containing the enumerable items. /// /// The item type of the enumerable. /// The enumerable to be transformed. /// The list containing the items of the enumerable. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("source:null => halt; source:notnull => notnull")] public static IList AsList([ValidatedNotNull] this IEnumerable source) => source as IList ?? source.ToList(); /// /// Tries to cast the specified enumerable to an , or /// creates a new collection containing the enumerable items by calling the specified delegate. /// /// The item type of the collection. /// The enumerable that will be converted to . /// The delegate that creates the collection containing the specified items. /// The cast enumerable, or a new collection containing the enumerable items. /// Thrown when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("source:null => halt; source:notnull => notnull; createCollection:null => halt")] public static IList AsList([ValidatedNotNull] this IEnumerable source, Func, IList> createCollection) => source as IList ?? createCollection.MustNotBeNull(nameof(createCollection))(source.MustNotBeNull(nameof(source))); /// /// Tries to downcast the specified enumerable to an array, or creates a new array with the specified items. /// /// The item type of the collection. /// The enumerable that will be converted to an array. /// The cast array, or a new array containing the enumerable items. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("source:null => halt; source:notnull => notnull")] public static T[] AsArray([ValidatedNotNull] this IEnumerable source) => source as T[] ?? source.ToArray(); /// /// Performs the action on each item of the specified enumerable. If the enumerable contains items that are null, this /// method can either throw an exception or ignore the value (your delegate will not be called in this case). /// /// The item type of the enumerable. /// The collection containing the items that will be passed to the action. /// The action that executes for each item of the collection. /// The value indicating whether this method should throw a when any of the items is null (optional). Defaults to true. /// Thrown when or is null. /// Thrown when contains a value that is null and is set to true. public static IEnumerable ForEach([ValidatedNotNull] this IEnumerable enumerable, Action action, bool throwWhenItemIsNull = true) { // ReSharper disable PossibleMultipleEnumeration action.MustNotBeNull(nameof(action)); var i = 0; if (enumerable is IList list) { for (; i < list.Count; i++) { var item = list[i]; if (item is null) { if (throwWhenItemIsNull) throw new CollectionException(nameof(enumerable), $"The collection contains null at index {i}."); continue; } action(item); } } else { foreach (var item in enumerable.MustNotBeNull(nameof(enumerable))) { if (item is null) { if (throwWhenItemIsNull) throw new CollectionException(nameof(enumerable), $"The collection contains null at index {i}."); ++i; continue; } action(item); ++i; } } return enumerable; // ReSharper restore PossibleMultipleEnumeration } /// /// Tries to cast the specified enumerable as an , or /// creates a new containing the enumerable items. /// /// The item type of the enumerable. /// The enumerable to be transformed. /// The list containing the items of the enumerable. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("source:null => halt; source:notnull => notnull")] public static IReadOnlyList AsReadOnlyList([ValidatedNotNull] this IEnumerable source) => source as IReadOnlyList ?? source.ToList(); /// /// Tries to cast the specified enumerable as an , or /// creates a new collection containing the enumerable items by calling the specified delegate. /// /// The item type of the collection. /// The enumerable that will be converted to . /// The delegate that creates the collection containing the specified items. /// The cast enumerable, or a new collection containing the enumerable items. /// Thrown when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("source:null => halt; source:notnull => notnull; createCollection:null => halt")] public static IReadOnlyList AsReadOnlyList([ValidatedNotNull] this IEnumerable source, Func, IReadOnlyList> createCollection) => source as IReadOnlyList ?? createCollection.MustNotBeNull(nameof(createCollection))(source.MustNotBeNull(nameof(source))); /// /// Gets the count of the specified enumerable. /// /// The enumerable whose count should be determined. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("enumerable:null => halt")] public static int Count([ValidatedNotNull] this IEnumerable enumerable) { if (enumerable is ICollection collection) return collection.Count; if (enumerable is string @string) return @string.Length; return DetermineCountViaEnumerating(enumerable); } /// /// Gets the count of the specified enumerable. /// /// The enumerable whose count should be determined. /// The name of the parameter that is passed to the (optional). /// The message that is passed to the (optional). /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("enumerable:null => halt")] public static int Count([ValidatedNotNull] this IEnumerable? enumerable, string? parameterName, string? message) { if (enumerable is ICollection collection) return collection.Count; if (enumerable is string @string) return @string.Length; return DetermineCountViaEnumerating(enumerable, parameterName, message); } /// /// Gets the count of the specified enumerable. /// /// The enumerable whose count should be determined. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("enumerable:null => halt")] public static int GetCount(this IEnumerable enumerable) { if (enumerable is ICollection collection) return collection.Count; if (enumerable is string @string) return @string.Length; if (TryGetCollectionOfTCount(enumerable, out var count)) return count; return DetermineCountViaEnumerating(enumerable); } /// /// Gets the count of the specified enumerable. /// /// The enumerable whose count should be determined. /// The name of the parameter that is passed to the (optional). /// The message that is passed to the (optional). /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("enumerable:null => halt")] public static int GetCount(this IEnumerable enumerable, string? parameterName, string? message = null) { if (enumerable is ICollection collection) return collection.Count; if (enumerable is string @string) return @string.Length; if (TryGetCollectionOfTCount(enumerable, out var count)) return count; return DetermineCountViaEnumerating(enumerable, parameterName, message); } private static bool TryGetCollectionOfTCount([NoEnumeration] this IEnumerable enumerable, out int count) { if (enumerable is ICollection collectionOfT) { count = collectionOfT.Count; return true; } if (enumerable is IReadOnlyCollection readOnlyCollection) { count = readOnlyCollection.Count; return true; } count = 0; return false; } private static int DetermineCountViaEnumerating(IEnumerable? enumerable) { var count = 0; var enumerator = enumerable.MustNotBeNull(nameof(enumerable)).GetEnumerator(); while (enumerator.MoveNext()) count++; return count; } private static int DetermineCountViaEnumerating(IEnumerable? enumerable, string? parameterName, string? message) { var count = 0; var enumerator = enumerable.MustNotBeNull(parameterName, message).GetEnumerator(); while (enumerator.MoveNext()) count++; return count; } internal static bool ContainsViaForeach(this IEnumerable items, TItem item) { var equalityComparer = EqualityComparer.Default; foreach (var i in items) { if (equalityComparer.Equals(i, item)) return true; } return false; } } /// /// Provides extension methods for instances. /// internal static class ExpressionExtensions { /// /// Extracts the from a expression of the shape "object => object.Property". /// /// The object type. /// The type of the property. /// The expression where the property info will be extracted from. /// Thrown when is null. /// /// Throw when the is not of the shape "object => object.Property". /// public static PropertyInfo ExtractProperty([ValidatedNotNull] this Expression> expression) { expression.MustNotBeNull(nameof(expression)); var memberExpression = expression.Body as MemberExpression; if (!(memberExpression?.Member is PropertyInfo propertyInfo)) throw new ArgumentException("The specified expression is not valid. Please use an expression like the following one: o => o.Property", nameof(expression)); return propertyInfo; } /// /// Extracts the from a expression of the shape "object => object.Field". /// /// The object type. /// The type of the field. /// The expression where the field info will be extracted from. /// Thrown when is null. /// /// Throw when the is not of the shape "object => object.Field". /// public static FieldInfo ExtractField([ValidatedNotNull] this Expression> expression) { expression.MustNotBeNull(nameof(expression)); var memberExpression = expression.Body as MemberExpression; if (!(memberExpression?.Member is FieldInfo fieldInfo)) throw new ArgumentException("The specified expression is not valid. Please use an expression like the following one: o => o.Field", nameof(expression)); return fieldInfo; } } /// /// The class represents a simple non-cryptographic hash function that uses a prime number /// as seed and then manipulates this value by constantly performing hash = unchecked(hash * SecondPrime + value?.GetHashCode() ?? 0); /// for each given value. It is implemented according to the guidelines of Jon Skeet as stated in this Stack Overflow /// answer: http://stackoverflow.com/a/263416/1560623. IMPORTANT: do not persist any hash codes and rely on them /// to stay the same. Hash codes should only be used in memory within a single process session, usually for the use /// in dictionaries (hash tables) and sets. This algorithm, especially the prime numbers can change even during minor /// releases of Light.GuardClauses. /// internal static class MultiplyAddHash { /// /// This prime number is used as an initial (seed) value when calculating hash codes. Its value is 1322837333. /// public const int FirstPrime = 1322837333; /// /// The second prime number (397) used for hash code generation. It is applied using the following statement: /// hash = unchecked(hash * SecondPrime + value?.GetHashCode() ?? 0);. /// It is the same value that ReSharper (2018.1) uses for hash code generation. /// public const int SecondPrime = 397; /// /// Creates a hash code from the two specified values. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CreateHashCode(T1 value1, T2 value2) { var hash = FirstPrime; CombineIntoHash(ref hash, value1); CombineIntoHash(ref hash, value2); return hash; } /// /// Creates a hash code from the three specified values. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CreateHashCode(T1 value1, T2 value2, T3 value3) { var hash = FirstPrime; CombineIntoHash(ref hash, value1); CombineIntoHash(ref hash, value2); CombineIntoHash(ref hash, value3); return hash; } /// /// Creates a hash code from the four specified values. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CreateHashCode(T1 value1, T2 value2, T3 value3, T4 value4) { var hash = FirstPrime; CombineIntoHash(ref hash, value1); CombineIntoHash(ref hash, value2); CombineIntoHash(ref hash, value3); CombineIntoHash(ref hash, value4); return hash; } /// /// Creates a hash code from the five specified values. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CreateHashCode(T1 value1, T2 value2, T3 value3, T4 value4, T5 value5) { var hash = FirstPrime; CombineIntoHash(ref hash, value1); CombineIntoHash(ref hash, value2); CombineIntoHash(ref hash, value3); CombineIntoHash(ref hash, value4); CombineIntoHash(ref hash, value5); return hash; } /// /// Creates a hash code from the six specified values. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CreateHashCode(T1 value1, T2 value2, T3 value3, T4 value4, T5 value5, T6 value6) { var hash = FirstPrime; CombineIntoHash(ref hash, value1); CombineIntoHash(ref hash, value2); CombineIntoHash(ref hash, value3); CombineIntoHash(ref hash, value4); CombineIntoHash(ref hash, value5); CombineIntoHash(ref hash, value6); return hash; } /// /// Creates a hash code from the seven specified values. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CreateHashCode(T1 value1, T2 value2, T3 value3, T4 value4, T5 value5, T6 value6, T7 value7) { var hash = FirstPrime; CombineIntoHash(ref hash, value1); CombineIntoHash(ref hash, value2); CombineIntoHash(ref hash, value3); CombineIntoHash(ref hash, value4); CombineIntoHash(ref hash, value5); CombineIntoHash(ref hash, value6); CombineIntoHash(ref hash, value7); return hash; } /// /// Creates a hash code from the eight specified values. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CreateHashCode(T1 value1, T2 value2, T3 value3, T4 value4, T5 value5, T6 value6, T7 value7, T8 value8) { var hash = FirstPrime; CombineIntoHash(ref hash, value1); CombineIntoHash(ref hash, value2); CombineIntoHash(ref hash, value3); CombineIntoHash(ref hash, value4); CombineIntoHash(ref hash, value5); CombineIntoHash(ref hash, value6); CombineIntoHash(ref hash, value7); CombineIntoHash(ref hash, value8); return hash; } /// /// Creates a hash code from the nine specified values. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CreateHashCode(T1 value1, T2 value2, T3 value3, T4 value4, T5 value5, T6 value6, T7 value7, T8 value8, T9 value9) { var hash = FirstPrime; CombineIntoHash(ref hash, value1); CombineIntoHash(ref hash, value2); CombineIntoHash(ref hash, value3); CombineIntoHash(ref hash, value4); CombineIntoHash(ref hash, value5); CombineIntoHash(ref hash, value6); CombineIntoHash(ref hash, value7); CombineIntoHash(ref hash, value8); CombineIntoHash(ref hash, value9); return hash; } /// /// Creates a hash code from the ten specified values. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CreateHashCode(T1 value1, T2 value2, T3 value3, T4 value4, T5 value5, T6 value6, T7 value7, T8 value8, T9 value9, T10 value10) { var hash = FirstPrime; CombineIntoHash(ref hash, value1); CombineIntoHash(ref hash, value2); CombineIntoHash(ref hash, value3); CombineIntoHash(ref hash, value4); CombineIntoHash(ref hash, value5); CombineIntoHash(ref hash, value6); CombineIntoHash(ref hash, value7); CombineIntoHash(ref hash, value8); CombineIntoHash(ref hash, value9); CombineIntoHash(ref hash, value10); return hash; } /// /// Creates a hash code from the eleven specified values. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CreateHashCode(T1 value1, T2 value2, T3 value3, T4 value4, T5 value5, T6 value6, T7 value7, T8 value8, T9 value9, T10 value10, T11 value11) { var hash = FirstPrime; CombineIntoHash(ref hash, value1); CombineIntoHash(ref hash, value2); CombineIntoHash(ref hash, value3); CombineIntoHash(ref hash, value4); CombineIntoHash(ref hash, value5); CombineIntoHash(ref hash, value6); CombineIntoHash(ref hash, value7); CombineIntoHash(ref hash, value8); CombineIntoHash(ref hash, value9); CombineIntoHash(ref hash, value10); CombineIntoHash(ref hash, value11); return hash; } /// /// Creates a hash code from the eleven specified values. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CreateHashCode(T1 value1, T2 value2, T3 value3, T4 value4, T5 value5, T6 value6, T7 value7, T8 value8, T9 value9, T10 value10, T11 value11, T12 value12) { var hash = FirstPrime; CombineIntoHash(ref hash, value1); CombineIntoHash(ref hash, value2); CombineIntoHash(ref hash, value3); CombineIntoHash(ref hash, value4); CombineIntoHash(ref hash, value5); CombineIntoHash(ref hash, value6); CombineIntoHash(ref hash, value7); CombineIntoHash(ref hash, value8); CombineIntoHash(ref hash, value9); CombineIntoHash(ref hash, value10); CombineIntoHash(ref hash, value11); CombineIntoHash(ref hash, value12); return hash; } /// /// Creates a hash code from the thirteen specified values. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CreateHashCode(T1 value1, T2 value2, T3 value3, T4 value4, T5 value5, T6 value6, T7 value7, T8 value8, T9 value9, T10 value10, T11 value11, T12 value12, T13 value13) { var hash = FirstPrime; CombineIntoHash(ref hash, value1); CombineIntoHash(ref hash, value2); CombineIntoHash(ref hash, value3); CombineIntoHash(ref hash, value4); CombineIntoHash(ref hash, value5); CombineIntoHash(ref hash, value6); CombineIntoHash(ref hash, value7); CombineIntoHash(ref hash, value8); CombineIntoHash(ref hash, value9); CombineIntoHash(ref hash, value10); CombineIntoHash(ref hash, value11); CombineIntoHash(ref hash, value12); CombineIntoHash(ref hash, value13); return hash; } /// /// Creates a hash code from the fourteen specified values. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CreateHashCode(T1 value1, T2 value2, T3 value3, T4 value4, T5 value5, T6 value6, T7 value7, T8 value8, T9 value9, T10 value10, T11 value11, T12 value12, T13 value13, T14 value14) { var hash = FirstPrime; CombineIntoHash(ref hash, value1); CombineIntoHash(ref hash, value2); CombineIntoHash(ref hash, value3); CombineIntoHash(ref hash, value4); CombineIntoHash(ref hash, value5); CombineIntoHash(ref hash, value6); CombineIntoHash(ref hash, value7); CombineIntoHash(ref hash, value8); CombineIntoHash(ref hash, value9); CombineIntoHash(ref hash, value10); CombineIntoHash(ref hash, value11); CombineIntoHash(ref hash, value12); CombineIntoHash(ref hash, value13); CombineIntoHash(ref hash, value14); return hash; } /// /// Creates a hash code from the fifteen specified values. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CreateHashCode(T1 value1, T2 value2, T3 value3, T4 value4, T5 value5, T6 value6, T7 value7, T8 value8, T9 value9, T10 value10, T11 value11, T12 value12, T13 value13, T14 value14, T15 value15) { var hash = FirstPrime; CombineIntoHash(ref hash, value1); CombineIntoHash(ref hash, value2); CombineIntoHash(ref hash, value3); CombineIntoHash(ref hash, value4); CombineIntoHash(ref hash, value5); CombineIntoHash(ref hash, value6); CombineIntoHash(ref hash, value7); CombineIntoHash(ref hash, value8); CombineIntoHash(ref hash, value9); CombineIntoHash(ref hash, value10); CombineIntoHash(ref hash, value11); CombineIntoHash(ref hash, value12); CombineIntoHash(ref hash, value13); CombineIntoHash(ref hash, value14); CombineIntoHash(ref hash, value15); return hash; } /// /// Creates a hash code from the sixteen specified values. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static int CreateHashCode(T1 value1, T2 value2, T3 value3, T4 value4, T5 value5, T6 value6, T7 value7, T8 value8, T9 value9, T10 value10, T11 value11, T12 value12, T13 value13, T14 value14, T15 value15, T16 value16) { var hash = FirstPrime; CombineIntoHash(ref hash, value1); CombineIntoHash(ref hash, value2); CombineIntoHash(ref hash, value3); CombineIntoHash(ref hash, value4); CombineIntoHash(ref hash, value5); CombineIntoHash(ref hash, value6); CombineIntoHash(ref hash, value7); CombineIntoHash(ref hash, value8); CombineIntoHash(ref hash, value9); CombineIntoHash(ref hash, value10); CombineIntoHash(ref hash, value11); CombineIntoHash(ref hash, value12); CombineIntoHash(ref hash, value13); CombineIntoHash(ref hash, value14); CombineIntoHash(ref hash, value15); CombineIntoHash(ref hash, value16); return hash; } /// /// Mutates the given hash with the specified value using the following statement: /// hash = unchecked(hash * SecondPrime + value?.GetHashCode() ?? 0);. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static void CombineIntoHash(ref int hash, T value) => hash = unchecked(hash * SecondPrime + value?.GetHashCode() ?? 0); } /// /// Represents a builder for the algorithm that does not allocate. /// Should only be used in cases where the overload for sixteen values is not enough or a dedicated /// initial hash must be provided (e.g. for test reasons). /// Instantiate the builder with the method. You have to instantiate a new builder /// for each hash code that you want to calculate. /// internal struct MultiplyAddHashBuilder { private int _hash; [MethodImpl(MethodImplOptions.AggressiveInlining)] private MultiplyAddHashBuilder(int initialHash) => _hash = initialHash; /// /// Combines the given value into the hash using the method. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public MultiplyAddHashBuilder CombineIntoHash(T value) { MultiplyAddHash.CombineIntoHash(ref _hash, value); return this; } /// /// Returns the calculated hash code. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public int BuildHash() => _hash; /// /// Initializes a new instance of with the specified initial hash. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static MultiplyAddHashBuilder Create(int initialHash = MultiplyAddHash.FirstPrime) => new MultiplyAddHashBuilder(initialHash); } /// /// Provides extension methods for and to easily assembly error messages. /// internal static class TextExtensions { /// /// Gets the default NewLineSeparator. This value is $",{Environment.NewLine}". /// public static readonly string DefaultNewLineSeparator = ',' + Environment.NewLine; /// /// Gets the list of types that will not be surrounded by quotation marks in error messages. /// public static readonly ReadOnlyCollection UnquotedTypes = new ReadOnlyCollection(new[] { typeof(int), typeof(long), typeof(short), typeof(sbyte), typeof(uint), typeof(ulong), typeof(ushort), typeof(byte), typeof(bool), typeof(double), typeof(decimal), typeof(float) }); private static bool IsUnquotedType() { if (typeof(T) == typeof(int)) return true; if (typeof(T) == typeof(long)) return true; if (typeof(T) == typeof(short)) return true; if (typeof(T) == typeof(sbyte)) return true; if (typeof(T) == typeof(uint)) return true; if (typeof(T) == typeof(ulong)) return true; if (typeof(T) == typeof(ushort)) return true; if (typeof(T) == typeof(byte)) return true; if (typeof(T) == typeof(bool)) return true; if (typeof(T) == typeof(double)) return true; if (typeof(T) == typeof(decimal)) return true; if (typeof(T) == typeof(float)) return true; return false; } /// /// Returns the string representation of , or if is null. /// If the type of is not one of , then quotation marks will be put around the string representation. /// /// The item whose string representation should be returned. /// The text that is returned when is null (defaults to "null"). [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("=> notnull")] public static string ToStringOrNull(this T value, string nullText = "null") => value?.ToStringRepresentation() ?? nullText; /// /// Returns the string representation of . This is done by calling . If the type of /// is not one of , then the resulting string will be wrapped in quotation marks. /// /// The value whose string representation is requested. [ContractAnnotation("value:null => halt; value:notnull => notnull")] public static string? ToStringRepresentation([ValidatedNotNull] this T value) { value.MustNotBeNullReference(nameof(value)); var content = value!.ToString(); if (IsUnquotedType() || content.IsNullOrEmpty()) return content; // ReSharper disable UseIndexFromEndExpression -- not possible in netstandard2.0 if (content.Length <= 126) { Span span = stackalloc char[content.Length + 2]; span[0] = span[span.Length - 1] = '"'; content.AsSpan().CopyTo(span.Slice(1, content.Length)); return span.ToString(); } var contentWithQuotationMarks = new char[content.Length + 2]; contentWithQuotationMarks[0] = contentWithQuotationMarks[contentWithQuotationMarks.Length - 1] = '"'; // ReSharper restore UseIndexFromEndExpression content.CopyTo(0, contentWithQuotationMarks, 1, content.Length); return new string (contentWithQuotationMarks); } /// /// Appends the content of the collection with the specified header line to the string builder. /// Each item is on a new line. /// /// The item type of the collection. /// The string builder that the content is appended to. /// The collection whose items will be appended to the string builder. /// The string that will be placed before the actual items as a header. /// The value indicating if a new line is added after the last item. This value defaults to true. /// Thrown when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("stringBuilder:null => halt; items:null => halt; stringBuilder:notnull => notnull")] public static StringBuilder AppendCollectionContent([ValidatedNotNull] this StringBuilder stringBuilder, [ValidatedNotNull] IEnumerable items, string headerLine = "Content of the collection:", bool finishWithNewLine = true) => stringBuilder.MustNotBeNull(nameof(stringBuilder)).AppendLine(headerLine).AppendItemsWithNewLine(items, finishWithNewLine: finishWithNewLine); /// /// Appends the string representations of the specified items to the string builder. /// /// The string builder where the items will be appended to. /// The items to be appended. /// The characters used to separate the items. Defaults to ", " and is not appended after the last item. /// The text that is appended to the string builder when is empty. Defaults to "empty collection". /// Thrown when or is null. [ContractAnnotation("stringBuilder:null => halt; items:null => halt; stringBuilder:notnull => notnull")] public static StringBuilder AppendItems([ValidatedNotNull] this StringBuilder stringBuilder, [ValidatedNotNull] IEnumerable items, string itemSeparator = ", ", string emptyCollectionText = "empty collection") { stringBuilder.MustNotBeNull(nameof(stringBuilder)); var list = items.MustNotBeNull(nameof(items)).AsList(); var currentIndex = 0; var itemsCount = list.Count; if (itemsCount == 0) return stringBuilder.Append(emptyCollectionText); while (true) { stringBuilder.Append(list[currentIndex].ToStringOrNull()); if (currentIndex < itemsCount - 1) stringBuilder.Append(itemSeparator); else return stringBuilder; ++currentIndex; } } /// /// Appends the string representations of the specified items to the string builder. Each item is on its own line. /// /// The string builder where the items will be appended to. /// The items to be appended. /// The text that is appended to the string builder when is empty. Defaults to "empty collection". /// The value indicating if a new line is added after the last item. This value defaults to true. /// Thrown when or is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("stringBuilder:null => halt; items:null => halt; stringBuilder:notnull => notnull")] public static StringBuilder AppendItemsWithNewLine([ValidatedNotNull] this StringBuilder stringBuilder, [ValidatedNotNull] IEnumerable items, string emptyCollectionText = "empty collection", bool finishWithNewLine = true) => stringBuilder.AppendItems(items, DefaultNewLineSeparator, emptyCollectionText).AppendLineIf(finishWithNewLine); /// /// Appends the value to the specified string builder if the condition is true. /// /// The string builder where will be appended to. /// The boolean value indicating whether the append will be performed or not. /// The value to be appended to the string builder. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("stringBuilder:null => halt; stringBuilder:notnull => notnull")] public static StringBuilder AppendIf([ValidatedNotNull] this StringBuilder stringBuilder, bool condition, string value) { if (condition) stringBuilder.MustNotBeNull(nameof(stringBuilder)).Append(value); return stringBuilder; } /// /// Appends the value followed by a new line separator to the specified string builder if the condition is true. /// /// The string builder where will be appended to. /// The boolean value indicating whether the append will be performed or not. /// The value to be appended to the string builder (optional). This value defaults to an empty string. /// Thrown when is null. [MethodImpl(MethodImplOptions.AggressiveInlining)] [ContractAnnotation("stringBuilder:null => halt; stringBuilder:notnull => notnull")] public static StringBuilder AppendLineIf([ValidatedNotNull] this StringBuilder stringBuilder, bool condition, string value = "") { if (condition) stringBuilder.MustNotBeNull(nameof(stringBuilder)).AppendLine(value); return stringBuilder; } /// /// Appends the messages of the and its nested exceptions to the /// specified . /// /// Thrown when any parameter is null. public static StringBuilder AppendExceptionMessages([ValidatedNotNull] this StringBuilder stringBuilder, [ValidatedNotNull] Exception exception) { stringBuilder.MustNotBeNull(nameof(stringBuilder)); exception.MustNotBeNull(nameof(exception)); while (true) { // ReSharper disable once PossibleNullReferenceException stringBuilder.AppendLine(exception.Message); if (exception.InnerException is null) return stringBuilder; stringBuilder.AppendLine(); exception = exception.InnerException; } } /// /// Formats all messages of the and its nested exceptions into /// a single string. /// /// Thrown when is null. public static string GetAllExceptionMessages([ValidatedNotNull] this Exception exception) => new StringBuilder().AppendExceptionMessages(exception).ToString(); /// /// Checks if the two strings are equal using ordinal sorting rules as well as ignoring the white space /// of the provided strings. /// public static bool EqualsOrdinalIgnoreWhiteSpace(this string? x, string? y) { if (ReferenceEquals(x, y)) return true; if (x is null || y is null) return false; if (x.Length == 0) return y.Length == 0; var indexX = 0; var indexY = 0; bool wasXSuccessful; bool wasYSuccessful; // This condition of the while loop actually has to use the single '&' operator because // y.TryAdvanceToNextNonWhiteSpaceCharacter must be called even though it already returned // false on x. Otherwise the 'wasXSuccessful == wasYSuccessful' comparison would not return // the desired result. while ((wasXSuccessful = x.TryAdvanceToNextNonWhiteSpaceCharacter(ref indexX)) & (wasYSuccessful = y.TryAdvanceToNextNonWhiteSpaceCharacter(ref indexY))) { if (x[indexX++] != y[indexY++]) return false; } return wasXSuccessful == wasYSuccessful; } /// /// Checks if the two strings are equal using ordinal sorting rules, ignoring the case of the letters /// as well as ignoring the white space of the provided strings. /// public static bool EqualsOrdinalIgnoreCaseIgnoreWhiteSpace(this string? x, string? y) { if (ReferenceEquals(x, y)) return true; if (x is null || y is null) return false; if (x.Length == 0) return y.Length == 0; var indexX = 0; var indexY = 0; bool wasXSuccessful; bool wasYSuccessful; // This condition of the while loop actually has to use the single '&' operator because // y.TryAdvanceToNextNonWhiteSpaceCharacter must be called even though it already returned // false on x. Otherwise the 'wasXSuccessful == wasYSuccessful' comparison would not return // the desired result. while ((wasXSuccessful = x.TryAdvanceToNextNonWhiteSpaceCharacter(ref indexX)) & (wasYSuccessful = y.TryAdvanceToNextNonWhiteSpaceCharacter(ref indexY))) { if (char.ToLowerInvariant(x[indexX++]) != char.ToLowerInvariant(y[indexY++])) return false; } return wasXSuccessful == wasYSuccessful; } private static bool TryAdvanceToNextNonWhiteSpaceCharacter(this string @string, ref int currentIndex) { while (currentIndex < @string.Length) { if (!char.IsWhiteSpace(@string[currentIndex])) return true; ++currentIndex; } return false; } } } /* License information for JetBrains.Annotations MIT License Copyright (c) 2016 JetBrains http://www.jetbrains.com Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and / or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ namespace JetBrains.Annotations { /// /// Indicates that the value of the marked element can never be null. /// /// /// [NotNull] object Foo() { /// return null; // Warning: Possible 'null' assignment /// } /// [AttributeUsage(AttributeTargets.Method | AttributeTargets.Parameter | AttributeTargets.Property | AttributeTargets.Delegate | AttributeTargets.Field | AttributeTargets.Event | AttributeTargets.Class | AttributeTargets.Interface | AttributeTargets.GenericParameter)] internal sealed class NotNullAttribute : Attribute { } /// /// Describes dependence between method input and output. /// /// ///

Function Definition Table syntax:

/// /// FDT ::= FDTRow [;FDTRow]* /// FDTRow ::= Input => Output | Output <= Input /// Input ::= ParameterName: Value [, Input]* /// Output ::= [ParameterName: Value]* {halt|stop|void|nothing|Value} /// Value ::= true | false | null | notnull | canbenull /// /// If the method has a single input parameter, its name could be omitted.
/// Using halt (or void/nothing, which is the same) for the method output /// means that the method doesn't return normally (throws or terminates the process).
/// Value canbenull is only applicable for output parameters.
/// You can use multiple [ContractAnnotation] for each FDT row, or use single attribute /// with rows separated by the semicolon. There is no notion of order rows, all rows are checked /// for applicability and applied per each program state tracked by the analysis engine.
/// /// /// /// [ContractAnnotation("=> halt")] /// public void TerminationMethod() /// /// /// [ContractAnnotation("null <= param:null")] // reverse condition syntax /// public string GetName(string surname) /// /// /// [ContractAnnotation("s:null => true")] /// public bool IsNullOrEmpty(string s) // string.IsNullOrEmpty() /// /// /// // A method that returns null if the parameter is null, /// // and not null if the parameter is not null /// [ContractAnnotation("null => null; notnull => notnull")] /// public object Transform(object data) /// /// /// [ContractAnnotation("=> true, result: notnull; => false, result: null")] /// public bool TryParse(string s, out Person result) /// /// [AttributeUsage(AttributeTargets.Method, AllowMultiple = true)] internal sealed class ContractAnnotationAttribute : Attribute { public ContractAnnotationAttribute([NotNull] string contract) : this(contract, false) { } public ContractAnnotationAttribute([NotNull] string contract, bool forceFullStates) { Contract = contract; ForceFullStates = forceFullStates; } [NotNull] public string Contract { get; } public bool ForceFullStates { get; } } /// /// Indicates that IEnumerable passed as a parameter is not enumerated. /// Use this annotation to suppress the 'Possible multiple enumeration of IEnumerable' inspection. /// /// /// static void ThrowIfNull<T>([NoEnumeration] T v, string n) where T : class /// { /// // custom check for null but no enumeration /// } /// /// void Foo(IEnumerable<string> values) /// { /// ThrowIfNull(values, nameof(values)); /// var x = values.ToList(); // No warnings about multiple enumeration /// } /// [AttributeUsage(AttributeTargets.Parameter)] internal sealed class NoEnumerationAttribute : Attribute { } } namespace System.Diagnostics.CodeAnalysis { /// /// Specifies that is allowed as an input even if the /// corresponding type disallows it. /// [AttributeUsage(AttributeTargets.Field | AttributeTargets.Parameter | AttributeTargets.Property, Inherited = false)] internal sealed class AllowNullAttribute : Attribute { /// /// Initializes a new instance of the class. /// public AllowNullAttribute() { } } /// /// Specifies that is disallowed as an input even if the /// corresponding type allows it. /// [AttributeUsage(AttributeTargets.Field | AttributeTargets.Parameter | AttributeTargets.Property, Inherited = false)] internal sealed class DisallowNullAttribute : Attribute { /// /// Initializes a new instance of the class. /// public DisallowNullAttribute() { } } /// /// Specifies that a method that will never return under any circumstance. /// [AttributeUsage(AttributeTargets.Method, Inherited = false)] internal sealed class DoesNotReturnAttribute : Attribute { /// /// Initializes a new instance of the class. /// public DoesNotReturnAttribute() { } } /// /// Specifies that the method will not return if the associated /// parameter is passed the specified value. /// [AttributeUsage(AttributeTargets.Parameter, Inherited = false)] internal sealed class DoesNotReturnIfAttribute : Attribute { /// /// Gets the condition parameter value. /// Code after the method is considered unreachable by diagnostics if the argument /// to the associated parameter matches this value. /// public bool ParameterValue { get; } /// /// Initializes a new instance of the /// class with the specified parameter value. /// /// /// The condition parameter value. /// Code after the method is considered unreachable by diagnostics if the argument /// to the associated parameter matches this value. /// public DoesNotReturnIfAttribute(bool parameterValue) { ParameterValue = parameterValue; } } /// /// Specifies that an output may be even if the /// corresponding type disallows it. /// [AttributeUsage(AttributeTargets.Field | AttributeTargets.Parameter | AttributeTargets.Property | AttributeTargets.ReturnValue, Inherited = false)] internal sealed class MaybeNullAttribute : Attribute { /// /// Initializes a new instance of the class. /// public MaybeNullAttribute() { } } /// /// Specifies that when a method returns , /// the parameter may be even if the corresponding type disallows it. /// [AttributeUsage(AttributeTargets.Parameter, Inherited = false)] internal sealed class MaybeNullWhenAttribute : Attribute { /// /// Gets the return value condition. /// If the method returns this value, the associated parameter may be . /// public bool ReturnValue { get; } /// /// Initializes the attribute with the specified return value condition. /// /// /// The return value condition. /// If the method returns this value, the associated parameter may be . /// public MaybeNullWhenAttribute(bool returnValue) { ReturnValue = returnValue; } } /// /// Specifies that an output is not even if the /// corresponding type allows it. /// [AttributeUsage(AttributeTargets.Field | AttributeTargets.Parameter | AttributeTargets.Property | AttributeTargets.ReturnValue, Inherited = false)] internal sealed class NotNullAttribute : Attribute { /// /// Initializes a new instance of the class. /// public NotNullAttribute() { } } /// /// Specifies that the output will be non- if the /// named parameter is non-. /// [AttributeUsage(AttributeTargets.Parameter | AttributeTargets.Property | AttributeTargets.ReturnValue, AllowMultiple = true, Inherited = false)] internal sealed class NotNullIfNotNullAttribute : Attribute { /// /// Gets the associated parameter name. /// The output will be non- if the argument to the /// parameter specified is non-. /// public string ParameterName { get; } /// /// Initializes the attribute with the associated parameter name. /// /// /// The associated parameter name. /// The output will be non- if the argument to the /// parameter specified is non-. /// public NotNullIfNotNullAttribute(string parameterName) { ParameterName = parameterName; } } /// /// Specifies that when a method returns , /// the parameter will not be even if the corresponding type allows it. /// [AttributeUsage(AttributeTargets.Parameter, Inherited = false)] internal sealed class NotNullWhenAttribute : Attribute { /// /// Gets the return value condition. /// If the method returns this value, the associated parameter will not be . /// public bool ReturnValue { get; } /// /// Initializes the attribute with the specified return value condition. /// /// /// The return value condition. /// If the method returns this value, the associated parameter will not be . /// public NotNullWhenAttribute(bool returnValue) { ReturnValue = returnValue; } } } namespace System.Runtime.CompilerServices { [AttributeUsage(AttributeTargets.Parameter, AllowMultiple = false, Inherited = false)] internal sealed class CallerArgumentExpressionAttribute : Attribute { public CallerArgumentExpressionAttribute(string parameterName) { ParameterName = parameterName; } public string ParameterName { get; } } }Light.GuardClauses-12.0.0/README.md000066400000000000000000000156271470750352700165260ustar00rootroot00000000000000# Light.GuardClauses **A lightweight .NET library for expressive Guard Clauses.** [![License](https://img.shields.io/badge/License-MIT-green.svg?style=for-the-badge)](https://github.com/feO2x/Light.GuardClauses/blob/master/LICENSE) [![NuGet](https://img.shields.io/badge/NuGet-12.0.0-blue.svg?style=for-the-badge)](https://www.nuget.org/packages/Light.GuardClauses/) [![Source Code](https://img.shields.io/badge/Source%20Code-12.0.0-blue.svg?style=for-the-badge)](https://github.com/feO2x/Light.GuardClauses/blob/master/Light.GuardClauses.SingleFile.cs) [![Documentation](https://img.shields.io/badge/Docs-Wiki-yellowgreen.svg?style=for-the-badge)](https://github.com/feO2x/Light.GuardClauses/wiki) [![Documentation](https://img.shields.io/badge/Docs-Changelog-yellowgreen.svg?style=for-the-badge)](https://github.com/feO2x/Light.GuardClauses/releases) ## Light.GuardClauses - easy precondition checks in C# / .NET [Read the full docs in the Wiki](https://github.com/feO2x/Light.GuardClauses/wiki) As a software developer, you're used to writing `if` statements at the beginning of your methods which validate the parameters that are passed in. Most often you'll probably check for null: ```csharp public class Foo { private readonly IBar _bar; public Foo(IBar? bar) { if (bar == null) throw new ArgumentNullException(nameof(bar)); _bar = bar; } } ``` **Light.GuardClauses** simplifies these precondition checks for you by providing extension methods that you can directly call on your parameters: ```csharp public class Foo { private readonly IBar _bar; public Foo(IBar? bar) { _bar = bar.MustNotBeNull(); } } ``` > As of version 10, Light.GuardClauses supports the [CallerArgumentExpressionAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.callerargumentexpressionattribute) of C# 10. If your C# compiler is on a lower version, then the `CallerArgumentExpressionAttribute` might not be respected - you should then call all assertions with an explicit parameter name, e.g. `bar.MustNotBeNull(nameof(bar))`. You can use the C# 10 compiler by e.g. installing .NET 6 and/or Visual Studio 2022. The `CallerArgumentExpressionAttribute` is backwards-compatible, so it can be used with projects targeting .NET Standard 2, .NET Framework, or .NET Core. By using **Light.GuardClauses**, you'll gain access to assertions for a vast amount of scenarios like checking strings, collections, enums, URIs, `DateTime`, `Type`, `IComparable`, `IEnumerable`, `IEnumerable`, and `Span`. Just have a look at these examples: ```csharp public class ConsoleWriter { private readonly ConsoleColor _foregroundColor; public ConsoleWriter(ConsoleColor foregroundColor = ConsoleColor.Black) => _foregroundColor = foregroundColor.MustBeValidEnumValue(); } ``` ```csharp public void SetMovieRating(Guid movieId, int numberOfStars) { movieId.MustNotBeEmpty(); numberOfStars.MustBeIn(Range.InclusiveBetween(0, 5)); var movie = _movieRepo.GetById(movieId); movie.AddRating(numberOfStars); } ``` ```csharp public class WebGateway { private readonly HttpClient _httpClient; private readonly Uri _targetUrl; public WebGateway(HttpClient? httpClient, Uri? targetUrl) { _httpClient = httpClient.MustNotBeNull(); _targetUrl = targetUrl.MustBeHttpOrHttpsUrl(); } } ``` In addition to assertions that throw exceptions (all these start with `Must`), **Light.GuardClauses** provides assertions that return a Boolean. Some examples are: - `string.IsNullOrWhitespace()` - `collection.IsNullOrEmpty()` - `enum.IsValidEnumValue()` You can use these in your branching logic to easily check if an assertion is true or false. Every assertion is well-documented - explore them using IntelliSense or check out [this overview](https://github.com/feO2x/Light.GuardClauses/wiki/Overview-of-All-Assertions). ## Light.GuardClauses is optimized Since version 4, **Light.GuardClauses** is optimized for performance (measured in .NET 4.8 and .NET 6). With the incredible help of [@redknightlois](https://github.com/redknightlois) and the awesome tool [BenchmarkDotNet](https://github.com/dotnet/BenchmarkDotNet), most assertions are as fast as your imperative code would be. **Light.GuardClauses** has support for [.NET analyzers / FxCopAnalyzers](https://docs.microsoft.com/en-us/dotnet/fundamentals/code-analysis/overview) with the `ValidatedNotNullAttribute`. Analyzers will know when an assertion validated that a parameters is not null and consequently, CA1062 will not be raised. Furthermore, **Light.GuardClauses** has support for ReSharper since version 4.x. Via [Contract Annotations](https://www.jetbrains.com/help/resharper/Contract_Annotations.html), R# knows when assertions do not return a null value and thus removes squiggly lines indicating a possible `NullReferenceException`. Since version 10.1.0, Light.GuardClauses also annotates assertions that do not iterate over an `IEnumerable` with ReSharper's `NoEnumerationAttribute` - ReSharper will then not indicate a "Possible multiple enumeration" (thanks to [cdonnellytx](https://github.com/cdonnellytx) for this contribution). Since version 11, Light.GuardClauses supports Native AOT. **Light.GuardClauses** supports C#8 Nullable Reference Types since version 8.0. And, of course, the functional correctness of **Light.GuardClauses** is covered by a vast suite of automated tests. ## Supported Platforms **Light.GuardClauses** is built against [.NET Standard 2.0 and 2.1](https://docs.microsoft.com/en-us/dotnet/standard/net-standard), thus it can be used in frameworks like .NET 6, .NET 7, .NET Framework 4.6.1 or newer, Unity, Mono, or UWP. ## How to Install Light.GuardClauses is available as a [NuGet package](https://www.nuget.org/packages/Light.GuardClauses/). - **dotnet CLI**: `dotnet add package Light.GuardClauses` - **Visual Studio Package Manager Console**: `Install-Package Light.GuardClauses` - **Package Reference in csproj**: `` Also, you can incorporate Light.GuardClauses as a **single source file** where the API is changed to `internal`. This is especially interesting for framework / library developers that do not want to have a dependency on the Light.GuardClauses DLL. You can grab the default .NET Standard 2.0 version in [Light.GuardClauses.SingleFile.cs](https://github.com/feO2x/Light.GuardClauses/blob/master/Light.GuardClauses.SingleFile.cs) or you can use the [Light.GuardClauses.SourceCodeTransformation](https://github.com/feO2x/Light.GuardClauses/tree/master/Code/Light.GuardClauses.SourceCodeTransformation) project to create your custom file. You can learn more about it [here](https://github.com/feO2x/Light.GuardClauses/wiki/Including-Light.GuardClauses-as-source-code). ## Let there be... Light ![Light Libraries Logo](https://raw.githubusercontent.com/feO2x/Light.GuardClauses/main/Images/light_logo.png)