Menu
Use this skill to build and test code changes inside a cudf devcontainer.
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/NVIDIA/cudf --skill build-test-cudfThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Based on SOC occupation classification
Showing SKILL.md
| name | build-test-cudf |
| description | Use this skill to build and test code changes inside a cudf devcontainer. |
Detect cudf devcontainer usage by checking if the username is coder. If not, ignore everything else in this file and skip.
cudf packages must be built in this order as needed (each depends on the previous):
.pyx files)When rebuilding a package, ensure its dependencies are already built. Since we are in cudf devcontainer, DO NOT run the build.sh script or install any packages yourself. Instead, always use the build-*, test-*, rapids-*, clean-* scripts located at /usr/bin.
Whenever building libcudf from scratch (CMake has not been run before), run:
build-cudf-cpp -j0
For incremental builds, you can also just navigate to cpp/build/latest and run:
ninja
Both build-cudf-cpp and configure-cudf-cpp accept CMake -D options directly as arguments. See cpp/CMakeLists.txt for a full list of available CMake options
# Default option
build-cudf-cpp -j0 -DBUILD_BENCHMARKS=ON
# Multiple options can be combined
build-cudf-cpp -j0 -DBUILD_BENCHMARKS=ON -DBUILD_TESTS=OFF
Similarly, configure without building:
configure-cudf-cpp -DBUILD_BENCHMARKS=ON
build-libcudf-python
build-pylibcudf-python
build-cudf-python # cudf-python
build-cudf-polars-python # cudf-polars
Similar to build instructions, we can use clean-cudf-xxx scripts also located at /usr/bin. Use clean-cudf to clean everything.
If there are build errors, cleaning before building will usually resolve problems. If we run into a fatal CMake error while building libcudf indicating packages/version mismatch, update the environment using the following script. If the error persists, use --force flag with the script
rapids-make-${PYTHON_PACKAGE_MANAGER}-env
Make sure to run clean-cudf after running this for a fresh subsequent build.
Make sure that libcudf has been built before running any of these. Discover all Google test name binaries at cpp/build/latest/gtests and run relevant Google tests using test-cudf-xxx script located at /usr/bin.
test-cudf-cpp -j10 # all tests 10 parallel jobs
test-cudf-cpp -R <NAME>_TEST # specific test suite
cd cpp/build/latest/gtests && <NAME>_TEST --gtest_filter="<pattern>" # Run tests matching the <pattern> from the <NAME>_TEST
These instructions are applicable for running tests for pylibcudf and high-level python packages. Make sure that the package has been built before running its pytests. Pylibcudf tests can be discovered at: python/pylibcudf/tests and subfolders. Run them using:
pytest python/pylibcudf/tests/<subfolder>/test_<name>.py # specific pylibcudf test suite
cudf-python pytests can be discovered at: python/cudf/cudf/tests and subfolders. Run them using:
test-cudf-python # run all cudf-python Pytests
pytest python/cudf/cudf/tests/<subfolder>/test_<name>.py # specific cudf-python test suite
Similarly, cudf-polars pytests can be discovered at: python/cudf_polars/tests and subfolders. Run them using:
test-cudf-polars-python