From a8b5c79326d3df736708a52e5053469f0f8beb95 Mon Sep 17 00:00:00 2001
From: Paul Barker <pbarker@konsulko.com>
Date: Fri, 13 Nov 2020 19:34:54 +0100
Subject: [PATCH] checkout: New plugin

This plugin checks out all necessary repositories and sets up the build
directory as specificed in the configuration file.

Signed-off-by: Paul Barker <pbarker@konsulko.com>
Signed-off-by: Jan Kiszka <jan.kiszka@siemens.com>
---
 docs/userguide.rst      |  5 ++++
 kas/plugins/__init__.py |  2 ++
 kas/plugins/checkout.py | 63 +++++++++++++++++++++++++++++++++++++++++
 3 files changed, 70 insertions(+)
 create mode 100644 kas/plugins/checkout.py

diff --git a/docs/userguide.rst b/docs/userguide.rst
index 12a0efa..b7182be 100644
--- a/docs/userguide.rst
+++ b/docs/userguide.rst
@@ -76,6 +76,11 @@ typically provides a single command.
 
 .. automodule:: kas.plugins.build
 
+``checkout`` plugin
+~~~~~~~~~~~~~~~~~~~
+
+.. automodule:: kas.plugins.checkout
+
 ``forallrepos`` plugin
 ~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/kas/plugins/__init__.py b/kas/plugins/__init__.py
index 587d0b4..343c2a8 100644
--- a/kas/plugins/__init__.py
+++ b/kas/plugins/__init__.py
@@ -40,9 +40,11 @@ def load():
     """
     from . import build
     from . import forallrepos
+    from . import checkout
     from . import shell
 
     register_plugins(build)
+    register_plugins(checkout)
     register_plugins(forallrepos)
     register_plugins(shell)
 
diff --git a/kas/plugins/checkout.py b/kas/plugins/checkout.py
new file mode 100644
index 0000000..98eb636
--- /dev/null
+++ b/kas/plugins/checkout.py
@@ -0,0 +1,63 @@
+# kas - setup tool for bitbake based projects
+#
+# Copyright (c) Konsulko Group, 2020
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+"""
+    This plugin implements the ``kas checkout`` command.
+
+    When this command is executed, kas will checkout repositories and set up
+    the build directory as specified in the chosen config file. This command
+    is useful if you need to inspect the configuration or modify any of the
+    checked out layers before starting a build.
+
+    For example, to setup the configuration described in the file
+    ``kas-project.yml`` you could run::
+
+        kas checkout kas-project.yml
+"""
+
+from kas.context import create_global_context
+from kas.config import Config
+from kas.libcmds import Macro
+
+__license__ = 'MIT'
+__copyright__ = 'Copyright (c) Siemens AG, 2017-2018'
+
+
+class Checkout:
+    name = 'checkout'
+    helpmsg = (
+        'Checks out all necessary repositories and sets up the build '
+        'directory as specified in the configuration file.'
+    )
+
+    @classmethod
+    def setup_parser(cls, parser):
+        pass
+
+    def run(self, args):
+        ctx = create_global_context(args)
+        ctx.config = Config(args.config)
+
+        macro = Macro()
+        macro.run(ctx, args.skip)
+
+
+__KAS_PLUGINS__ = [Checkout]