Files
semantic-kernel/python/tests/unit/functions/test_kernel_parameter_metadata.py
T
Evan Mattson 5f49880d52 Python: Json schema improvements for Union and Optional (#7367)
### Motivation and Context

We have some gaps in how we build the JSON schema for function calling
related to Union and Optional types. There is also some work to do
related to handling `Optional` versus `param | None = None`.

<!-- Thank you for your contribution to the semantic-kernel repo!
Please help reviewers and future users, providing the following
information:
  1. Why is this change required?
  2. What problem does it solve?
  3. What scenario does it contribute to?
  4. If it fixes an open issue, please link to the issue here.
-->

### Description

This PR improves the JSON schema building for the Union and Optional
types. It adds additional tests and improves some existing tests.
- Closes #7297 
- Closes #7298

<!-- Describe your changes, the overall approach, the underlying design.
These notes will help understanding how your code works. Thanks! -->

### Contribution Checklist

<!-- Before submitting this PR, please make sure: -->

- [X] The code builds clean without any errors or warnings
- [X] The PR follows the [SK Contribution
Guidelines](https://github.com/microsoft/semantic-kernel/blob/main/CONTRIBUTING.md)
and the [pre-submission formatting
script](https://github.com/microsoft/semantic-kernel/blob/main/CONTRIBUTING.md#development-scripts)
raises no violations
- [X] All unit tests pass, and I have added new tests where possible
- [X] I didn't break anyone 😄
2024-07-23 04:38:55 +00:00

68 lines
2.4 KiB
Python

# Copyright (c) Microsoft. All rights reserved.
import pytest
from pydantic import ValidationError
from semantic_kernel.functions.kernel_parameter_metadata import KernelParameterMetadata
def test_kernel_parameter_metadata_init():
metadata = KernelParameterMetadata(
name="test",
description="description",
is_required=True,
type="str",
default_value="default",
)
assert metadata.name == "test"
assert metadata.description == "description"
assert metadata.is_required is True
assert metadata.default_value == "default"
def test_kernel_parameter_metadata_valid():
metadata = KernelParameterMetadata(
name="param1",
description="A test parameter",
default_value="default",
type_="str",
is_required=True,
type_object=str,
)
assert metadata.name == "param1"
assert metadata.description == "A test parameter"
assert metadata.default_value == "default"
assert metadata.type_ == "str"
assert metadata.is_required is True
assert metadata.type_object is str
assert metadata.schema_data == {"type": "string", "description": "A test parameter"}
def test_kernel_parameter_metadata_invalid_name():
with pytest.raises(ValidationError):
KernelParameterMetadata(
name="invalid name!", description="A test parameter", default_value="default", type_="str"
)
def test_kernel_parameter_metadata_infer_schema_with_type_object():
metadata = KernelParameterMetadata(name="param2", type_object=int, description="An integer parameter")
assert metadata.schema_data == {"type": "integer", "description": "An integer parameter"}
def test_kernel_parameter_metadata_infer_schema_with_type_name():
metadata = KernelParameterMetadata(name="param3", type_="int", default_value=42, description="An integer parameter")
assert metadata.schema_data == {"type": "integer", "description": "An integer parameter (default value: 42)"}
def test_kernel_parameter_metadata_without_schema_data():
metadata = KernelParameterMetadata(name="param4", type_="bool")
assert metadata.schema_data == {"type": "boolean"}
def test_kernel_parameter_metadata_with_partial_data():
metadata = KernelParameterMetadata(name="param5", type_="float", default_value=3.14)
assert metadata.schema_data == {"type": "number", "description": "(default value: 3.14)"}