LPRun 8.3.3

dotnet add package LPRun --version 8.3.3
NuGet\Install-Package LPRun -Version 8.3.3
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="LPRun" Version="8.3.3" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add LPRun --version 8.3.3
#r "nuget: LPRun, 8.3.3"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install LPRun as a Cake Addin
#addin nuget:?package=LPRun&version=8.3.3

// Install LPRun as a Cake Tool
#tool nuget:?package=LPRun&version=8.3.3

LINQPad Driver LPRun Unit/Integration Tests Runner

Latest build NuGet Downloads License

Table of Contents

Description

LINQPad driver LPRun unit/integration tests runner. Can be used for testing LINQPad 8/LINQPad 7/LINQPad 6 drivers using LPRun or for running LINQPad scripts.

LPRun .NET Versions

.NET versions supported by LPRun are listed below. In case of unsupported version LPRun fallbacks to the latest production .NET installed.

LPRun .NET 8.0 .NET 7.0 .NET 6.0 .NET 5.0 .NET 3.1
8 ✔️ ✔️ ✔️
7 ✔️ ✔️ ✔️ ✔️

Use the following script to check the .NET version used by LPRun:

<Query Kind="Expression"/>

System.Environment.Version

Website

LPRun is a part of the CsvLINQPadDriver for LINQPad 8/7/6/5. LPRun source code can be found here.

Download

NuGet

Usage

Tested driver MUST NOT be installed via NuGet into LINQPad. In this case LPRun will use it instead of local one.

Setup

  1. Create test project.
  2. Add LPRun NuGet
  3. Create the following folder structure in test project:
LPRun # Created by LPRun NuGet.
    Templates # LINQPad script templates.
    Data      # Optional: Driver data files.

LINQPad Test Script Example

LPRun executes LINQPad test script. Test script uses Fluent Assertions for assertion checks.

StringComparison.linq LINQPad test script example:

var original = Books.First();
var copy = original with { Title = original.Title.ToUpper() };

var expectedEquality = original.Title.Equals(copy.Title, context.StringComparison);

original.Equals(copy).Should().Be(expectedEquality, Reason());

original.GetHashCode()
    .Equals(copy.GetHashCode())
    .Should()
    .Be(expectedEquality, Reason());

Reason() method (prints exact line number if assertion fails) and context variable are injected by test below.

NUnit Test Example

Full NUnit test code can be found here.

[TestFixture]
public class LPRunTests
{
    [OneTimeSetUp]
    public void Init()
    {
        // Check that driver is not installed via NuGet.
        Driver.EnsureNotInstalledViaNuGet("CsvLINQPadDriver");

        // Install driver.
        Driver.InstallWithDepsJson(
            // The directory to copy driver files to.
            "CsvLINQPadDriver",
            // The LINQPad driver files.
            "CsvLINQPadDriver.dll",
            // The test folder path.
            "Tests");
    }

    [Test]
    [TestCaseSource(nameof(TestsData))]
    public async Task Execute_ScriptWithDriverProperties_Success(
        (string linqScriptName,
         string? context,
         ICsvDataContextDriverProperties driverProperties) testData)
    {
        var (linqScriptName, context, driverProperties) = testData;

        // Arrange: Create query connection header. Custom code can be added here.
        var queryConfig = GetQueryHeaders().Aggregate(
            new StringBuilder(),
            (stringBuilder, h) =>
        {
            stringBuilder.AppendLine(h);
            stringBuilder.AppendLine();
            return stringBuilder;
        }).ToString();

        // Arrange: Create test LNQPad script.
        // You can also use LinqScript.FromScript method.
        var linqScript = LinqScript.FromFile(
            $"{linqScriptName}.linq",
            queryConfig);

        // Act: Execute test LNQPad script.
        var (output, error, exitCode) =
            await Runner.ExecuteAsync(linqScript);

        // Assert.
        error.Should().BeNullOrWhiteSpace();
        exitCode.Should().Be(0);

        // Helpers.
        IEnumerable<string> GetQueryHeaders()
        {
            // Connection header.
            yield return ConnectionHeader.Get(
                "CsvLINQPadDriver",
                "CsvLINQPadDriver.CsvDataContextDriver",
                driverProperties,
                "System.Runtime.CompilerServices");

            // FluentAssertions helper.
            yield return
                 "string Reason([CallerLineNumber] int sourceLineNumber = 0) =>" +
                @" $""something went wrong at line #{sourceLineNumber}"";";

            // Test context.
            if (!string.IsNullOrWhiteSpace(context))
            {
                yield return $"var context = {context};";
            }
        }
    }

    private static IEnumerable<
        (string linqScriptName,
         string? context,
         ICsvDataContextDriverProperties driverProperties)> TestsData()
    {
        // Omitted for brevity.
    }
}

Tests can also be run in parallel:

[TestFixture]
public class LPRunTests
{
    [Test]
    [Parallelizable(ParallelScope.Children)]
    [TestCaseSource(nameof(ParallelizableTestsData))]
    public void Execute_ScriptWithDriverProperties_Success(
        (string linqScriptName,
         string? context,
         ICsvDataContextDriverProperties driverProperties,
         int index) testData)
    {
        // ...

        // Arrange: Create test LNQPad script.
        // You can also use LinqScript.FromScript method.
        var linqScript = LinqScript.FromFile(
            $"{linqScriptName}.linq",
            queryConfig,
            $"{linqScriptName}_{testData.index}");

        // ...
    }

    private static IEnumerable<
        (string linqScriptName,
         string? context,
         ICsvDataContextDriverProperties driverProperties,
         int index)> TestsData()
    {
        // Omitted for brevity.
    }

    // Parallelized tests data.
    private static IEnumerable<
        (string linqScriptName,
         string? context,
         ICsvDataContextDriverProperties driverProperties,
         int index)> ParallelizableTestsData() =>
        TestsData().AugmentWithFileIndex(
            static testData => testData.linqScriptName,
            static (testData, index) => { testData.index = index; return testData; });
}

Known Issues

Unit-testing Frameworks Support

Tested with NUnit. Other test frameworks should work as well.

LINQPad Runtime Reference

Avoid referencing LINQPad.Runtime.dll in your tests, e.g. for Moq:

// LINQPad.Runtime.dll IConnectionInfo reference:
var connectionInfoMock = new Mock<LINQPad.Extensibility.DataContext.IConnectionInfo>();
var driverProperties   = new DriverProperties(connectionInfoMock.Object);

This code compiles but fails in runtime with Could not load file or assembly LINQPad.Runtime error. If you still need to reference it, add the following target which copies assembly to output folder of the test project:

<Target Name="CopyLINQPadRuntimeToOutput" AfterTargets="Build">
  <Copy SourceFiles="$(OutputPath)\LPRun\Bin\LINQPad.Runtime.dll" DestinationFolder="$(OutputPath)" UseHardlinksIfPossible="true" />
</Target>

Your can avoid referencing LINQPad.Runtime.dll assembly by using mock framework facilities, e.g. for Moq you can extract IDriverProperties interface and setup driver properties as follows:

var driverProperties = Mock.Of<IDriverProperties>(props =>
    props.BoolProp   == true     &&
    props.IntProp    == 42       &&
    props.StringProp == "string"
);

Authors

Credits

Tools

NuGet

Licenses

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.1 is compatible. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • .NETStandard 2.1

    • No dependencies.
  • net6.0

    • No dependencies.
  • net7.0

    • No dependencies.
  • net8.0

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
8.3.3 118 3/21/2024
8.3.2 180 3/13/2024
8.3.1 118 3/12/2024
8.2.4 101 2/17/2024
8.2.3 105 2/13/2024
8.2.2 139 1/23/2024
8.1.6 100 1/17/2024
8.1.3 175 1/3/2024
8.1.2 172 12/27/2023
8.1.1 138 12/22/2023
8.0.18 206 12/5/2023
8.0.17 167 11/26/2023
8.0.16 176 11/25/2023
8.0.15 144 11/24/2023
8.0.14 140 11/22/2023
8.0.13 147 11/18/2023
8.0.12 150 11/17/2023
8.0.11 103 11/16/2023
8.0.10 167 11/15/2023
8.0.9 162 11/12/2023
7.8.10 99 2/14/2024
7.8.7 188 11/26/2023
7.8.6 297 9/14/2023
7.8.5 356 8/1/2023
7.8.4 281 7/13/2023
7.8.3 259 7/3/2023
7.8.2 262 6/16/2023
7.8.1 260 6/9/2023
7.7.15 247 5/31/2023
7.7.14 247 5/29/2023
7.7.13 242 5/23/2023
7.7.12 265 5/18/2023
7.7.11 296 5/10/2023
7.7.10 368 4/19/2023
7.7.9 371 4/4/2023
7.7.8 400 4/4/2023
7.7.7 459 3/21/2023
7.7.6 455 3/18/2023
7.7.4 381 3/13/2023
7.7.3 448 2/20/2023
7.7.2 373 2/13/2023
7.7.1 433 2/1/2023
7.6.6 529 1/5/2023
7.6.5 413 12/24/2022
7.6.4 451 12/7/2022
7.6.3 478 11/26/2022
7.6.2 458 11/16/2022
7.5.16 476 11/14/2022
7.5.15 470 11/13/2022
7.5.14 501 11/11/2022
7.5.13 467 11/10/2022
7.5.12 497 10/31/2022
7.5.11 533 10/30/2022
7.5.10 510 10/25/2022
7.5.9 508 10/9/2022
7.5.8 491 10/6/2022
7.5.7 513 10/3/2022
7.5.6 559 9/26/2022
7.5.5 561 9/23/2022
7.5.4 561 9/20/2022
7.5.3 553 9/16/2022
7.5.2 578 8/28/2022
7.5.1 583 8/26/2022
7.4.9.1 645 8/3/2022
7.4.8 621 7/31/2022
7.4.7 615 7/25/2022
7.4.6 647 7/19/2022
7.4.5 668 7/15/2022
7.4.4 669 7/6/2022
7.4.3 665 6/8/2022
7.4.2 659 5/11/2022
7.4.1 633 5/3/2022
7.3.9 648 4/19/2022
7.3.6 640 3/25/2022
7.3.5 614 3/17/2022
7.3.4 616 3/15/2022
7.3.2 574 2/23/2022
7.3.1 570 2/17/2022
6.14.11 478 9/1/2021
6.14.10 583 7/18/2021
6.13.14 474 5/10/2021
6.13.13 501 5/5/2021

LPRun 8.3.3