Move pulpcore.cli.common.generic to pulp_cli.generic

The idea of using "pulpcore" as an open namespace inspired by the
python bindings was not a good one after all. Specifically it collides
with the way we build our docs. And due to the use of entrypoints it's
not even needed here. The symbols are imported at the old location for
compatibility for now.

Author: mdellweg

CHANGES/+move_generic.removal

@@ -0,0 +1,2 @@
+The module `generic` moved from `pulpcore.cli.common.generic` to `pulp_cli.generic`.
+The old import path is still available for compatibility reasons.

Makefile

@@ -51,7 +51,7 @@ docs:
 	pulp-docs build
 
 servedocs:
-	pulp-docs serve -w CHANGES.md -w pulp-glue/pulp_glue -w pulpcore/cli/common/generic.py
+	pulp-docs serve -w CHANGES.md -w pulp-glue/pulp_glue -w pulp_cli/generic.py
 
 pulp-glue/pulp_glue/%/locale/messages.pot: pulp-glue/pulp_glue/%/*.py
 	xgettext -d $* -o $@ pulp-glue/pulp_glue/$*/*.py

cookiecutter/bootstrap/{{ cookiecutter.__project_name }}/pulpcore/cli/{{ cookiecutter.app_label }}/__init__.py

@@ -1,8 +1,8 @@
 import typing as t
 
 import click
+from pulp_cli.generic import pulp_group
 from pulp_glue.common.i18n import get_translation
-from pulpcore.cli.common.generic import pulp_group
 
 # TODO Implement these
 # from pulpcore.cli.{{ cookiecutter.app_label }}.content import content

cookiecutter/ci/{{ cookiecutter.__project_name }}/Makefile

@@ -74,7 +74,7 @@ docs:
 	pulp-docs build
 
 servedocs:
-	pulp-docs serve -w CHANGES.md -w pulp-glue/pulp_glue -w pulpcore/cli/common/generic.py
+	pulp-docs serve -w CHANGES.md -w pulp-glue/pulp_glue -w pulp_cli/generic.py
 {%- endif %}
 {%- if cookiecutter.translations %}
 {%- if cookiecutter.glue %}

docs/dev/learn/architecture.md

@@ -38,7 +38,7 @@ A plugin must register itself with the main app by specifying its main module as
 The plugin should then attach subcommands to the `pulpcore.cli.common.main` command by providing a `mount` method in the main module.
 
 ```python
-from pulpcore.cli.common.generic import pulp_command
+from pulp_cli.generic import pulp_command
 
 @pulp_command()
 def my_command():
@@ -52,7 +52,7 @@ def mount(main: click.Group, **kwargs: Any) -> None:
 ## Contexts
 
 In `click`, every subcommand is accompanied by a `click.Context`, and objects can be attached to them.
-In this CLI we attach a [`PulpCLIContext`][pulpcore.cli.common.generic.PulpCLIContext] to the main command, which inherits from `pulp-glue`'s [`PulpContext`][pulp_glue.common.context.PulpContext].
+In this CLI we attach a [`PulpCLIContext`][pulp_cli.generic.PulpCLIContext] to the main command, which inherits from `pulp-glue`'s [`PulpContext`][pulp_glue.common.context.PulpContext].
 This context handles the communication to the pulp server through its `api` property.
 
 Further we encourage the handling of communication with certain endpoints by subclassing the [`PulpEntityContext`][pulp_glue.common.context.PulpEntityContext] or some of the resource-specific children, such as [PulpRepositoryContext][pulp_glue.common.context.PulpRepositoryContext].
@@ -80,20 +80,20 @@ def my_sub_command(entity_ctx):
 
 For certain often repeated patterns like listing all entities of a particular kind,
 we provide generic commands that use the underlying context objects.
-The following example shows the use of the [`show_command`][pulpcore.cli.common.generic.show_command] generic.
+The following example shows the use of the [`show_command`][pulp_cli.generic.show_command] generic.
 
 ```python
-from pulpcore.cli.common.generic import name_option, show_command,
+from pulp_cli.generic import name_option, show_command,
 
 lookup_params = [name_option]
 my_command.add_command(show_command(decorators=lookup_params))
 ```
 
-To add options to these subcommands, pass a list of [`PulpOption`][pulpcore.cli.common.generic.PulpOption] objects to the `decorators` argument.
-Preferably these are created using the [`pulp_option`][pulpcore.cli.common.generic.pulp_option] factory.
+To add options to these subcommands, pass a list of [`PulpOption`][pulp_cli.generic.PulpOption] objects to the `decorators` argument.
+Preferably these are created using the [`pulp_option`][pulp_cli.generic.pulp_option] factory.
 
 ```python
-from pulpcore.cli.common.generic import list_command,
+from pulp_cli.generic import list_command,
 
 filter_params = [
     pulp_option("--name"),

docs/dev/reference/common_generic.md

@@ -0,0 +1,3 @@
+# pulp\_cli.generic
+
+::: pulp_cli.generic