Add offline option to prepare_environment (#138)

Fixes: #137

src/ansible_compat/runtime.py

@@ -301,12 +301,14 @@ def prepare_environment(
         required_collections: Optional[Dict[str, str]] = None,
         retry: bool = False,
         install_local: bool = False,
+        offline: bool = False,
     ) -> None:
         """Make dependencies available if needed."""
         if required_collections is None:
             required_collections = {}
 
-        self.install_requirements("requirements.yml", retry=retry)
+        if not offline:
+            self.install_requirements("requirements.yml", retry=retry)
 
         destination = f"{self.cache_dir}/collections" if self.cache_dir else None
         for name, min_version in required_collections.items():

test/roles/acme.missing_deps/meta/main.yml

@@ -0,0 +1,8 @@
+---
+galaxy_info:
+  name: missing_deps
+  namespace: acme
+  description: foo
+  license: GPL
+  min_ansible_version: "2.10"
+  platforms: []

test/roles/acme.missing_deps/requirements.yml

@@ -0,0 +1,2 @@
+collections:
+  - foo.bar # collection that does not exist, so we can test offline mode

test/test_runtime.py

@@ -619,6 +619,13 @@ def test_install_collection_from_disk_fail() -> None:
             runtime.prepare_environment(install_local=True)
 
 
+def test_prepare_environment_offline_role() -> None:
+    """Ensure that we can make use of offline roles."""
+    with remember_cwd("test/roles/acme.missing_deps"):
+        runtime = Runtime(isolated=True)
+        runtime.prepare_environment(install_local=True, offline=True)
+
+
 def test_runtime_run(runtime: Runtime) -> None:
     """Check if tee and non tee mode return same kind of results."""
     result1 = runtime.exec(["seq", "10"])

tox.ini

@@ -52,7 +52,7 @@ setenv =
   PIP_DISABLE_PIP_VERSION_CHECK = 1
   PIP_CONSTRAINT = {toxinidir}/constraints.txt
   PRE_COMMIT_COLOR = always
-  PYTEST_REQPASS = 74
+  PYTEST_REQPASS = 75
   FORCE_COLOR = 1
 allowlist_externals =
   ansible