Skip to content

Import and integrate LiquidTestReports.Core as an external component#12

Merged
smdn merged 3 commits into
mainfrom
import-ltr-core
May 25, 2026
Merged

Import and integrate LiquidTestReports.Core as an external component#12
smdn merged 3 commits into
mainfrom
import-ltr-core

Conversation

@smdn

@smdn smdn commented May 24, 2026

Copy link
Copy Markdown
Owner

This pull request imports the source code of LiquidTestReports.Core into the repository as an external component, enabling custom modifications and local maintenance for internal implementation purposes.

Description

  • Background and Rationale:
    The upstream repository (kurtmkurtm/LiquidTestReports) has been inactive for an extended period, preventing necessary bug fixes and maintenance updates from being integrated via standard upstream contributions. To resolve this restriction, the source files from src/LiquidTestReports.Core have been vendored directly into this repository.

  • Infrastructure and Packaging Configuration:

    • An independent directory infrastructure is established under src/external/ to compile the component as a separate assembly, which is referenced exclusively via a ProjectReference with PrivateAssets="all".
    • The compiled binary (LiquidTestReports.Core.dll) is bundled internally within the host project's final NuGet package (Smdn.Extensions.Mtp.LiquidTestReports), avoiding any exposure of the component in the public package dependency list.
    • A custom src/external/Directory.Build.props is introduced to suppress compiler warnings originating from the upstream code and clear inherited default packaging configurations.
  • Licensing and Compliance:

    • Compliance with the original BSD 2-Clause License is maintained. The original license text is preserved in src/external/LiquidTestReports.Core.LICENSE.
    • A comprehensive license notification file (LICENSE_BUNDLE.txt) containing both the primary MIT License and the third-party BSD 2-Clause License is created to be embedded directly into the root of the generated NuGet package.
    • Machine-readable SBOM metadata is established in src/external/LiquidTestReports.Core.spdx.json using SPDX v2.3 specifications.

Considerations

  • Scope of the Imported Source Code:
    The baseline code is fetched from branch master at commit 1f39c20cec7aa06f50f88843ebe99f58f7ead3c5. To minimize the footprint and avoid legal uncertainties, the following files have been intentionally excluded from the import:

    • JUnitMapper.cs and LiquidTestReports.Core.Junit.cs: Excluded because JUnit functionality is unsupported in this host implementation.
    • jenkins-junit.xsd and vstst.xsd: Excluded because the precise origins and distribution licenses of these schema files are unverified.
  • Maintenance Strategy:
    Since the component is disconnected from the upstream repository, any future bug fixes or updates to this integrated component must be managed locally within the src/external/LiquidTestReports.Core directory.

smdn added 3 commits May 25, 2026 00:28
- Configure PropertyGroup/ItemGroup in .csproj for license bundle packaging
- Add LICENSE_BUNDLE.txt, Directory.Build.props and Directory.Build.targets
- Add src/external/README.md and LiquidTestReports.Core.spdx.json
- Create src/external/LiquidTestReports.Core/.gitkeep as a directory placeholder
- Note: The actual embedded source code files are not included in this commit
- Clone and check out the upstream repository at branch 'master' and commit 1f39c20cec7aa06f50f88843ebe99f58f7ead3c5.
- Copy the contents of 'src/LiquidTestReports.Core' into 'src/external/LiquidTestReports.Core'.
- Exclude the following files from the import:
  - src/LiquidTestReports.Core/Mappers/JUnitMapper.cs (JUnit is unsupported in this implementation)
  - src/LiquidTestReports.Core/Resources/LiquidTestReports.Core.Junit.cs (JUnit is unsupported in this implementation)
  - src/LiquidTestReports.Core/Resources/jenkins-junit.xsd (Origin and license are unverified)
  - src/LiquidTestReports.Core/Resources/vstst.xsd (Origin and license are unverified)
@smdn smdn merged commit df17066 into main May 25, 2026
9 checks passed
@smdn smdn deleted the import-ltr-core branch May 25, 2026 13:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant