refactor(cmake): CMake configuration files for improved readability

[SYaoJun]

Reason for this PR

fix: #903

1. add cmake-format in pre-commit
2. format all related cmake configuartion files
3. enable CI check cmake-format

cmake-format.py referred to arrow cmake-format.py

What changes are included in this PR?

Are these changes tested?

Are there any user-facing changes?

[codecov-commenter]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 80.60%. Comparing base (b4bc86c) to head (b651f58).
⚠️ Report is 3 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff            @@
##               main     #904   +/-   ##
=========================================
  Coverage     80.60%   80.60%           
  Complexity      615      615           
=========================================
  Files            94       94           
  Lines         10709    10709           
  Branches       1055     1055           
=========================================
  Hits           8632     8632           
  Misses         1837     1837           
  Partials        240      240           

Flag	Coverage Δ
cpp	70.90% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[Copilot]

Pull request overview

Introduces cmake-format to standardize formatting of CMake configuration across the repository (per #903), and applies the formatter to existing CMakeLists/cmake modules to improve readability and enforce consistency via automation.

Changes:

• Add cmake-format as a pre-commit hook and run it in CI.
• Reformat multiple CMakeLists.txt and .cmake modules across C++, Python, and Java build integrations.
• Add a repository-level cmake-format configuration file.

Reviewed changes

Copilot reviewed 12 out of 13 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
python/CMakeLists.txt	Reformats Python build CMakeLists for consistent indentation/wrapping.
maven-projects/java/cmake/graphar-cpp.cmake	Reformats Java-side ExternalProject build helper for GraphAr C++.
maven-projects/java/CMakeLists.txt	Reformats Java JNI CMakeLists (options/globs/custom commands).
cpp/test/CMakeLists.txt	Reformats test macro and link/include blocks for readability.
cpp/src/CMakeLists.txt	Reformats core library build rules and Arrow linking blocks.
cpp/graphar-config-version.in.cmake	Minor formatting adjustment in version check logic.
cpp/examples/CMakeLists.txt	Reformats example discovery/build loop and link logic.
cpp/cmake/apache-arrow.cmake	Reformats Arrow ExternalProject build configuration and target setup.
cpp/benchmarks/CMakeLists.txt	Reformats benchmark macro and linking logic.
cpp/CMakeLists.txt	Reformats top-level C++ project configuration and build options.
cmake-format.py	Adds a cmake-format configuration file for consistent formatting rules.
.pre-commit-config.yaml	Adds cmake-format hook to enforce formatting locally.
.github/workflows/ci.yml	Adds CI step to run cmake-format via pre-commit.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

The Arrow CMake option name is misspelled as ARROW_BUILD_BENCHMAKRS (missing "R"). This will be ignored by Arrow and may accidentally build benchmarks. Use the correct ARROW_BUILD_BENCHMARKS option name in the CMake args list.

[SYaoJun]

accepted

[Copilot]

GAR_ARROW_CMAKE_ARGS includes -DARROW_WITH_RE2=OFF twice. This duplication is redundant and can make it harder to audit the Arrow build configuration; remove the duplicate entry to keep the option list unambiguous.

[SYaoJun]

good suggestion!

[Copilot]

The cmake-format hook is added, but the repository config file is named cmake-format.py and isn't referenced here. cmake-format typically auto-discovers .cmake-format.py/.cmake-format.yaml, so this setup may run with default formatting settings in CI and on contributors' machines. Rename the config to .cmake-format.py or pass the config explicitly via hook args (e.g., --config-files cmake-format.py).

[SYaoJun]

cmake-format.py also can find it.

[Copilot]

message(ERROR ...) isn't a valid CMake message mode and will itself error when this branch is hit. If the intent is to stop configuration when OpenSSL < 1.1.0 is detected, use message(FATAL_ERROR ...) (or SEND_ERROR if you want to continue processing).

[SYaoJun]

fixed