pythonの helpコマンドの解釈方法

Question

前提

pythonのヘルプの解釈の仕方

ヘルプコマンドを実行した際に、
,/ や場合によっては、,* という利用方法が表示されることがあります。

ただ、実際にそういう引数を実行しようとするとエラーとなってしまいます。
そもそも,/ や、,*というのは引数として解釈してはいけないのでしょうか？

例えば下記。
help(abs)

Help on built-in function abs in module builtins:

abs(x, /)
Return the absolute value of the argument.

実際に実行した時のメッセージ
print(abs(13))
13

print(abs(13,/))
Traceback (most recent call last):
File "/var/lib/python/site-packages/python3.9/IPython/core/interactiveshell.py", line 2944, in _run_cell
return runner(coro)
File "/var/lib/python/si
＊以下省略

どうぞよろしくお願いします。

Answer 1

help

Note that if a slash(/) appears in the parameter list of a function when invoking help(), it means that the parameters prior to the slash are positional-only. For more info, see the FAQ entry on positional-only parameters.

つまりその関数の引数は位置引数しか使えない（キーワード引数は使えない）ことを表しています。

>>> help(abs)
Help on built-in function abs in module builtins:

abs(x, /)
    Return the absolute value of the argument.

>>> abs(12)
12
>>> abs(x=12)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: abs() takes no keyword arguments
>>>

Comments

[net-sn]

有難うございました！関数に対する引数の指定方法を明示していたのですね。
おかげさまで疑問解消しました！ありがとうございます！

[dameo]

補足です。
https://docs.python.org/ja/3.11/reference/compound_stmts.html#function-definitions
「Parameters after "*" or "*identifier" are keyword-only parameters and may only be passed by keyword arguments. Parameters before "/" are positional-only parameters and may only be passed by positional arguments.」