Rename project to ansible-development-environment

Related: #59

.config/dictionary.txt

@@ -14,7 +14,6 @@ fqcn
 levelname
 levelno
 netcommon
-pip4a
 reqs
 setenv
 specp

.gitignore

@@ -166,4 +166,4 @@ cython_debug/
 # and should all have detailed explanations
 
 # Version created and populated by setuptools_scm
-/src/pip4a/_version.py
+/src/ansible-development-environment/_version.py

.pre-commit-config.yaml

@@ -79,6 +79,7 @@ repos:
           - pytest
           - pyyaml
           - subprocess_tee
+          - setuptools
           - tox
 
   - repo: https://github.com/pre-commit/mirrors-mypy.git

.vscode/launch.json

@@ -8,7 +8,7 @@
       "name": "Python: Module",
       "type": "python",
       "request": "launch",
-      "module": "pip4a",
+      "module": "ansible_development_environment",
       "args": ["inspect", "-v", "-v", "-vv"],
       "justMyCode": true
     },

README.md

@@ -1,4 +1,4 @@
-# pip4a
+# ansible-development-environment
 
 A pip-like install for ansible collections.
 
@@ -19,10 +19,10 @@ By placing collections into the python site-packages directory they are discover
 ### Setting up a development environment
 
 ```
-$ pip install pip4a --user
+$ pip install ansible-development-environment --user
 $ git clone <collection_repo>
 $ cd <collection_repo>
-$ pip4a install -e .\[test] --venv venv
+$ ansible-development-environment install -e .\[test] --venv venv
 INFO: Found collection name: network.interfaces from /home/bthornto/github/network.interfaces/galaxy.yml.
 INFO: Creating virtual environment: /home/bthornto/github/network.interfaces/venv
 INFO: Virtual environment: /home/bthornto/github/network.interfaces/venv
@@ -44,7 +44,7 @@ source venv/bin/activate
 ### Tearing down the development environment
 
 ```
-$ pip4a uninstall ansible.scm
+$ ansible-development-environment uninstall ansible.scm
 INFO     Found collection name: ansible.scm from /home/bthornto/github/ansible.scm/galaxy.yml.
 INFO     Requirements file /home/bthornto/github/ansible.scm/requirements.txt is empty, skipping
 INFO     Uninstalling python requirements from /home/bthornto/github/ansible.scm/test-requirements.txt
@@ -57,8 +57,8 @@ INFO     Removed collection root: /home/bthornto/github/ansible.scm/venv/lib64/p
 
 ## Help
 
-`pip4a --help`
+`ansible-development-environment --help`
 
-`pip4a install --help`
+`ansible-development-environment install --help`
 
-`pip4a uninstall --help`
+`ansible-development-environment uninstall --help`

pyproject.toml

@@ -24,18 +24,18 @@ dynamic = ["dependencies", "optional-dependencies", "version"]
 keywords = ["ansible"]
 license = {text = "GPL-3.0-only"}
 maintainers = [{"email" = "bthornto@redhat.com", "name" = "Bradley Thornton"}]
-name = "pip4a"
+name = "ansible-development-environment"
 readme = "README.md"
 requires-python = ">=3.9"
 
 [project.scripts]
-pip4a = "pip4a.cli:main"
+ansible-development-environment = "ansible_development_environment.cli:main"
 
 [project.urls]
-changelog = "https://github.com/cidrblock/pip4a/releases"
-documentation = "https://pip4a.readthedocs.io/en/latest/"
-homepage = "https://github.com/cidrblock/pip4a"
-repository = "https://github.com/cidrblock/pip4a"
+changelog = "https://github.com/cidrblock/ansible-development-environment/releases"
+documentation = "https://ansible.readthedocs.io/projects/development-environment/"
+homepage = "https://github.com/ansible/ansible-development-environment"
+repository = "https://github.com/ansible/ansible-development-environment"
 
 [tool.mypy]
 files = ["src", "tests"]
@@ -261,7 +261,7 @@ optional-dependencies.test = {file = [".config/requirements-test.txt"]}
 
 [tool.setuptools_scm]
 local_scheme = "no-local-version"
-write_to = "src/pip4a/_version.py"
+write_to = "src/ansible_development_environment/_version.py"
 
 [tool.tomlsort]
 all = true

src/ansible_development_environment/__main__.py

@@ -0,0 +1,11 @@
+"""A runpy entry point for ansible-development-environment.
+
+This makes it possible to invoke CLI
+via :command:`python -m ansible_development_environment`.
+"""
+
+from .cli import main
+
+
+if __name__ == "__main__":
+    main()

src/ansible_development_environment/_version.py

@@ -0,0 +1,17 @@
+# file generated by setuptools_scm
+# don't change, don't track in version control
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import Union
+
+    VERSION_TUPLE = tuple[Union[int, str], ...]
+else:
+    VERSION_TUPLE = object
+
+version: str
+__version__: str
+__version_tuple__: VERSION_TUPLE
+version_tuple: VERSION_TUPLE
+
+__version__ = version = "0.2.18.dev2"
+__version_tuple__ = version_tuple = (0, 2, 18, "dev2")

src/pip4a/arg_parser.py → src/ansible_development_environment/arg_parser.py

@@ -14,7 +14,9 @@
     try:
         import pkg_resources
 
-        __version__ = pkg_resources.get_distribution("pip4a").version
+        __version__ = pkg_resources.get_distribution(
+            "ansible_development_environment",
+        ).version
     except Exception:  # pylint: disable=broad-except # noqa: BLE001
         # this is the fallback SemVer version picked by setuptools_scm when tag
         # information is not available.
@@ -31,7 +33,7 @@ def common_args(parser: ArgumentParser) -> None:
         "--lf",
         "--log-file <file>",
         dest="log_file",
-        default=str(Path.cwd() / "pip4a.log"),
+        default=str(Path.cwd() / "ansible-development-environment.log"),
         help="Log file to write to.",
     )
     parser.add_argument(

src/pip4a/cli.py → src/ansible_development_environment/cli.py

@@ -9,7 +9,7 @@
 from pathlib import Path
 from typing import TYPE_CHECKING
 
-from pip4a import subcommands
+from ansible_development_environment import subcommands
 
 from .arg_parser import parse
 from .config import Config

src/pip4a/config.py → src/ansible_development_environment/config.py

@@ -1,4 +1,4 @@
-"""Constants, for now, for pip4a."""
+"""Constants, for now, for ansible-development-environment."""
 
 from __future__ import annotations
 
@@ -51,7 +51,7 @@ def init(self: Config) -> None:
     @property
     def cache_dir(self: Config) -> Path:
         """Return the cache directory."""
-        cache_dir = self.venv / ".pip4a"
+        cache_dir = self.venv / ".ansible-development-environment"
         if not cache_dir.exists():
             cache_dir.mkdir(parents=True)
         return cache_dir

src/pip4a/output.py → src/ansible_development_environment/output.py

@@ -235,7 +235,7 @@ def __init__(  # noqa: PLR0913
             "warning": 0,
         }
         self.term_features = term_features
-        self.logger = logging.getLogger("pip4a")
+        self.logger = logging.getLogger("ansible_development_environment")
         if log_level != "notset":
             self.logger.setLevel(log_level.upper())
             self.log_to_file = bool(log_file)

src/pip4a/subcommands/__init__.py → src/ansible_development_environment/subcommands/__init__.py

@@ -1,4 +1,4 @@
-"""The subcommands module contains all the subcommands for pip4a."""
+"""The subcommands module contains all the subcommands for ansible-development-environment."""
 
 # ruff: noqa: F401
 

src/pip4a/subcommands/checker.py → src/ansible_development_environment/subcommands/checker.py

@@ -10,7 +10,7 @@
 from packaging.specifiers import InvalidSpecifier, SpecifierSet
 from packaging.version import Version
 
-from pip4a.utils import (
+from ansible_development_environment.utils import (
     builder_introspect,
     collect_manifests,
     oxford_join,
@@ -19,8 +19,8 @@
 
 
 if TYPE_CHECKING:
-    from pip4a.config import Config
-    from pip4a.output import Output
+    from ansible_development_environment.config import Config
+    from ansible_development_environment.output import Output
 
 
 class Checker:
@@ -122,7 +122,7 @@ def _collection_deps(self: Checker) -> None:  # noqa: C901, PLR0912, PLR0915
                         f" {dep} {version} but it is not installed."
                     )
                     self._output.error(err)
-                    msg = f"Try running `pip4a install {dep}`"
+                    msg = f"Try running `ansible-development-environment install {dep}`"
                     self._output.hint(msg)
                     missing = True
 
@@ -136,7 +136,7 @@ def _python_deps(self: Checker) -> None:
         if self._system_dep_missing:
             msg = "System packages are missing. Python dependency checking may fail."
             self._output.warning(msg)
-            msg = "Install system packages and re-run `pip4a check`."
+            msg = "Install system packages and re-run `ansible-development-environment check`."
             self._output.hint(msg)
         missing_file = self._config.venv_cache_dir / "pip-report.txt"
         command = (

src/pip4a/subcommands/inspector.py → src/ansible_development_environment/subcommands/inspector.py

@@ -6,12 +6,12 @@
 
 from typing import TYPE_CHECKING
 
-from pip4a.utils import collect_manifests
+from ansible_development_environment.utils import collect_manifests
 
 
 if TYPE_CHECKING:
-    from pip4a.config import Config
-    from pip4a.output import Output
+    from ansible_development_environment.config import Config
+    from ansible_development_environment.output import Output
 
 try:
     from pip._vendor.rich import print_json

src/pip4a/subcommands/installer.py → src/ansible_development_environment/subcommands/installer.py

@@ -9,8 +9,11 @@
 from pathlib import Path
 from typing import TYPE_CHECKING
 
-from pip4a.collection import Collection, parse_collection_request
-from pip4a.utils import (
+from ansible_development_environment.collection import (
+    Collection,
+    parse_collection_request,
+)
+from ansible_development_environment.utils import (
     builder_introspect,
     collections_from_requirements,
     oxford_join,
@@ -21,8 +24,8 @@
 
 
 if TYPE_CHECKING:
-    from pip4a.config import Config
-    from pip4a.output import Output
+    from ansible_development_environment.config import Config
+    from ansible_development_environment.output import Output
 
 
 class Installer:

src/pip4a/subcommands/lister.py → src/ansible_development_environment/subcommands/lister.py

@@ -1,15 +1,15 @@
-"""Lister module for pip4a."""
+"""Lister module for ansible-development-environment."""
 
 from __future__ import annotations
 
 from typing import TYPE_CHECKING
 
-from pip4a.utils import collect_manifests, term_link
+from ansible_development_environment.utils import collect_manifests, term_link
 
 
 if TYPE_CHECKING:
-    from pip4a.config import Config
-    from pip4a.output import Output
+    from ansible_development_environment.config import Config
+    from ansible_development_environment.output import Output
 
 
 class Lister:

src/pip4a/subcommands/treemaker.py → src/ansible_development_environment/subcommands/treemaker.py

@@ -5,13 +5,13 @@
 
 from typing import TYPE_CHECKING, Union
 
-from pip4a.tree import Tree
-from pip4a.utils import builder_introspect, collect_manifests
+from ansible_development_environment.tree import Tree
+from ansible_development_environment.utils import builder_introspect, collect_manifests
 
 
 if TYPE_CHECKING:
-    from pip4a.config import Config
-    from pip4a.output import Output
+    from ansible_development_environment.config import Config
+    from ansible_development_environment.output import Output
 
 ScalarVal = Union[bool, str, float, int, None]
 JSONVal = Union[ScalarVal, list["JSONVal"], dict[str, "JSONVal"]]

src/pip4a/subcommands/uninstaller.py → src/ansible_development_environment/subcommands/uninstaller.py

@@ -7,13 +7,16 @@
 from pathlib import Path
 from typing import TYPE_CHECKING
 
-from pip4a.collection import Collection, parse_collection_request
-from pip4a.utils import collections_from_requirements
+from ansible_development_environment.collection import (
+    Collection,
+    parse_collection_request,
+)
+from ansible_development_environment.utils import collections_from_requirements
 
 
 if TYPE_CHECKING:
-    from pip4a.config import Config
-    from pip4a.output import Output
+    from ansible_development_environment.config import Config
+    from ansible_development_environment.output import Output
 
 
 class UnInstaller: