缺少扩展组件开发的详细文档帮助开发和单元测试提升质量和效率

### Issue Type

Others

### Have you searched for existing documents and issues?

Yes

### OS Platform and Distribution

EulerOS2.0

### All_in_one Version

1.7.0b0

### Module type

secretpad

### Module version

0.8.1b0

### What happend and What you expected to happen.

```shell
想开发一个扩展组件，目前只有一个compare的示例，缺少对扩展组件从架构，开发到单元测试等工程化的详细文档，直接看代码里面的写法也有好多种场景，需要花大量的时间摸索出符合自己需要的场景写法，并且单元测试过程中遇到了很多问题。
```

### Log output.

```shell
问题1：
1. 加密计算过程中，dtype不能为object，代码片段如下：
max_iter=1000
input_spu_train_object和input_spu_test_object被spu前的数据结构：
data = pd.DataFrame(
        data=[
            [0.016, 0.827, 1., 0.333, 1],
            [0.335, 0.464, 1., 0.667, 0],
            [0.291, 0.564, 1., 0.667, 1],
            [0.35, 0.645, 0.5, 0.667, 0],
        ],
        columns=[
            "f1", "f2","f3", "f4","label",
        ],
    )
执行语句：
output_spu_obj = spu(
        ROILinearProbeEvaluation,
        num_returns_policy=SPUCompilerNumReturnsPolicy.FROM_USER,
        user_specified_num_returns=2,
    )(input_spu_train_object,input_spu_test_object,max_iter)

报错问题：
x = array(<function SPU.__call__.<locals>.wrapper at 0xffff957f3760>, dtype=object) 
def dtype(x: Any, *, canonicalize: bool = False) -> DType: 
"""Return the dtype object for a value or type, optionally canonicalized based on X64 mode.""" if x is None: 
raise ValueError(f"Invalid argument to dtype: {x}.") is_type = isinstance(x, type) if is_type and x in python_scalar_dtypes: dt = python_scalar_dtypes[x] elif type(x) in python_scalar_dtypes: dt = python_scalar_dtypes[type(x)] elif is_type and _issubclass(x, np.generic): return np.dtype(x) elif issubdtype(getattr(x, 'dtype', None), extended): 
dt = x.dtype else: 
try: dt = np.result_type(x) 
except TypeError as err: raise TypeError(f"Cannot determine dtype of {x}") from err 
if dt not in _jax_dtype_set and not issubdtype(dt, extended): > raise TypeError(f"Value '{x}' with dtype {dt} is not a valid JAX array " 
"type. Only arrays of numeric types are supported by JAX.") E TypeError: Value '<function SPU.__call__.<locals>.wrapper at 0xffff957f3760>' with dtype object is not a valid JAX array type. Only arrays of numeric types are supported by JAX.

问题2：标识有@pytest.mark.parametrize的场景无法进入断点调试，直接跳过
Received JSON data in run script
Running pytest with args: ['-p', 'vscode_pytest', '--rootdir=/mnt/root/secretflow', '--capture=no', '/mnt/root/secretflow/tests/component/ml/test_ss_sgd.py::test_ss_sgd[SF_PARTY_PREFIX_alice-False]']
============================= test session starts ==============================
platform linux -- Python 3.10.14, pytest-8.3.2, pluggy-1.5.0
rootdir: /mnt/root/secretflow
configfile: pytest.ini
plugins: xdist-3.6.1
Fixture names for test_ss_sgd[SF_PARTY_PREFIX_alice-False]: ['sf_party_for_4pc', 'comp_prod_sf_cluster_config', 'with_checkpoint', 'request']
collected 1 item

tests/component/ml/test_ss_sgd.py s

=============================== warnings summary ===============================
secretflow/data/core/pandas/dataframe.py:19
secretflow/data/core/pandas/dataframe.py:19
  /mnt/root/secretflow/secretflow/data/core/pandas/dataframe.py:19: DeprecationWarning: jax.tree_map is deprecated: use jax.tree.map (jax v0.4.25 or newer) or jax.tree_util.tree_map (any JAX version).
    from jax import tree_map

../../miniforge3/lib/python3.10/site-packages/cleantext/clean.py:77: 31 warnings
  /mnt/miniforge3/lib/python3.10/site-packages/cleantext/clean.py:77: DeprecationWarning: The parameter 'use_aliases' in emoji.demojize() is deprecated and will be removed in version 2.0.0. Use language='alias' instead.
  To hide this warning, pin/downgrade the package to 'emoji~=1.6.3'
    text = demojize(text, use_aliases=True)

../../miniforge3/lib/python3.10/site-packages/cleantext/clean.py:91: 31 warnings
  /mnt/miniforge3/lib/python3.10/site-packages/cleantext/clean.py:91: DeprecationWarning: The parameter 'use_aliases' in emoji.emojize() is deprecated and will be removed in version 2.0.0. Use language='alias' instead.
  To hide this warning, pin/downgrade the package to 'emoji~=1.6.3'
    text = emojize(text, use_aliases=True)

-- Docs: https://docs.pytest.org/en/stable/how-to/capture-warnings.html
======================= 1 skipped, 64 warnings in 2.97s ========================
目前使用的vscode进行单元测试，基本都是参考网上的教程进行的pytest的配置，非参数化定义的场景都能正常测试过程。
```

隐语SecretFlow/secretpad

内容风险标识

评论 (0)

隐语SecretFlow/secretpad .gitee-modal { width: 500px !important; }

内容风险标识