Skip to content
This repository was archived by the owner on May 27, 2026. It is now read-only.

plugin parses docstring differently than expected #52

Description

@dandhlee

With the given docstring:

        """Union[int, None]: Expiration time in milliseconds for a partition.

        If :attr:`partition_expiration` is set and :attr:`type_` is
        not set, :attr:`type_` will default to
        :attr:`~google.cloud.bigquery.table.TimePartitioningType.DAY`.
        """

It fails to parse properly and treat the whole syntax as a top line summary when it encounters xref:type_ since we look for :type in the code. This should be prevented by only looking for :type and nothing before/after.

Metadata

Metadata

Assignees

Labels

priority: p1Important issue which blocks shipping the next release. Will be fixed prior to next release.type: bugError or flaw in code with unintended results or allowing sub-optimal usage patterns.

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions