openflow: add configure.py

It allows configuring the OCI engine, containers and tool names.

Author: rodrigomelo9

openflow/__init__.py

@@ -3,3 +3,4 @@
 __version__ = '0.1.0'
 
 from openflow.openflow import Openflow
+from openflow.configure import ConfigureTools

openflow/configure.py

@@ -0,0 +1,95 @@
+#
+# Copyright (C) 2020-2021 Rodrigo A. Melo
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+
+"""openflow.configure
+
+A Class to configure the OCI engine, the containers and the name of the
+underlying FOSS tools.
+"""
+
+
+# import os
+# from yaml import safe_load
+
+
+_DEFAULTS = {
+    'ecppack': 'hdlc/prjtrellis',
+    'ghdl': 'hdlc/ghdl:yosys',
+    'icepack': 'hdlc/icestorm',
+    'iceprog': 'hdlc/icestorm',
+    'icetime': 'hdlc/icestorm',
+    'nextpnr-ecp5': 'hdlc/nextpnr:ecp5',
+    'nextpnr-ice40': 'hdlc/nextpnr:ice40',
+    'openocd': 'hdlc/prog',
+    'yosys': 'hdlc/ghdl:yosys',
+}
+
+
+class ConfigureTools:
+    """Configure Tools."""
+
+    def __init__(self):
+        """Class constructor."""
+        self.configs = {}
+        self.configs['engine'] = 'docker'
+        self.configs['volumes'] = ['$HOME:$HOME']
+        self.configs['work'] = '$PWD'
+        self.configs['containers'] = {}
+        self.configs['names'] = {}
+        for key, value in _DEFAULTS.items():
+            self.configs['containers'][key] = value
+            self.configs['names'][key] = key
+
+    def get_command(self, tool):
+        """Get the command-line needed to run a tool."""
+        oci = ''
+        container = ''
+        command = self.configs['names'][tool]
+        if self.configs['engine'] in ['docker', 'podman']:
+            oci = '{} run --rm {} {}'.format(
+                self.configs['engine'],
+                '-v ' + ('-v ').join(self.configs['volumes']),
+                '-w ' + self.configs['work']
+            )
+            container = self.configs['containers'][tool]
+        return '{} {} {}'.format(oci, container, command)
+
+    def get_tools(self):
+        """Returns the list of configured tools."""
+        return sorted(list(self.configs['names'].keys()))
+
+    def set_engine(self, engine, volumes, work):
+        """Set the OCI engine."""
+        self.configs['engine'] = engine
+        self.configs['volumes'] = volumes
+        self.configs['work'] = work
+
+    def set_container(self, tool, container):
+        """Set the container of the specified tool."""
+        self.configs['containers'][tool] = container
+
+    def set_name(self, tool, name):
+        """Set the name of the specified tool."""
+        self.configs['names'][tool] = name
+
+    def set_configs_from_dict(self, configs):
+        """Set all the configurations from a dict."""
+        raise NotImplementedError('set_configs_from_dict')
+
+    def set_configs_from_yaml(self, filename):
+        """Set all the configurations from a YAML file."""
+        raise NotImplementedError('set_configs_from_yaml')