Support Python 3.7+ clients.

All changes:
1. Copybara in `from __future__ import annotations` to all Python files to deal with list[] and dict[]. (Supports 3.7+)
2. Copybara out `def f(x, /) -> f(x)` (Supports 3.7+)
3. Copybara `from_collections.abc import` -> `typing import` and change code `from collections import abc` -> `from collections.abc import Collection` (Supports 3.7+)
4. Copybara out use of `typing.Literal`. (Only helps 3.7)
5. Copybara `functools.cache`/`functools.lru_cache` (Helps both 3.7 and 3.8)
6. Use delayed import on local Vizier Server when endpoint is not given to client, to avoid importing server-logic. (Only helps 3.7)

PiperOrigin-RevId: 497017707

.github/workflows/client_test.yml

@@ -0,0 +1,45 @@
+name: pytest_clients
+
+on:
+  pull_request:
+    branches:
+      - main
+  push:
+    branches:
+      - main
+
+jobs:
+  test-ubuntu:
+    name: "pytest on ${{ matrix.python-version }} on ${{ matrix.os }}"
+    runs-on: "${{ matrix.os }}"
+    strategy:
+      matrix:
+        python-version: [
+        3.7, # Cloud Vertex
+        3.8, # Public Colab
+        3.9, # Preferred Version
+        ]
+        os: [ubuntu-latest]
+    steps:
+      - uses: actions/checkout@v3
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install essential dependencies
+        run: |
+          sudo apt-get install -y libprotobuf-dev
+          python -m pip install --upgrade pip setuptools
+          pip install wheel
+          pip install grpcio-tools==1.48.2
+          pip install pytest pytest-xdist
+      - name: Install Vizier
+        run: |
+          pip wheel -e .
+          pip install -e .
+      - name: Print installed dependencies
+        run: |
+          pip freeze
+      - name: Check OSS Client import.
+        run: |
+          python vizier/service/clients.py

demos/run_vizier_client.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 """Example of a Vizier Client, which can be run on multiple machines.
 
 For distributed cases, this is meant to be used after the Vizier Server (see

demos/run_vizier_server.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 """Sets up the Vizier Service gRPC server.
 
 This should be done on a server machine:

docs/conf.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 """Sphinx configuration."""
 import os
 import sys

setup.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 """Setup for pip package."""
 import os
 import sys

vizier/__init__.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 """Init file."""
 import os
 import sys
@@ -21,4 +23,4 @@
 
 sys.path.append(PROTO_ROOT)
 
-__version__ = "0.0.15"
+__version__ = "0.0.16"

vizier/_src/__init__.py

@@ -12,4 +12,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 

vizier/_src/algorithms/__init__.py

@@ -12,4 +12,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 

vizier/_src/algorithms/classification/classifiers.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 """Binary classifiers for Bayesian Optimization."""
 
 from typing import Optional

vizier/_src/algorithms/classification/classifiers_test.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 """Tests for Sklearn classifier."""
 
 import numpy as np

vizier/_src/algorithms/core/__init__.py

@@ -12,4 +12,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 

vizier/_src/algorithms/core/abstractions.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 """Abstractions."""
 
 import abc

vizier/_src/algorithms/designers/__init__.py

@@ -12,4 +12,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 

vizier/_src/algorithms/designers/bocs.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 """Bayesian Optimization of Combinatorial Structures (BOCS) from https://arxiv.org/abs/1806.08838.
 
 Code is a cleaned-up exact version from /BOCSpy/ in

vizier/_src/algorithms/designers/bocs_test.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 """Tests for bocs."""
 from vizier._src.algorithms.designers import bocs
 from vizier._src.algorithms.testing import test_runners

vizier/_src/algorithms/designers/cmaes.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 """CMA-ES designer."""
 import json
 import queue

vizier/_src/algorithms/designers/cmaes_test.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 """Tests for cmaes."""
 from vizier import benchmarks
 from vizier._src.algorithms.designers import cmaes

vizier/_src/algorithms/designers/eagle_strategy/eagle_designer_convergence_test.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 """Convergence test for Eagle Strategy."""
 
 from vizier import benchmarks

vizier/_src/algorithms/designers/eagle_strategy/eagle_strategy.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 """Pythia Eagle Strategy Designer.
 
 Implements a variation of Eagle Strategy without the Levy random walk, aka

vizier/_src/algorithms/designers/eagle_strategy/eagle_strategy_test.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 """Tests for eagle_strategy."""
 
 from vizier import pyvizier as vz

vizier/_src/algorithms/designers/eagle_strategy/eagle_strategy_utils.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 """Utils functions to support Eagle Strategy designer."""
 
 import collections

vizier/_src/algorithms/designers/eagle_strategy/eagle_strategy_utils_test.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 """Tests for Eagle Strategy utils."""
 
 import copy

vizier/_src/algorithms/designers/eagle_strategy/serialization.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 """Eagle strategy designer serialization."""
 
 import json

vizier/_src/algorithms/designers/eagle_strategy/serialization_test.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 """Tests for serialization."""
 
 import numpy as np

vizier/_src/algorithms/designers/eagle_strategy/testing.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 """Testing utils for Eagle designer."""
 from typing import List, Optional
 

vizier/_src/algorithms/designers/emukit.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 """EmukitDesigner wraps emukit into Vizier Designer."""
 
 import enum

vizier/_src/algorithms/designers/emukit_test.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 """Tests for emukit."""
 
 from vizier import pyvizier as vz

vizier/_src/algorithms/designers/grid.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 """Grid Search Designer which searches over a discretized grid of Trial parameter values.
 """
 from typing import List, Mapping, Optional, Sequence

vizier/_src/algorithms/designers/grid_test.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 """Tests for grid."""
 from vizier import pythia
 from vizier import pyvizier

vizier/_src/algorithms/designers/harmonica.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 """Harmonica algorithm for boolean search spaces from 'Hyperparameter Optimization: A Spectral Approach' (https://arxiv.org/abs/1706.00764).
 
 This is a faithful re-implementation based off

vizier/_src/algorithms/designers/harmonica_test.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 """Tests for bocs."""
 from vizier._src.algorithms.designers import harmonica
 from vizier._src.algorithms.testing import test_runners

vizier/_src/algorithms/designers/quasi_random.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 """Quasi-random designer."""
 
 import collections

vizier/_src/algorithms/designers/quasi_random_test.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 import random
 
 from vizier import pyvizier as vz

vizier/_src/algorithms/designers/random.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 """Random designer."""
 
 from typing import Any, Optional, Sequence

vizier/_src/algorithms/designers/random_test.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 """Tests for random."""
 
 from vizier import pyvizier as vz

vizier/_src/algorithms/evolution/__init__.py

@@ -12,4 +12,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 

vizier/_src/algorithms/evolution/nsga2.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 """NSGA-II algorithm: https://ieeexplore.ieee.org/document/996017."""
 
 from typing import Callable, Optional, Tuple

vizier/_src/algorithms/evolution/nsga2_test.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 """Tests for nsga2."""
 
 import datetime

vizier/_src/algorithms/evolution/numpy_populations.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 """Core population utilities."""
 import collections
 import json
@@ -202,7 +204,7 @@ def __len__(self) -> int:
   def __getitem__(
       self,
       index: Any,
-      /,
+
   ) -> 'Population':
     return Population(**{k: v[index] for k, v in attr.asdict(self).items()})