make use of python entry_points

Makefile

@@ -4,7 +4,7 @@ clean:
 	rm -rf dist *.egg-info
 
 format:
-	find ./riocore/ ./tests/ ./bin/ -type f | grep ".py$$\|bin/" | xargs -r -l ruff format -q
+	find ./riocore/ ./tests/ -type f | grep ".py$$" | xargs -r -l ruff format -q
 
 check:
 	find ./riocore/ ./bin/ -type f | grep ".py$$\|bin/" | xargs -r -l ruff check
@@ -16,7 +16,7 @@ verilator:
 	find ./riocore/ -type f | grep ".v$$" | xargs -r -l verilator --lint-only
 
 readmes:
-	PYTHONPATH=. bin/rio-plugininfo -g
+	PYTHONPATH=. python3 -m rio-plugininfo -g
 	PYTHONPATH=. riocore/files/update_boards_and_toolchains_readme.py
 
 dist:
@@ -30,7 +30,14 @@ pypi: clean dist
 
 pyvenv: clean dist
 	python3 -m venv pyvenv
-	pyvenv/bin/python -m pip install -r requirements.txt
-	pyvenv/bin/python -m pip install dist/riocore*
-	pyvenv/bin/python bin/rio-generator Altera10M08Eval/config-test.json
+	.  pyvenv/bin/activate; \
+	pip install -r requirements.txt; \
+	pip install dist/riocore*;\
+	rio-generator Altera10M08Eval/config.json
 
+devvenv: clean dist
+	python3 -m venv pyvenv
+	.  pyvenv/bin/activate; \
+	pip install -r requirements.txt; \
+	pip install -e .; \
+	rio-generator Altera10M08Eval/config.json

riocore/apps/rio_generator.py

@@ -0,0 +1,70 @@
+#!/usr/bin/env python3
+#
+#
+
+import argparse
+import os
+
+import riocore
+
+riocore_path = os.path.dirname(riocore.__file__)
+
+def main():
+    parser = argparse.ArgumentParser()
+    parser.add_argument("config", help="json config file", nargs="?", type=str, default=None)
+    parser.add_argument("output", help="output directory", nargs="?", type=str, default=None)
+    parser.add_argument("--preview", "-p", help="generate preview / no pll config", default=False, action="store_true")
+    parser.add_argument("--build", "-b", help="build gateware", default=False, action="store_true")
+    parser.add_argument("--flash", "-f", help="flash gateware", default=False, action="store_true")
+    args = parser.parse_args()
+
+    if args.config:
+        if args.config.endswith(".json"):
+            if os.path.isfile(args.config):
+                config_file = args.config
+            elif os.path.isfile(f"{riocore_path}/configs/{args.config}"):
+                config_file = f"{riocore_path}/configs/{args.config}"
+            else:
+                print(f"can not load: {args.config}")
+                exit(1)
+            print(f"loading: {config_file}")
+            project = riocore.Project(config_file, args.output)
+            project.generator(preview=args.preview)
+
+            config_name = project.config.get("name")
+
+            if args.build:
+                cmd = f"(cd Output/{config_name}/Gateware/ ; make clean all)"
+                print("")
+                print("running:")
+                print(f"  {cmd}")
+                print("")
+                os.system(cmd)
+            if args.flash:
+                cmd = f"(cd Output/{config_name}/Gateware/ ; make load)"
+                print("")
+                print("running:")
+                print(f"  {cmd}")
+                print("")
+                os.system(cmd)
+
+        elif args.config.startswith("testbench:"):
+            plugin = args.config.split(":")[-1]
+            plugins = riocore.Plugins()
+            plugin_instance = plugins.load_plugin(plugin, {"type": plugin}, {"speed": 1000000, "jdata": {"clock": {"speed": 1000000}}})
+            plugins.testbench_builder(plugin, plugin_instance)
+
+        elif args.config.startswith("plugininfo:"):
+            plugin = args.config.split(":")[-1]
+            plugins = riocore.Plugins()
+            print(plugins.info(plugin))
+
+        elif args.config.startswith("pluginlist"):
+            plugin = args.config.split(":")[-1]
+            plugins = riocore.Plugins()
+            for line in plugins.list():
+                print(line)
+
+
+if __name__ == '__main__':
+    main()

riocore/apps/rio_plugininfo.py

@@ -0,0 +1,103 @@
+#!/usr/bin/env python3
+#
+#
+
+import argparse
+import os
+
+import riocore
+
+riocore_path = os.path.dirname(riocore.__file__)
+
+
+def main():
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--list", "-l", help="list all plugins", default=False, action="store_true")
+    parser.add_argument("--generate", "-g", help="generate readme files for all plugins", default=False, action="store_true")
+    parser.add_argument("plugin", help="plugin", nargs="?", type=str, default=None)
+    args = parser.parse_args()
+
+    if args.list:
+        plugins = riocore.Plugins()
+        for plugin in plugins.list():
+            plugins.load_plugins({"plugins": [{"type": plugin["name"]}]})
+
+        print("Interfaces:")
+        print("")
+        for plugin_instance in plugins.plugin_instances:
+            if plugin_instance.TYPE == "interface":
+                print(f"  {plugin_instance.NAME:20s} {plugin_instance.INFO}")
+        print("")
+
+        print("Expansions:")
+        print("")
+        for plugin_instance in plugins.plugin_instances:
+            if plugin_instance.TYPE == "expansion":
+                print(f"  {plugin_instance.NAME:20s} {plugin_instance.INFO}")
+        print("")
+
+        print("Joints:")
+        print("")
+        for plugin_instance in plugins.plugin_instances:
+            if plugin_instance.TYPE == "joint":
+                print(f"  {plugin_instance.NAME:20s} {plugin_instance.INFO}")
+        print("")
+
+        print("IO:")
+        print("")
+        for plugin_instance in plugins.plugin_instances:
+            if plugin_instance.TYPE == "io":
+                print(f"  {plugin_instance.NAME:20s} {plugin_instance.INFO}")
+        print("")
+
+    elif args.generate:
+        plugins = riocore.Plugins()
+        for plugin in plugins.list():
+            filename = f"riocore/plugins/{plugin['name']}/README.md"
+            print(filename)
+            text = plugins.info(plugin["name"])
+            open(filename, "w").write(text)
+
+        filename = "PLUGINS.md"
+        print(filename)
+        text = []
+
+        text.append("# PLUGINS")
+        text.append("")
+        text.append("| Type | Name | Info | Image |")
+        text.append("| --- | :---: | --- | :---: |")
+
+        for title, ptype in {
+            "Interfaces": "interface",
+            "Joints": "joint",
+            "IO": "io",
+            "FrameIO": "frameio",
+            "Expansions": "expansion",
+        }.items():
+            # text.append(f"## {title}:")
+            # text.append("")
+
+            for plugin_instance in plugins.plugin_instances:
+                if plugin_instance.TYPE == ptype:
+                    image = ""
+                    plugin_path = f"{riocore_path}/plugins/{plugin_instance.NAME}"
+                    image_path = f"{plugin_path}/image.png"
+                    if os.path.isfile(image_path):
+                        image = f'<img src="riocore/plugins/{plugin_instance.NAME}/image.png" height="48">'
+
+                    text.append(f"| {title} | [{plugin_instance.NAME}](riocore/plugins/{plugin_instance.NAME}/README.md) | {plugin_instance.INFO} | {image} |")
+
+                    title = ""
+
+        text.append("")
+
+        open(filename, "w").write("\n".join(text))
+
+
+    elif args.plugin:
+        plugins = riocore.Plugins()
+        print(plugins.info(args.plugin))
+
+
+if __name__ == "__main__":
+    main()