IntenseWebs/sphinx
3
0
Fork 0
mirror of https://github.com/sphinx-doc/sphinx.git synced 2025-02-25 18:55:22 -06:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #2432 from agronholm/kwonlyargs

Browse Source 
#2432 Fix unwanted * between varargs and keyword only args
This commit is contained in:
Takayuki SHIMIZUKAWA 2016-10-19 00:54:38 +09:00 committed by GitHub
commit 340c6fb9f4
3 changed files with 16 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
sphinx/ext/autodoc.py
View File

@ -369,7 +369,9 @@ def formatargspec(function, args, varargs=None, varkw=None, defaults=None,
formatted.append('*' + format_arg_with_annotation(varargs)) formatted.append('*' + format_arg_with_annotation(varargs))
if kwonlyargs: if kwonlyargs:
if not varargs:
formatted.append('*') formatted.append('*')
for kwarg in kwonlyargs: for kwarg in kwonlyargs:
arg_fd = StringIO() arg_fd = StringIO()
arg_fd.write(format_arg_with_annotation(kwarg)) arg_fd.write(format_arg_with_annotation(kwarg))

9
tests/test_autodoc.py
View File

@ -1052,14 +1052,17 @@ def test_type_hints():
# Keyword-only arguments # Keyword-only arguments
verify_arg_spec(f5, '(x: int, *, y: str, z: str) -> None') verify_arg_spec(f5, '(x: int, *, y: str, z: str) -> None')
# Keyword-only arguments with varargs
verify_arg_spec(f6, '(x: int, *args, y: str, z: str) -> None')
# Space around '=' for defaults # Space around '=' for defaults
verify_arg_spec(f6, '(x: int = None, y: dict = {}) -> None') verify_arg_spec(f7, '(x: int = None, y: dict = {}) -> None')
# Callable types # Callable types
verify_arg_spec(f7, '(x: typing.Callable[[int, str], int]) -> None') verify_arg_spec(f8, '(x: typing.Callable[[int, str], int]) -> None')
# Tuple types # Tuple types
verify_arg_spec(f8, '(x: typing.Tuple[int, str],' verify_arg_spec(f9, '(x: typing.Tuple[int, str],'
' y: typing.Tuple[int, ...]) -> None') ' y: typing.Tuple[int, ...]) -> None')
# Instance annotations # Instance annotations

10
tests/typing_test_data.py
View File

@ -35,16 +35,20 @@ def f5(x: int, *, y: str, z: str) -> None:
pass pass
def f6(x: int = None, y: dict = {}) -> None: def f6(x: int, *args, y: str, z: str) -> None:
pass pass
def f7(x: Callable[[int, str], int]) -> None: def f7(x: int = None, y: dict = {}) -> None:
pass
def f8(x: Callable[[int, str], int]) -> None:
# See https://github.com/ambv/typehinting/issues/149 for Callable[..., int] # See https://github.com/ambv/typehinting/issues/149 for Callable[..., int]
pass pass
def f8(x: Tuple[int, str], y: Tuple[int, ...]) -> None: def f9(x: Tuple[int, str], y: Tuple[int, ...]) -> None:
pass pass