[API-Compat] paddle.compat.split is added and tested

[Enigmatisms]

PR Category

Operator Mechanism

PR Types

New features

Description

增加了 paddle.compat.split。此 API 的函数签名、行为与torch.split完全一致。具体见 torch.split 文档以及后续更新的 paddle doc。增加了如下机制：

• 用 split_size_or_sections 在各种情况下（动、静态图）正确计算 num_or_sections 的方法。此API不再要求分成相同大小的 tensor（最后一个tensor可以略小，取决于 int 类型的 split size 是否能整除 shape 对应维度）。
• 增加了 forbid_keywords 装饰器：此装饰器接收一个或者多个禁止用户输入（可能混淆）的 keyword arguments，并接收一个“建议调用函数的名称”。当用户输入错误的 keyword arguments 时，将会报错提示。例子：

# paddle.split 误用为 paddle.compat.split
paddle.split(some_tensor, split_size_or_sections = 3, dim = 0)

报错如下：

TypeError: split() received unexpected keyword arguments 'tensor', 'split_size_or_sections', 'dim'. 
Did you mean to use paddle.compat.split() instead?

对于 paddle.compat.split 误用为 paddle.split同样有此操作。

• 新增了 test_compat_split.py 用于测试输入输出 shape，size 以及是否能正确报错

Pcard-89620

[paddle-bot]

你的PR提交成功，感谢你对开源项目的贡献!
请关注后续CI自动化测试结果，详情请参考Paddle-CI手册。
Your PR has been submitted. Thanks for your contribution!
Please wait for the result of CI firstly. See Paddle CI Manual for details.

[Enigmatisms]

/re-run all-failed

[codecov-commenter]

Codecov Report

❌ Patch coverage is 81.55340% with 19 lines in your changes missing coverage. Please review.
⚠️ Please upload report for BASE (develop@698721e). Learn more about missing BASE report.

⚠️ Current head 5315118 differs from pull request most recent head 3ec6b4d

Please upload reports for the commit 3ec6b4d to get more accurate results.

Files with missing lines	Patch %	Lines
python/paddle/tensor/compat.py	74.32%	19 Missing ⚠️

❌ Your patch status has failed because the patch coverage (81.55%) is below the target coverage (90.00%). You can increase the patch coverage or adjust the target coverage.

Additional details and impacted files

@@            Coverage Diff             @@
##             develop   #74446   +/-   ##
==========================================
  Coverage           ?   81.55%           
==========================================
  Files              ?        4           
  Lines              ?      103           
  Branches           ?        0           
==========================================
  Hits               ?       84           
  Misses             ?       19           
  Partials           ?        0           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.