Assembly version string retrieval

assembly-version-string-retrieval

Summary

Retrieve the version string and file path of a precompiled .NET assembly bundled with an R package without requiring input data files. This skill verifies that internal R-to-C# dispatch mechanisms are functioning correctly and that managed code dependencies are properly deployed.

When to use

When you need to validate that a .NET assembly (such as ThermoFisher.CommonCore.RawFileReader) is correctly installed and accessible before attempting data reading operations. Use this skill as a diagnostic check at the start of any workflow that relies on managed code interop, especially when troubleshooting failures in downstream functions like readSpectrum() or readFileHeader().

When NOT to use

• Input is already a feature table or processed spectrum object; use this skill only to verify assembly availability, not to extract or transform spectral data.
• You have confirmed via system PATH or environment variables that the assembly is correctly deployed; this skill is a diagnostic, not a recovery mechanism.

Inputs

• rawrr R package (installed and loaded)
• No raw data file required

Outputs

• Assembly file path (string pointing to rawrr.exe directory)
• Assembly version string (non-empty semantic version)
• Validation status (success/failure of interop call)

How to apply

Call the internal R package functions that expose assembly metadata without requiring raw data file inputs. In rawrr, invoke rawrr:::.rawrrAssembly() to obtain the filesystem path to the bundled .NET 8.0 executable, and rawrr:::.getRawrrAssemblyVersion() to retrieve the assembly version string. Verify that the returned path points to a valid directory containing the rawrr.exe executable, and confirm that the version string is non-empty and matches expected release tags. Both calls should execute successfully via the R-layer-to-C#-wrapper system call mechanism without errors, demonstrating that the two-layer architecture (R functions invoking compiled C# methods via system calls, with results written to temporary storage and read back) is operational.

Related tools

• rawrr (R package wrapping RawFileReader .NET assembly; provides internal functions rawrr:::.rawrrAssembly() and rawrr:::.getRawrrAssemblyVersion() for assembly path and version retrieval) — https://github.com/fgcz/rawrr
• RawFileReader (Thermo Fisher Scientific .NET assembly read from by rawrr; version and path must be verified before invoking its wrapped functions) — https://github.com/thermofisherlsms/RawFileReader

Examples

rawrr:::.rawrrAssembly(); rawrr:::.getRawrrAssemblyVersion()

Evaluation signals

• rawrr:::.rawrrAssembly() returns a non-null, non-empty character string pointing to an existing directory
• Directory returned by .rawrrAssembly() contains a valid rawrr.exe executable file with accessible read permissions
• rawrr:::.getRawrrAssemblyVersion() returns a non-empty version string matching semantic versioning format (e.g., '1.0.0')
• Both function calls complete without R errors or system-level exceptions related to interop or file I/O
• Version string is consistent across repeated calls and matches the declared version in the installed package DESCRIPTION file

Limitations

• This skill only validates assembly availability and basic metadata; it does not verify that the assembly can successfully read actual .raw files or that all wrapped C# methods are functional.
• On Windows systems, the decimal symbol must be configured as '.' for proper data extraction in downstream operations; this skill does not enforce or validate that configuration.
• The skill assumes the rawrr package is already installed and loaded into the R environment; it cannot diagnose installation failures or missing system dependencies (e.g., .NET 8.0 runtime).

Evidence

• [other] Can the rawrr package's internal assembly dispatch functions (rawrr:::.rawrrAssembly() and rawrr:::.getRawrrAssemblyVersion()) successfully retrieve the assembly path and version string without requiring a raw data file as input?: "Can the rawrr package's internal assembly dispatch functions (rawrr:::.rawrrAssembly() and rawrr:::.getRawrrAssemblyVersion()) successfully retrieve the assembly path and version string without"
• [methods] R functions requesting access to data stored in binary raw files invoke compiled C# wrapper methods using a system call: "R functions requesting access to data stored in binary raw files invoke compiled C# wrapper methods using a system call"
• [methods] the extracted information is written to a temporary location on the harddrive, read back into memory and parsed into R objects: "the extracted information is written to a temporary location on the harddrive, read back into memory and parsed into R objects"
• [readme] rawrr wraps the functionality of the RawFileReader .NET assembly: "rawrr wraps the functionality of the RawFileReader .NET assembly"
• [other] Confirm that both functions execute successfully without requiring a raw data file input, demonstrating the internal dispatch mechanism between the R layer and the managed C# assembly layer.: "Confirm that both functions execute successfully without requiring a raw data file input, demonstrating the internal dispatch mechanism between the R layer and the managed C# assembly layer."