Merge branch 'master' into keras.utils-defaults-to

# Conflicts:
#	keras/utils/audio_dataset.py
#	keras/utils/image_dataset.py

Author: SamuelMarks

.devcontainer/Dockerfile

@@ -1,4 +1,4 @@
-FROM mcr.microsoft.com/vscode/devcontainers/python:3.8
+FROM mcr.microsoft.com/vscode/devcontainers/python:3.9
 COPY setup.sh /setup.sh
 
 # Install Bazel

keras/__init__.py

@@ -28,6 +28,6 @@
 from tensorflow.python import tf2
 from tensorflow.python.util.tf_export import keras_export
 
-__version__ = "2.13.0"
+__version__ = "2.14.0"
 
 keras_export("keras.__version__").export_constant(__name__, "__version__")

keras/constraints.py

@@ -16,6 +16,8 @@
 
 """Constraints: functions that impose constraints on weight values."""
 
+import warnings
+
 import tensorflow.compat.v2 as tf
 
 from keras import backend
@@ -357,6 +359,13 @@ def body_fn(i, array):
 
 @keras_export("keras.constraints.serialize")
 def serialize(constraint, use_legacy_format=False):
+    if not isinstance(constraint, Constraint):
+        warnings.warn(
+            "The `keras.constraints.serialize()` API should only be used for "
+            "objects of type `keras.constraints.Constraint`. Found an instance "
+            f"of type {type(constraint)}, which may lead to improper "
+            "serialization."
+        )
     if use_legacy_format:
         return legacy_serialization.serialize_keras_object(constraint)
     return serialize_keras_object(constraint)

keras/datasets/reuters.py

@@ -69,13 +69,13 @@ def load_data(
       skip_top: skip the top N most frequently occurring words
           (which may not be informative). These words will appear as
           `oov_char` value in the dataset. 0 means no words are
-          skipped. Defaults to 0
+          skipped. Defaults to `0`.
       maxlen: int or None. Maximum sequence length.
           Any longer sequence will be truncated. None means no truncation.
           Defaults to `None`.
-      test_split: Float between 0 and 1. Fraction of the dataset to be used
-        as test data. 0.2 means that 20% of the dataset is used as
-        test data. Defaults to 0.2
+      test_split: Float between `0.` and `1.`. Fraction of the dataset to be
+        used as test data. `0.2` means that 20% of the dataset is used as
+        test data. Defaults to `0.2`.
       seed: int. Seed for reproducible data shuffling.
       start_char: int. The start of a sequence will be marked with this
           character. 0 is usually the padding character. Defaults to `1`.

keras/distribute/distributed_file_utils.py

@@ -84,7 +84,7 @@ def write_dirpath(dirpath, strategy):
       The writing dir path that should be used to save with distribution.
     """
     if strategy is None:
-        # Infer strategy from `distribution_strategy_context` if not given.
+        # Infer strategy from `tf.distribute` if not given.
         strategy = tf.distribute.get_strategy()
     if strategy is None:
         # If strategy is still not available, this is not in distributed
@@ -107,7 +107,7 @@ def remove_temp_dirpath(dirpath, strategy):
       strategy: The tf.distribute strategy object currently used.
     """
     if strategy is None:
-        # Infer strategy from `distribution_strategy_context` if not given.
+        # Infer strategy from `tf.distribute` if not given.
         strategy = tf.distribute.get_strategy()
     if strategy is None:
         # If strategy is still not available, this is not in distributed

keras/engine/deferred_sequential_test.py

@@ -120,6 +120,23 @@ def test_feature_extraction(self):
         # Check that inputs and outputs are connected
         _ = extractor(np.random.random((4, 6)))
 
+    @test_combinations.run_all_keras_modes(always_skip_v1=True)
+    def test_saving_keras_v3(self):
+        model = get_model()
+        model(np.random.random((3, 6)))  # Build model
+
+        path = os.path.join(self.get_temp_dir(), "model_path.keras")
+        model.save(path)
+        new_model = keras.models.load_model(path)
+        model_layers = model._flatten_layers(include_self=True, recursive=False)
+        new_model_layers = new_model._flatten_layers(
+            include_self=True, recursive=False
+        )
+        for layer1, layer2 in zip(model_layers, new_model_layers):
+            self.assertEqual(layer1.name, layer2.name)
+            for w1, w2 in zip(layer1.weights, layer2.weights):
+                self.assertAllClose(w1, w2)
+
     @test_combinations.run_all_keras_modes(always_skip_v1=True)
     def test_saving_savedmodel(self):
         model = get_model()

keras/engine/functional_test.py

@@ -28,6 +28,7 @@
 from keras.engine import input_layer as input_layer_lib
 from keras.engine import sequential
 from keras.engine import training as training_lib
+from keras.saving import object_registration
 from keras.saving.legacy import save
 from keras.testing_infra import test_combinations
 from keras.testing_infra import test_utils
@@ -1875,7 +1876,7 @@ def test_external_keras_serialization_compat_input_layers(self):
         test_combinations.combine(mode=["graph", "eager"])
     )
     @test_utils.run_v2_only
-    def test_save_load_with_single_elem_list_inputs(self):
+    def test_save_load_with_single_elem_list_inputs_saved_model(self):
         class MyLayer(layers.Layer):
             def __init__(self):
                 super().__init__()
@@ -1893,6 +1894,26 @@ def call(self, inputs):
 
         save.load_model("/tmp/km2")
 
+    @test_utils.run_v2_only
+    def test_save_load_with_single_elem_list_inputs_keras_v3(self):
+        @object_registration.register_keras_serializable()
+        class MyLayer(layers.Layer):
+            def __init__(self):
+                super().__init__()
+                self._preserve_input_structure_in_config = True
+
+            def call(self, inputs):
+                return inputs[0]
+
+        inputs = input_layer_lib.Input(shape=(3,))
+        layer = MyLayer()
+        outputs = layer([inputs])
+
+        model = training_lib.Model(inputs=inputs, outputs=outputs)
+        model.save("/tmp/model.keras")
+
+        models.load_model("/tmp/model.keras")
+
     @test_combinations.generate(
         test_combinations.combine(mode=["graph", "eager"])
     )

keras/engine/functional_utils_test.py

@@ -151,11 +151,6 @@ def test_build_model_from_intermediate_tensor(self):
         model.fit(
             np.random.randn(batch_size, 32), np.random.randn(batch_size, 16)
         )
-        # Test for model saving
-        output_path = os.path.join(self.get_temp_dir(), "tf_keras_saved_model")
-        model.save(output_path, save_format="tf")
-        loaded_model = models.load_model(output_path)
-        self.assertEqual(model.summary(), loaded_model.summary())
 
         # Also make sure the original inputs and y can still be used to build
         # model
@@ -167,6 +162,27 @@ def test_build_model_from_intermediate_tensor(self):
         self.assertIs(new_model.layers[1], layer1)
         self.assertIs(new_model.layers[2], layer2)
 
+        # Test for model saving
+        with self.subTest("savedmodel"):
+            output_path = os.path.join(
+                self.get_temp_dir(), "tf_keras_saved_model"
+            )
+            model.save(output_path, save_format="tf")
+            loaded_model = models.load_model(output_path)
+            self.assertEqual(model.summary(), loaded_model.summary())
+
+        with self.subTest("keras_v3"):
+            if not tf.__internal__.tf2.enabled():
+                self.skipTest(
+                    "TF2 must be enabled to use the new `.keras` saving."
+                )
+            output_path = os.path.join(
+                self.get_temp_dir(), "tf_keras_v3_model.keras"
+            )
+            model.save(output_path, save_format="keras_v3")
+            loaded_model = models.load_model(output_path)
+            self.assertEqual(model.summary(), loaded_model.summary())
+
     def test_build_model_from_intermediate_tensor_with_complicated_model(self):
         # The topology is like below:
         # input1 -> dense1 -> a
@@ -212,10 +228,6 @@ def test_build_model_from_intermediate_tensor_with_complicated_model(self):
             ],
             np.random.randn(batch_size, 8),
         )
-        output_path = os.path.join(self.get_temp_dir(), "tf_keras_saved_model")
-        model.save(output_path, save_format="tf")
-        loaded_model = models.load_model(output_path)
-        self.assertEqual(model.summary(), loaded_model.summary())
 
         model2 = models.Model([a, b], d)
         # 2 input layers and 2 Add layer.
@@ -230,6 +242,26 @@ def test_build_model_from_intermediate_tensor_with_complicated_model(self):
             np.random.randn(batch_size, 8),
         )
 
+        with self.subTest("savedmodel"):
+            output_path = os.path.join(
+                self.get_temp_dir(), "tf_keras_saved_model"
+            )
+            model.save(output_path, save_format="tf")
+            loaded_model = models.load_model(output_path)
+            self.assertEqual(model.summary(), loaded_model.summary())
+
+        with self.subTest("keras_v3"):
+            if not tf.__internal__.tf2.enabled():
+                self.skipTest(
+                    "TF2 must be enabled to use the new `.keras` saving."
+                )
+            output_path = os.path.join(
+                self.get_temp_dir(), "tf_keras_v3_model.keras"
+            )
+            model.save(output_path, save_format="keras_v3")
+            loaded_model = models.load_model(output_path)
+            self.assertEqual(model.summary(), loaded_model.summary())
+
 
 if __name__ == "__main__":
     tf.test.main()

keras/initializers/__init__.py

@@ -15,6 +15,7 @@
 """Keras initializer serialization / deserialization."""
 
 import threading
+import warnings
 
 import tensorflow.compat.v2 as tf
 
@@ -136,6 +137,14 @@ def populate_deserializable_objects():
 
 @keras_export("keras.initializers.serialize")
 def serialize(initializer, use_legacy_format=False):
+    populate_deserializable_objects()
+    if not isinstance(initializer, tuple(LOCAL.ALL_OBJECTS.values())):
+        warnings.warn(
+            "The `keras.initializers.serialize()` API should only be used for "
+            "objects of type `keras.initializers.Initializer`. Found an "
+            f"instance of type {type(initializer)}, which may lead to improper "
+            "serialization."
+        )
     if use_legacy_format:
         return legacy_serialization.serialize_keras_object(initializer)
 

keras/layers/activation/leaky_relu.py

@@ -54,7 +54,7 @@ class LeakyReLU(Layer):
         Same shape as the input.
 
     Args:
-        alpha: Float >= 0. Negative slope coefficient. Defaults to `0.3`.
+        alpha: Float >= `0.`. Negative slope coefficient. Defaults to `0.3`.
 
     """