Merge remote-tracking branch 'upstream/master'

Author: cdanielw

.github/workflows/README.md

@@ -0,0 +1,58 @@
+# Workflows
+
+## Authenticating and Initializing Earth Engine in GitHub Actions
+
+The
+[publish-to-pypi](https://github.com/google/earthengine-api/blob/master/.github/workflows/publish-to-pypi.yml)
+workflow uses the
+[google-github-actions/auth](https://github.com/google-github-actions/auth)
+GitHub action to authenticate with Google Cloud (see the snippet below).
+
+### Authenticating via Workload Identity Federation
+
+The Earth Engine smoke tests authenticate using workload identity federation.
+See
+[this guide](https://github.com/google-github-actions/auth?tab=readme-ov-file#workload-identity-federation-through-a-service-account) to
+create a workload identity provider and populate the resulting `service_account`
+and `workload_identity_provider` in your GitHub repository's Secrets and
+Variables settings.
+
+```yml
+jobs:
+  smoke-test:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v3
+        with:
+          python-version: 3.11
+      - name: Authenticate with Google Cloud
+        uses: 'google-github-actions/auth@v2'
+        with:
+          service_account: ${{ secrets.SERVICE_ACCOUNT }}
+          workload_identity_provider: ${{ secrets.WORKLOAD_IDENTITY_PROVIDER }}
+```
+
+The path to the credentials is stored in the
+[`GOOGLE_APPLICATION_CREDENTIALS`](https://cloud.google.com/docs/authentication/application-default-credentials#GAC)
+environment variable. To authenticate and initialize Earth Engine using the
+credentials, see the snippet below.
+
+```python
+import json
+import os
+
+from google.auth import identity_pool
+
+scopes = [
+    "https://www.googleapis.com/auth/cloud-platform",
+    "https://www.googleapis.com/auth/earthengine",
+]
+path = os.environ["GOOGLE_APPLICATION_CREDENTIALS"]
+info = json.load(open(path))
+credentials = identity_pool.Credentials.from_info(info).with_scopes(scopes)
+ee.Initialize(credentials, project=credentials.project_number)
+```

.github/workflows/ci-tests.yml

@@ -1,4 +1,3 @@
-# TODO(user): Fix or skip tests that fail on GitHub
 name: ci-tests
 on: [
   push,
@@ -15,11 +14,10 @@ jobs:
       matrix:
         os: [ubuntu-latest]
         python-version: [
-            "3.8",
-            "3.9",
             "3.10",
             "3.11",
             "3.12",
+            "3.13",
         ]
         include:
           - os: macos-latest

.github/workflows/ci-type-verification.yml

@@ -26,6 +26,10 @@ jobs:
         pip install pyright
         pip install pytype
         pip install mypy
+        pip install pandas-stubs types-geopandas
+        pip install types-httplib2 types-requests types-tensorflow
+        pip install pillow
+        pip install ipython ipykernel
     - name: pyright ee type verification
       run: |
         pyright --verifytypes ee

.github/workflows/publish-to-npm.yml

@@ -7,7 +7,6 @@ on:
 
 jobs:
   smoke-test:
-    if: "!github.event.release.prerelease"  # Only run if not a prerelease.
     runs-on: ubuntu-latest
     permissions:
       id-token: write

.github/workflows/publish-to-pypi.yml

@@ -37,7 +37,8 @@ jobs:
           ];
           path = os.environ["GOOGLE_APPLICATION_CREDENTIALS"];
           info = json.load(open(path));
-          ee.Initialize(identity_pool.Credentials.from_info(info).with_scopes(scopes));
+          credentials = identity_pool.Credentials.from_info(info).with_scopes(scopes);
+          ee.Initialize(credentials, project=credentials.project_number);
 
           print(ee.Image("srtm90_v4").getInfo())'
 
@@ -77,7 +78,7 @@ jobs:
           name: releases
           path: dist
       - name: Publish package to PyPI
-        uses: pypa/gh-action-pypi-publish@v1.8.13
+        uses: pypa/gh-action-pypi-publish@v1.13.0
         with:
           user: __token__
           password: ${{ secrets.PYPI_API_TOKEN }}

images/google_earthengine_powered.ai

@@ -2,3 +2,10 @@ Visit the [Google Earth Engine NPM installation
 page](https://developers.google.com/earth-engine/npm_install) for set up
 instructions, or [download
 ee_api_js.js](https://github.com/google/earthengine-api/blob/master/javascript/build/ee_api_js.js).
+
+Note that some classes and algorithms are loaded dynamically and are not
+included as part of the NPM package or visible in the
+[source code](https://github.com/google/earthengine-api/tree/master/javascript/src)
+(for example, `ee.Join` and `ee.Reducer`).
+For a complete listing of all Earth Engine client classes and methods, refer to
+the [API Reference](https://developers.google.com/earth-engine/apidocs).