skills.rest
GEOS-ESM
GEOS-ESMOFFICIAL
Explore all skills by this author →
WebsiteGitHub

pfunit-troubleshooting

Debug pFUnit test failures in MAPL with diagnostic flags.

43|25|Updated Jul 3, 2019
Search Tags:#testing#debugging#unit testing#fortran#pFUnit#MAPL
One-click install
npx skills add https://github.com/GEOS-ESM/MAPL --skill pfunit-troubleshooting
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pfunit-troubleshooting
Source: https://github.com/GEOS-ESM/MAPL/tree/main/.opencode/skills/pfunit-troubleshooting
Command: npx skills add https://github.com/GEOS-ESM/MAPL --skill pfunit-troubleshooting

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps users efficiently debug and resolve failures encountered during pFUnit testing within the MAPL framework, ensuring code quality and test suite integrity.

Core Features & Use Cases

  • Diagnose Test Failures: Understand common pFUnit error messages and identify root causes.
  • Execute Specific Tests: Run targeted tests with diagnostic flags to pinpoint issues.
  • Use Case: A developer commits code changes and the CI pipeline reports a pFUnit test failure. This Skill guides them through running the failing test locally with diagnostic output to quickly identify the assertion that failed or the cause of a segmentation fault.

Quick Start

Run the failing test executable with the diagnostic flag enabled.

Frequently Asked Questions about pfunit-troubleshooting

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug a pFUnit test failure in MAPL?▼

Debug a pFUnit test failure by running the specific failing test executable directly with diagnostic flags enabled, examining the output to pinpoint the root cause of the assertion failure or segmentation fault.

Why does my pFUnit test hang during execution?▼

A pFUnit test hang often indicates MPI-related problems or deadlocks within the test suite. Execute the targeted test directly with diagnostic flags enabled to isolate the blocking process and identify the issue.

What causes numerical tolerance failures in pFUnit tests?▼

Numerical tolerance failures in pFUnit tests occur when floating-point calculation results exceed the allowed error margin. Examine the test diagnostic output to identify the specific assertion and adjust the tolerance.

How do I resolve pFUnit library loading errors?▼

Resolve pFUnit library loading errors by verifying the test environment and runtime library paths. This Skill provides step-by-step procedures for diagnosing and fixing library loading issues within the MAPL framework.

Can I run a single pFUnit test locally to reproduce a CI failure?▼

Yes, you can execute a specific pFUnit test locally to reproduce a CI failure. Run the targeted test executable directly with diagnostic flags enabled to quickly identify the failed assertion or segmentation fault.

What are common error patterns when unit testing Fortran with pFUnit?▼

Common error patterns when unit testing Fortran with pFUnit include assertion failures, segmentation faults, and test hangs. These issues often stem from MPI-related problems or numerical tolerance mismatches.

Related Skills

Explore More Software Engineering Skills→
GEOS-ESMGEOS-ESM
43

mapl-testing

Run and debug MAPL software tests using the pFUnit framework.

Official
Intermediate
tranceetrancee

kotlin-power-assert

Transform Kotlin assertion functions to expose intermediate sub-expression values on test failures.

Community
Intermediate
thbehthbeh

bdd-run

Execute BDD tests with Behave, filter by tags, and output JUnit/JSON reports.

Community
Intermediate
samChang72samChang72
1

qa-test-engineer

Automate unit, integration, and component tests with Vitest and Testing Library.

Community
Intermediate