Add CLI entry point umd

- add the following file:
  + src/urban_meal_delivery/console.py => click-based CLI tools
  + tests/test_console.py => tests for the module above
- add a CLI entry point `umd`:
  + implement the --version / -V option
    to show the installed package's version
  + rework to package's top-level:
    * add a __pkg_name__ variable to parameterize the package name
  + add unit and integration tests
- fix that pylint cannot know the proper order of imports in the
  isolated nox session

src/urban_meal_delivery/__init__.py

@@ -1,9 +1,15 @@
 """Source code for the urban-meal-delivery research project."""
 
-from importlib import metadata
+from importlib import metadata as _metadata
 
 
 try:
-    __version__ = metadata.version(__name__)
-except metadata.PackageNotFoundError:  # pragma: no cover
+    _pkg_info = _metadata.metadata(__name__)
+
+except _metadata.PackageNotFoundError:  # pragma: no cover
+    __pkg_name__ = 'unknown'
     __version__ = 'unknown'
+
+else:
+    __pkg_name__ = _pkg_info['name']
+    __version__ = _pkg_info['version']

src/urban_meal_delivery/console.py

@@ -0,0 +1,37 @@
+"""Provide CLI scripts for the project."""
+
+from typing import Any
+
+import click
+from click.core import Context
+
+import urban_meal_delivery
+
+
+def show_version(ctx: Context, _param: Any, value: bool) -> None:
+    """Show the package's version."""
+    # If --version / -V is NOT passed in,
+    # continue with the command.
+    if not value or ctx.resilient_parsing:
+        return
+
+    # Mimic the colors of `poetry version`.
+    pkg_name = click.style(urban_meal_delivery.__pkg_name__, fg='green')  # noqa:WPS609
+    version = click.style(urban_meal_delivery.__version__, fg='blue')  # noqa:WPS609
+    # Include a warning for development versions.
+    warning = click.style(' (development)', fg='red') if '.dev' in version else ''
+    click.echo(f'{pkg_name}, version {version}{warning}')
+    ctx.exit()
+
+
+@click.command()
+@click.option(
+    '--version',
+    '-V',
+    is_flag=True,
+    callback=show_version,
+    is_eager=True,
+    expose_value=False,
+)
+def main() -> None:
+    """The urban-meal-delivery research project."""