Skip to content

Add docstrings to pyiceberg/table/inspect.py#3457

Open
RyukR1 wants to merge 1 commit into
apache:mainfrom
RyukR1:add-docstrings-inspect-py
Open

Add docstrings to pyiceberg/table/inspect.py#3457
RyukR1 wants to merge 1 commit into
apache:mainfrom
RyukR1:add-docstrings-inspect-py

Conversation

@RyukR1

@RyukR1 RyukR1 commented Jun 4, 2026

Copy link
Copy Markdown

closes #1191

Rationale for this change

pyiceberg/table/inspect.py had no docstrings on any of its public
or private methods. This PR adds Google-style docstrings to all
methods of the InspectTable class, including the class-level
docstring. This improves discoverability and makes the API
self-documenting.

Are these changes tested?

  • make test — 296 table tests pass ✅
  • make lint — all 12 checks pass including pydocstyle and mypy

Are there any user-facing changes?

No. Docstrings only — no behavior or API changes.

@Fokko Fokko left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks like a good start, thanks @RyukR1

Comment thread pyiceberg/table/inspect.py Outdated

@rambleraptor rambleraptor left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Love the extra documentation. Thanks a lot!

@RyukR1 RyukR1 force-pushed the add-docstrings-inspect-py branch from 0f91358 to 2d302ad Compare June 10, 2026 02:08
Comment on lines +350 to +351
pa.Table: A table with columns: ``partition`` (struct, for
partitioned tables), ``spec_id``, ``record_count``,

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

spec_id is also for partitioned tables, right?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add Docstrings to pyiceberg/table/inspect.py

4 participants