Build: Support building site with uv

[manuzhang]

Currently, in the site build python script, both VENV_DIR and pip command are hard-coded, which prevents us from using uv to built site locally. To lift the limit, this PR exposes VENV_DIR and PIP as environment variables.

Run with uv using

PIP="uv pip" make serve-dev

[Copilot]

Pull request overview

This PR adds support for building the Iceberg documentation site using uv, a modern Python package installer and resolver. The change makes the pip command configurable via an environment variable while maintaining backward compatibility with the existing pip-based workflow.

Changes:

• Modified site/dev/common.sh to allow overriding the pip command via the PIP environment variable
• Added .python-version to .gitignore (created by uv)

Reviewed changes

Copilot reviewed 1 out of 2 changed files in this pull request and generated 1 comment.

File	Description
site/dev/common.sh	Made the pip command configurable via PIP environment variable, defaulting to the existing venv pip3 path
.gitignore	Added .python-version file to ignore list for uv compatibility

---

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

[kevinjqliu]

the current change only allows overriding PIP in common.sh
there are a lot of places in the .sh files using ${VENV_DIR}/bin/python3, i actually want to replaced all of those with uv
similar to #14684 which was for open-api

[manuzhang]

the current change only allows overriding PIP in common.sh

Yes, it works for me to use uv as an alternative locally with export PIP="uv pip".

[kevinjqliu]

we hardcode ${VENV_DIR}/ at a bunch of places right now.
https://grep.app/search?f.path=site%2Fdev%2F&f.repo=apache%2Ficeberg&f.repo.pattern=iceberg&q=%7BVENV_DIR%7D
i think if we want to override this specific instance, we should override all of them.

It might get confusing otherwise. For example, uv allows to create venv dir with different names, while the script is hardcoded to .venv

iceberg/site/dev/common.sh

Line 22 in 7493a15

export VENV_DIR=".venv"

[manuzhang]

@kevinjqliu VENV_DIR can be overridden now. Please take another look.

[kevinjqliu]

thanks! i think the VENV_DIR change alone should allow using environment created by uv. wdyt?

imo to fully support "Build: Support building site with uv", we should change all the scripts currently using VENV_DIR/pip/pip3/python/python3 to uv commands

[kevinjqliu]

thanks for catching me up on this. it makes sense, and being able to override pip with uv pip resolves deps much faster.

do you mind adding some context in the pr description?

[Copilot]

Pull request overview

Copilot reviewed 1 out of 2 changed files in this pull request and generated no new comments.

---

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

[kevinjqliu]

Thanks for the PR @manuzhang !