Support for python 3.8 positional only argument syntax.

[FasterSpeeding]

Expected Behavior

I'd expect the parameters for methods that use the positional only argument syntax that was introduced in python 3.8 (see what's new to python3.8 for more information) to include / as to indicate that arguments to the left of / are positional only (e.g. def compile (self, method: str, /, **kwargs: Any) -> CompiledRoute).

Actual Behavior

The / argument is ignored, resulting in there being no indication that some of the arguments can only be positional, as shown in the screenshot below.

Steps to Reproduce

Generate documentation for a method that uses python 3.8's positional only argument syntax (see what's new to python3.8 for more information). The following method was used to produce the example actual behavior given above.

def compile(self, method: str, /, **kwargs: typing.Any) -> CompiledRoute:
    """Generate a formatted `CompiledRoute` for this route template.

    This takes into account any URL parameters that have been passed, and extracting
    the `major_params` for bucket hash operations accordingly.

    Parameters
    ----------
    method : str
        The method to use.
    **kwargs : typing.Any
        Any parameters to interpolate into the route path.

    Returns
    -------
    CompiledRoute
        The compiled route.
    """
    major_hash_part = "-".join((str(kwargs[p]) for p in self.major_params))

    return CompiledRoute(method, self.path_template, self.path_template.format_map(kwargs), major_hash_part)

Additional info

• pdoc version: 0.8.1
• python version: 3.8.2

[kernc]

Thanks for the report. This is the relevant bit if you'd like to fix it:

pdoc/pdoc/__init__.py

Lines 1250 to 1288 in bedabc0

	params = []
	kw_only = False
	EMPTY = inspect.Parameter.empty
	if link:
	from pdoc.html_helpers import _linkify
	_linkify = partial(_linkify, link=link, module=module)
	for p in signature.parameters.values(): # type: inspect.Parameter
	if not _is_public(p.name) and p.default is not EMPTY:
	continue
	if p.kind == p.VAR_POSITIONAL:
	kw_only = True
	if p.kind == p.KEYWORD_ONLY and not kw_only:
	kw_only = True
	params.append('*')
	p = safe_default_value(p)
	if not annotate:
	p = p.replace(annotation=EMPTY)
	s = str(p)
	if p.annotation is not EMPTY:
	if sys.version_info < (3, 7):
	# PEP8-normalize whitespace
	s = re.sub(r'(?<!\s)=(?!\s)', ' = ', re.sub(r':(?!\s)', ': ', s, 1), 1)
	# "Eval" forward-declarations (typing string literals)
	if isinstance(p.annotation, str):
	s = s.replace("'%s'" % p.annotation, p.annotation, 1)
	s = s.replace(' ', '\N{NBSP}') # prevent improper line breaking
	if link:
	annotation = inspect.formatannotation(p.annotation)
	linked_annotation = re.sub(r'[\w\.]+', _linkify, annotation)
	s = linked_annotation.join(s.rsplit(annotation, 1)) # "rreplace" once
	params.append(s)