Files
2026-07-13 12:40:42 +08:00

216 lines
8.1 KiB
Python

# Copyright (c) 2026 PaddlePaddle Authors. All Rights Reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
import unittest
import paddle
from paddle.distributed.fleet.meta_parallel import (
LayerSpec,
build_spec_layer,
get_spec_layer,
import_spec_layer,
)
from paddle.nn import Identity
class SimpleRotaryEmbeddingForTest(paddle.nn.Layer):
def __init__(
self,
head_dim: int,
rotary_percent: float,
rotary_interleaved: bool = False,
rotary_base: int = 10000,
rope_scaling: bool = False,
) -> None:
super().__init__()
self.head_dim = head_dim
self.rotary_percent = rotary_percent
self.rotary_interleaved = rotary_interleaved
self.rotary_base = rotary_base
self.rope_scaling = rope_scaling
class TestSpecCustomization(unittest.TestCase):
def setUp(self):
head_dim = 128
rotary_base = 10000
rotary_percent = 1.0
rope_scaling = False
rotary_emb_extra_kwargs = {
"head_dim": head_dim // 2,
"rotary_base": rotary_base,
"rope_scaling": rope_scaling,
"rotary_percent": rotary_percent,
}
self.embedding_spec = LayerSpec(
layer=SimpleRotaryEmbeddingForTest,
extra_kwargs=rotary_emb_extra_kwargs,
)
def tearDown(self):
pass
def test_import_layer(self):
identity_cls = import_spec_layer(
layer_path=('paddle.nn.layer.common', 'Identity')
)
self.assertEqual(identity_cls, Identity)
def test_build_layer(self):
head_dim = 128
rotary_percent = 1.0
rotary_base = 10000
rope_scaling = False
self.rotary_pos_emb = build_spec_layer(
self.embedding_spec,
head_dim=head_dim,
rotary_percent=rotary_percent,
rotary_base=rotary_base,
rope_scaling=rope_scaling,
)
self.assertIsInstance(self.rotary_pos_emb, SimpleRotaryEmbeddingForTest)
def test_layer_spec_basic(self):
"""Test basic LayerSpec functionality."""
# Test LayerSpec with class
spec = LayerSpec(layer=Identity)
self.assertEqual(spec.layer, Identity)
self.assertEqual(spec.extra_kwargs, {})
self.assertIsNone(spec.sublayers_spec)
# Test LayerSpec with extra_kwargs
spec_with_kwargs = LayerSpec(
layer=Identity, extra_kwargs={"test_param": 123}
)
self.assertEqual(spec_with_kwargs.extra_kwargs, {"test_param": 123})
# Test LayerSpec with layer path tuple
spec_with_path = LayerSpec(layer=("paddle.nn.layer.common", "Identity"))
self.assertEqual(
spec_with_path.layer, ("paddle.nn.layer.common", "Identity")
)
def test_build_layer_with_identity_op(self):
"""Test building layers with Identity."""
# Build Identity
identity = build_spec_layer(LayerSpec(layer=Identity))
self.assertIsInstance(identity, Identity)
# Test forward pass
test_input = paddle.randn([2, 3])
result = identity(test_input)
self.assertEqual(result.shape, test_input.shape)
def test_get_spec_layer_with_type(self):
"""Test get_spec_layer with a type directly."""
# Test with a type directly
result = get_spec_layer(Identity)
self.assertEqual(result, Identity)
def test_get_spec_layer_with_layer_spec(self):
"""Test get_spec_layer with LayerSpec containing a type."""
# Test with LayerSpec containing a type
spec = LayerSpec(layer=Identity)
result = get_spec_layer(spec)
self.assertEqual(result, Identity)
def test_get_spec_layer_with_layer_path(self):
"""Test get_spec_layer with LayerSpec containing a layer path tuple."""
# Test with LayerSpec containing a layer path
spec = LayerSpec(layer=("paddle.nn.layer.common", "Identity"))
result = get_spec_layer(spec)
self.assertEqual(result, Identity)
def test_get_spec_layer_with_function(self):
"""Test get_spec_layer with a function."""
# Test with a function (using a lambda for testing)
test_func = lambda x: x
result = get_spec_layer(test_func)
self.assertEqual(result, test_func)
def test_get_spec_layer_with_extra_kwargs(self):
"""Test get_spec_layer with extra kwargs (should be ignored)."""
# extra_kwargs should be ignored by get_spec_layer
spec = LayerSpec(layer=Identity, extra_kwargs={"test_param": 123})
result = get_spec_layer(spec, additional_arg=456)
self.assertEqual(result, Identity)
def test_layer_spec_repr_with_tuple(self):
"""Test LayerSpec __repr__ with tuple layer."""
# Test with a tuple of layer path
spec = LayerSpec(layer=("paddle.nn.layer.common", "Identity"))
repr_str = repr(spec)
self.assertIn("paddle.nn.layer.common", repr_str)
self.assertIn("Identity", repr_str)
def test_import_spec_layer_with_import_error(self):
"""Test import_spec_layer with invalid import path."""
# Test with invalid module path that raises ImportError
result = import_spec_layer(("nonexistent.module.path", "SomeClass"))
self.assertIsNone(result)
def test_build_spec_layer_with_function(self):
"""Test build_spec_layer with a function directly."""
# Test with a function directly
test_func = lambda x: x * 2
result = build_spec_layer(test_func)
self.assertEqual(result, test_func)
def test_build_spec_layer_with_layer_spec_function(self):
"""Test build_spec_layer with LayerSpec containing a function."""
# Test with LayerSpec containing a function
test_func = lambda x: x + 1
spec = LayerSpec(layer=test_func, extra_kwargs={})
result = build_spec_layer(spec)
self.assertEqual(result, test_func)
def test_build_spec_layer_with_type(self):
"""Test build_spec_layer with a type directly."""
# Test with a type directly - should instantiate the class
result = build_spec_layer(Identity)
self.assertIsInstance(result, Identity)
def test_build_spec_layer_with_layer_spec_type(self):
"""Test build_spec_layer with LayerSpec containing a type."""
# Test with LayerSpec containing a type (class)
spec = LayerSpec(layer=Identity)
result = build_spec_layer(spec)
self.assertIsInstance(result, Identity)
def test_build_spec_layer_with_imported_function(self):
"""Test build_spec_layer with layer path that imports a function."""
# Test with LayerSpec containing a layer path that resolves to a function
# Using a simple function from paddle.nn.functional
spec = LayerSpec(layer=("paddle.nn.functional", "relu"))
result = build_spec_layer(spec)
# The imported layer should be a function
self.assertTrue(callable(result))
def test_build_spec_layer_exception_handling(self):
"""Test build_spec_layer with invalid kwargs that cause exception."""
# Test that exception is raised with improved error message
# Use paddle.nn.Linear which requires in_features and out_features
# Passing empty extra_kwargs will cause TypeError at instantiation
spec = LayerSpec(layer=paddle.nn.Linear, extra_kwargs={})
with self.assertRaises(Exception) as context:
build_spec_layer(spec)
# Verify the error message includes the layer name
self.assertIn("Linear", str(context.exception))
if __name__ == "__main__":
unittest.main()