feat: modernize packaging with pyproject.toml and uv

- Migrate package metadata from setup.py to pyproject.toml (PEP 621)
- Keep dynamic version reading from __init__.py for compatibility
- Use modern dependency-groups format (PEP 735) for dev dependencies
- Add uv for fast dependency management (10-100x faster than pip)
- Update all CI/CD workflows to use uv
- Add .python-version file for consistent Python version
- Update CONTRIBUTING.md with uv instructions
- Use modern build tool instead of setup.py commands
- Fix license format to use SPDX identifier

Benefits:
- Faster dependency installation and resolution with uv
- Modern Python packaging standards compliance
- Better dependency locking with uv.lock
- Simpler, more maintainable configuration
- Consistent Python version across environments

Author: taeold

.github/CONTRIBUTING.md

@@ -23,42 +23,50 @@ information on using pull requests.
 
 ## Setup local environment
 
-Clone the project and run the following commands to setup your environment 
+Clone the project and install [uv](https://github.com/astral-sh/uv) (our package manager):
 
 ```sh
-python3.11 -m venv venv
-source venv/bin/activate 
-pip3 install --upgrade pip 
-python3.11 -m pip install -e ".[dev]"
+# Install uv (if not already installed)
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Clone and setup the project
+git clone https://github.com/firebase/firebase-functions-python.git
+cd firebase-functions-python
+uv sync --dev
 ```
 
-(this also applies to setting up samples environment for each sample)
+This will automatically:
+- Create a virtual environment
+- Install all runtime and development dependencies
+- Use the Python version specified in `.python-version` (3.10)
+
+(For samples, you can use the same approach but run `uv sync` in each sample directory)
 
 ### Running tests
 
 Without coverage:
 ```bash
-python3.11 -m pytest
+uv run pytest
 ```
 
 With coverage:
 ```bash
-python3.11 -m pytest --cov=src --cov-report term --cov-report html --cov-report xml -vv
+uv run pytest --cov=src --cov-report term --cov-report html --cov-report xml -vv
 ```
 
 ### Formatting code
 
 ```bash
-python3.11 -m ruff format .
+uv run ruff format .
 ```
 
 ### Running lints & type checking
 
 ```bash
 # Type checking
-python3.11 -m mypy .
+uv run mypy .
 # Linting
-python3.11 -m ruff check .
+uv run ruff check .
 ```
 
 ### Generating Docs

.github/workflows/ci.yaml

@@ -20,16 +20,16 @@ jobs:
         uses: actions/setup-python@v4
         with:
           python-version: ${{ matrix.python }}
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
       - name: Install dependencies
         run: |
-          python${{ matrix.python }} -m venv venv
-          source venv/bin/activate 
-          pip3 install --upgrade pip 
-          python${{ matrix.python }} -m pip install -e ".[dev]"
+          uv sync --dev
       - name: Test with pytest & coverage
         run: |
-          source venv/bin/activate
-          python${{ matrix.python }} -m pytest --cov=src --cov-report term --cov-report html --cov-report xml -vv
+          uv run pytest --cov=src --cov-report term --cov-report html --cov-report xml -vv
       # TODO requires activation for this repository on codecov website first.
       # - name: Upload coverage to Codecov
       #   uses: codecov/codecov-action@v3
@@ -42,20 +42,19 @@ jobs:
         uses: actions/setup-python@v4
         with:
           python-version: "3.10"
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
       - name: Install dependencies
         run: |
-          python3.10 -m venv venv
-          source venv/bin/activate 
-          pip3 install --upgrade pip 
-          python3.10 -m pip install -e ".[dev]"
+          uv sync --dev
       - name: Lint with ruff
         run: |
-          source venv/bin/activate
-          python3.10 -m ruff check .
+          uv run ruff check .
       - name: Lint with mypy
         run: |
-          source venv/bin/activate
-          python3.10 -m mypy .
+          uv run mypy .
 
   docs:
     runs-on: ubuntu-latest
@@ -65,17 +64,17 @@ jobs:
         uses: actions/setup-python@v4
         with:
           python-version: "3.10"
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
       - name: Install dependencies
         run: |
-          python3.10 -m venv venv
-          source venv/bin/activate 
-          pip3 install --upgrade pip 
-          python3.10 -m pip install -e ".[dev]"
+          uv sync --dev
       - name: Generate Reference Docs
         run: |
-          source venv/bin/activate
           mkdir ./docs/build
-          ./docs/generate.sh --out=./docs/build/ --pypath=src/
+          uv run ./docs/generate.sh --out=./docs/build/ --pypath=src/
       - uses: actions/upload-artifact@v4
         name: Upload Docs Preview
         with:
@@ -90,13 +89,13 @@ jobs:
         uses: actions/setup-python@v4
         with:
           python-version: "3.10"
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
       - name: Install dependencies
         run: |
-          python3.10 -m venv venv
-          source venv/bin/activate 
-          pip3 install --upgrade pip 
-          python3.10 -m pip install -e ".[dev]"
+          uv sync --dev
       - name: Check Formatting with ruff
         run: |
-          source venv/bin/activate
-          python3.10 -m ruff format --check .
+          uv run ruff format --check .

.github/workflows/release.yaml

@@ -41,20 +41,23 @@ jobs:
       with:
         python-version: '3.10'
 
+    - name: Install uv
+      uses: astral-sh/setup-uv@v3
+      with:
+        enable-cache: true
+
     - name: Install dependencies
       run: |
-        pip install --upgrade pip
-        python -m pip install -e ".[dev]"
+        uv sync --dev
 
     - name: Test with pytest & coverage
       run: |
-        python -m pytest --cov=src --cov-report term --cov-report html --cov-report xml -vv
+        uv run pytest --cov=src --cov-report term --cov-report html --cov-report xml -vv
 
     # Build the Python Wheel and the source distribution.
     - name: Package release artifacts
       run: |
-       python -m pip install setuptools wheel
-       python setup.py bdist_wheel sdist
+       uv run python -m build
 
     # Attach the packaged artifacts to the workflow output. These can be manually
     # downloaded for later inspection if necessary.

pyproject.toml

@@ -1,7 +1,58 @@
+[build-system]
+requires = ["setuptools>=63.4.2", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "firebase_functions"
+description = "Firebase Functions Python SDK"
+readme = "README.md"
+authors = [{name = "Firebase Team"}]
+license = "Apache-2.0"
+keywords = ["firebase", "functions", "google", "cloud"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Build Tools",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+requires-python = ">=3.10"
+dependencies = [
+    "flask>=2.1.2",
+    "functions-framework>=3.0.0",
+    "firebase-admin>=6.0.0",
+    "pyyaml>=6.0",
+    "typing-extensions>=4.4.0",
+    "cloudevents>=1.2.0,<2.0.0",
+    "flask-cors>=3.0.10",
+    "pyjwt[crypto]>=2.5.0",
+    "google-events==0.5.0",
+    "google-cloud-firestore>=2.11.0",
+]
+dynamic = ["version"]
+
+[project.urls]
+Homepage = "https://github.com/firebase/firebase-functions-python"
+Repository = "https://github.com/firebase/firebase-functions-python"
+Documentation = "https://firebase.google.com/docs/functions"
+"Bug Tracker" = "https://github.com/firebase/firebase-functions-python/issues"
+
+
+[tool.setuptools.dynamic]
+version = {attr = "firebase_functions.__version__"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+firebase_functions = ["py.typed"]
+
 [tool.pytest.ini_options]
 pythonpath = [
   ".", "src/",
 ]
+
 [tool.coverage]
     [tool.coverage.run]
     omit = [
@@ -44,3 +95,17 @@ quote-style = "double"
 indent-style = "space"
 skip-magic-trailing-comma = false
 line-ending = "auto"
+
+[dependency-groups]
+dev = [
+    "pytest>=7.1.2,<9",
+    "setuptools>=63.4.2",
+    "pytest-cov>=3.0.0",
+    "mypy>=1.0.0",
+    "sphinx>=6.1.3",
+    "sphinxcontrib-napoleon>=0.7",
+    "toml>=0.10.2",
+    "google-cloud-tasks>=2.13.1",
+    "ruff>=0.1.0",
+    "build>=1.0.0",
+]