Add the --no-docker parameter, to use system tools instead

Author: rodrigomelo9

README.md

@@ -12,8 +12,8 @@ It relies on [Docker](https://docs.docker.com/get-docker) and [PyFPGA containers
 # Documentation
 
 ```
-usage: vhdl2vhdl [-h] [-v] [-g GENERIC VALUE] [-a ARCH] [-f FILENAME]
-                 [-o PATH] -t TOPNAME
+usage: vhdl2vhdl [-h] [-v] [--no-docker] [-g GENERIC VALUE] [-a ARCH]
+                 [-f FILENAME] [-o PATH] -t TOPNAME
                  FILE[,LIBRARY] [FILE[,LIBRARY] ...]
 
 VHDL to VHDL
@@ -24,6 +24,7 @@ positional arguments:
 optional arguments:
   -h, --help            show this help message and exit
   -v, --version         show program's version number and exit
+  --no-docker           do not use Docker (use system tools instead)
   -g GENERIC VALUE, --generic GENERIC VALUE
                         specify a top-level Generic (can be specified multiple
                         times)
@@ -36,8 +37,8 @@ optional arguments:
 ```
 
 ```
-usage: vhdl2vlog [-h] [-v] [--backend TOOL] [-g GENERIC VALUE] [-a ARCH]
-                 [-f FILENAME] [-o PATH] -t TOPNAME
+usage: vhdl2vlog [-h] [-v] [--no-docker] [--backend TOOL] [-g GENERIC VALUE]
+                 [-a ARCH] [-f FILENAME] [-o PATH] -t TOPNAME
                  FILE[,LIBRARY] [FILE[,LIBRARY] ...]
 
 VHDL to Verilog
@@ -48,6 +49,7 @@ positional arguments:
 optional arguments:
   -h, --help            show this help message and exit
   -v, --version         show program's version number and exit
+  --no-docker           do not use Docker (use system tools instead)
   --backend TOOL        backend tool [ghdl]
   -g GENERIC VALUE, --generic GENERIC VALUE
                         specify a top-level Generic (can be specified multiple
@@ -61,7 +63,7 @@ optional arguments:
 ```
 
 ```
-usage: slog2vlog [-h] [-v] [--frontend TOOL] [-p PARAM VALUE]
+usage: slog2vlog [-h] [-v] [--no-docker] [--frontend TOOL] [-p PARAM VALUE]
                  [-d DEFINE VALUE] [-i PATH] [-f FILENAME] [-o PATH] -t
                  TOPNAME
                  FILE [FILE ...]
@@ -74,6 +76,7 @@ positional arguments:
 optional arguments:
   -h, --help            show this help message and exit
   -v, --version         show program's version number and exit
+  --no-docker           do not use Docker (use system tools instead)
   --frontend TOOL       frontend tool [slang]
   -p PARAM VALUE, --param PARAM VALUE
                         specify a top-level Parameter (can be specified

hdlconv/core.py

@@ -55,6 +55,11 @@ def get_args(src, dst):
         action='version',
         version=f'HDLconv {prog} - v{version}'
     )
+    parser.add_argument(
+        '--no-docker',
+        action='store_true',
+        help='do not use Docker (use system tools instead)'
+    )
     if src == 'slog':
         parser.add_argument(
             '--frontend',
@@ -174,6 +179,7 @@ def get_data(src, dst, args):
             data.setdefault('files', []).append(file)
         data.setdefault('volumes', set()).add(Path('/') / file.parts[1])
     data['volumes'] = list(data['volumes'])
+    data['docker'] = not args.no_docker
     return data
 
 
@@ -230,8 +236,9 @@ def run_tool(content, odir, filename):
 
 def hdlconv(src, dst):
     """HDL conversion entry-point"""
-    check_docker()
     args = get_args(src, dst)
+    if not args.no_docker:
+        check_docker()
     if args.filename is None:
         args.filename = args.top.lower()
         args.filename += '.vhdl' if dst == 'vhdl' else '.v'

hdlconv/templates/docker.jinja

@@ -1,2 +1,4 @@
+{% if docker %}
 CONTAINER="ghcr.io/pyfpga/synthesis"
 DOCKER="docker run --rm{% for volume in volumes %} -v {{ volume }}:{{ volume }}{% endfor %} -w $PWD --user $(id -u):$(id -g) $CONTAINER"
+{% endif %}