Skip to content

Conversation

Copy link

Copilot AI commented Nov 30, 2025

For reviewers

  • I did not use AI
  • I used AI and thoroughly reviewed every code/docs change

Description of the change

Fixes CI failures and restores backward compatibility for CLI usage after the griffe/griffelib/griffecli workspace migration.

Changes:

  • pyproject.toml: Added tool.uv.sources section declaring griffelib and griffecli as workspace members (fixes uv sync failure)
  • CLI branding: Changed argparse prog from griffelib to griffe for backward-compatible command-line usage
  • Documentation: Restored all CLI examples to use griffe check/griffe dump instead of griffecli
  • installation.md: Added "Running Griffe" section documenting python -m griffecli as an alternative
  • Internal API references: Updated all griffe._internal references to griffelib._internal in documentation (architecture.md, loading.md, navigating.md, expressions.md, runtime-objects.md) to reflect the new package structure
$ griffe --help
usage: griffe [GLOBAL_OPTS...] COMMAND [COMMAND_OPTS...]

Relevant resources


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Co-authored-by: johnslavik <64036239+johnslavik@users.noreply.github.com>
Copilot AI changed the title [WIP] Reorganize as griffe and griffelib packages with uv workspaces Fix pyproject.toml workspace config and restore griffe CLI branding Nov 30, 2025
Copilot AI requested a review from johnslavik November 30, 2025 21:29
Our test suite is located in the `tests` folder. It is located outside of the sources as to not pollute distributions (it would be very wrong to publish a `tests` package as part of our distributions, since this name is extremely common), or worse, the public API. The `tests` folder is however included in our source distributions (`.tar.gz`), alongside most of our metadata and configuration files. Check out `pyproject.toml` to get the full list of files included in our source distributions.

The test suite is based on [pytest](https://docs.pytest.org/en/8.2.x/). Test modules reflect our internal API structure, and except for a few test modules that test specific aspects of our API, each test module tests the logic from the corresponding module in the internal API. For example, `test_finder.py` tests code of the `griffelib._internal.finder` internal module, while `test_functions` tests our ability to extract correct information from function signatures, statically. The general rule of thumb when writing new tests is to mirror the internal API. If a test touches to many aspects of the loading process, it can be added to the `test_loader` test module.
The test suite is based on [pytest](https://docs.pytest.org/en/8.2.x/). Test modules reflect our internal API structure, and except for a few test modules that test specific aspects of our API, each test module tests the logic from the corresponding module in the internal API. For example, `test_finder.py` tests code of the `griffe._internal.finder` internal module, while `test_functions` tests our ability to extract correct information from function signatures, statically. The general rule of thumb when writing new tests is to mirror the internal API. If a test touches to many aspects of the loading process, it can be added to the `test_loader` test module.
Copy link
Member

Choose a reason for hiding this comment

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

griffe._internal.finder -- this and similar are wrong

Copy link
Author

Choose a reason for hiding this comment

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

Fixed in 8ecd876. Updated all griffe._internal references to griffelib._internal in architecture.md, loading.md, navigating.md, expressions.md, and runtime-objects.md to reflect the new package structure.

@johnslavik
Copy link
Member

@copilot Do stuff

Co-authored-by: johnslavik <64036239+johnslavik@users.noreply.github.com>
@johnslavik johnslavik marked this pull request as ready for review November 30, 2025 23:50
@johnslavik johnslavik merged commit e254389 into b/migrate Nov 30, 2025
1 of 2 checks passed
Copy link
Author

Copilot AI commented Nov 30, 2025

@copilot Do stuff

Could you please clarify what specific changes or actions you'd like me to make?

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.

2 participants