Run migration script

Author: johnslavik

config/coverage.ini

@@ -2,7 +2,7 @@
 branch = true
 parallel = true
 source =
-  src/griffe
+  packages/griffe/src/griffe
   tests/
 
 [coverage:paths]

config/ruff.toml

@@ -38,24 +38,24 @@ ignore = [
 logger-objects = ["griffe.logger"]
 
 [lint.per-file-ignores]
-"src/griffe/__main__.py" = [
+"packages/griffe/src/griffe/__main__.py" = [
     "D100",  # Missing module docstring
 ]
-"src/griffe/_internal/cli.py" = [
+"packages/griffe/src/griffe/_internal/cli.py" = [
     "T201",  # Print statement
 ]
-"src/griffe/_internal/git.py" = [
+"packages/griffe/src/griffe/_internal/git.py" = [
     "S603",  # `subprocess` call: check for execution of untrusted input
     "S607",  # Starting a process with a partial executable path
 ]
-"src/griffe/_internal/agents/nodes/*.py" = [
+"packages/griffe/src/griffe/_internal/agents/nodes/*.py" = [
     "ARG001",  # Unused function argument
     "N812",  # Lowercase `keyword` imported as non-lowercase `NodeKeyword`
 ]
-"src/griffe/_internal/debug.py" = [
+"packages/griffe/src/griffe/_internal/debug.py" = [
     "T201",  # Print statement
 ]
-"src/griffe/_internal/**.py" = [
+"packages/griffe/src/griffe/_internal/**.py" = [
     "D100",  # Missing docstring in public module
 ]
 "scripts/*.py" = [

docs/guide/contributors/architecture.md

@@ -22,8 +22,8 @@ descriptions = {
     "scripts": "Our different scripts. See [Scripts, configuration](#scripts-configuration).",
     "site": "Documentation site, built with `make run mkdocs build` (git-ignored).",
     "src": "The source of our Python package(s). See [Sources](#sources) and [Program structure](#program-structure).",
-    "src/griffe": "Our public API, exposed to users. See [Program structure](#program-structure).",
-    "src/griffe/_internal": "Our internal API, hidden from users. See [Program structure](#program-structure).",
+    "packages/griffe/src/griffe": "Our public API, exposed to users. See [Program structure](#program-structure).",
+    "packages/griffe/src/griffe/_internal": "Our internal API, hidden from users. See [Program structure](#program-structure).",
     "tests": "Our test suite. See [Tests](#tests).",
     ".copier-answers.yml": "The answers file generated by [Copier](https://copier.readthedocs.io/en/stable/). See [Boilerplate](#boilerplate).",
     "devdeps.txt": "Our development dependencies specification. See [`make setup`][command-setup] command.",
@@ -108,7 +108,7 @@ The test suite is based on [pytest](https://docs.pytest.org/en/8.2.x/). Test mod
 
 ## Program structure
 
-The internal API is contained within the `src/griffe/_internal` folder. The top-level `griffe/__init__.py` module exposes all the public API, by importing the internal objects from various submodules of `griffe._internal`.
+The internal API is contained within the `packages/griffe/src/griffe/_internal` folder. The top-level `griffe/__init__.py` module exposes all the public API, by importing the internal objects from various submodules of `griffe._internal`.
 
 Users then import `griffe` directly, or import objects from it.
 
@@ -122,7 +122,7 @@ if os.getenv("DEPLOY") == "true":
     from pydeps.target import Target
 
     cli.verbose = cli._not_verbose
-    options = cli.parse_args(["src/griffe", "--noshow", "--reverse"])
+    options = cli.parse_args(["packages/griffe/src/griffe", "--noshow", "--reverse"])
     colors.START_COLOR = 128
     target = Target(options["fname"])
     with target.chdir_work():

docs/guide/users/checking.md

@@ -713,11 +713,11 @@ When running `griffe check` in CI, you can enable GitHub's annotations thanks to
 
 ```console
 % python -m griffe check -fgithub -ssrc griffe
-::warning file=src/griffe/finder.py,line=58,title=Package.name::Attribute value was changed: `name` -> unset
-::warning file=src/griffe/finder.py,line=60,title=Package.path::Attribute value was changed: `path` -> unset
-::warning file=src/griffe/finder.py,line=62,title=Package.stubs::Attribute value was changed: `stubs` -> `None`
-::warning file=src/griffe/finder.py,line=75,title=NamespacePackage.name::Attribute value was changed: `name` -> unset
-::warning file=src/griffe/finder.py,line=77,title=NamespacePackage.path::Attribute value was changed: `path` -> unset
+::warning file=packages/griffe/src/griffe/finder.py,line=58,title=Package.name::Attribute value was changed: `name` -> unset
+::warning file=packages/griffe/src/griffe/finder.py,line=60,title=Package.path::Attribute value was changed: `path` -> unset
+::warning file=packages/griffe/src/griffe/finder.py,line=62,title=Package.stubs::Attribute value was changed: `stubs` -> `None`
+::warning file=packages/griffe/src/griffe/finder.py,line=75,title=NamespacePackage.name::Attribute value was changed: `name` -> unset
+::warning file=packages/griffe/src/griffe/finder.py,line=77,title=NamespacePackage.path::Attribute value was changed: `path` -> unset
 ```
 
 ## Next steps

packages/griffe/src/griffe/griffe/__init__.py

@@ -0,0 +1,14 @@
+"""Griffe CLI package. Re-exports griffelib, with CLI-only symbols on top."""
+
+from griffe._internal.cli import DEFAULT_LOG_LEVEL, check, dump, get_parser, main
+from griffelib import *
+from griffelib import __all__ as __lib_all__
+
+__all__ = [
+    "DEFAULT_LOG_LEVEL",
+    "check",
+    "dump",
+    "get_parser",
+    "main",
+    *__lib_all__,
+]

src/griffe/__main__.py …ges/griffe/src/griffe/griffe/__main__.pysrc/griffe/__main__.py renamed to packages/griffe/src/griffe/griffe/__main__.py src/griffe/__main__.py renamed to packages/griffe/src/griffe/griffe/__main__.py

@@ -24,21 +24,21 @@
 
 import colorama
 
-from griffe._internal import debug
-from griffe._internal.diff import find_breaking_changes
-from griffe._internal.encoders import JSONEncoder
-from griffe._internal.enumerations import ExplanationStyle, Parser
-from griffe._internal.exceptions import ExtensionError, GitError
-from griffe._internal.extensions.base import load_extensions
-from griffe._internal.git import _get_latest_tag, _get_repo_root
-from griffe._internal.loader import GriffeLoader, load, load_git, load_pypi
-from griffe._internal.logger import logger
+from griffelib._internal import debug
+from griffelib._internal.diff import find_breaking_changes
+from griffelib._internal.encoders import JSONEncoder
+from griffelib._internal.enumerations import ExplanationStyle, Parser
+from griffelib._internal.exceptions import ExtensionError, GitError
+from griffelib._internal.extensions.base import load_extensions
+from griffelib._internal.git import _get_latest_tag, _get_repo_root
+from griffelib._internal.loader import GriffeLoader, load, load_git, load_pypi
+from griffelib._internal.logger import logger
 
 if TYPE_CHECKING:
     from collections.abc import Sequence
 
-    from griffe._internal.docstrings.parsers import DocstringOptions, DocstringStyle
-    from griffe._internal.extensions.base import Extension, Extensions
+    from griffelib._internal.docstrings.parsers import DocstringOptions, DocstringStyle
+    from griffelib._internal.extensions.base import Extension, Extensions
 
 
 DEFAULT_LOG_LEVEL = os.getenv("GRIFFE_LOG_LEVEL", "INFO").upper()