Rework PyBeeb into a reusable system, with host interfaces

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,29 @@
+---
+name: Bug report
+about: Something that's not right about the project
+title: ''
+labels: bug
+assignees: ''
+
+---
+
+## Problem statement
+
+<!-- Explain what you think is wrong -->
+
+
+## Environment
+
+<!-- Give details about the environment in which you are running, for
+     example, the OS version, hardware, devices or applications that
+     are related to the issue -->
+
+
+## Expected result
+
+<!-- Explain what you expect to happen -->
+
+
+## Reproduction steps
+
+<!-- Explain how to reproduce, or which test the failure is in -->

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,30 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: enhancement
+assignees: ''
+
+---
+
+## Is your feature request related to a problem?
+
+<!-- Give a clear description of what you're trying to address with
+     this request.
+     For example, "I'm always frustrated when [...]",
+     "It is hard to [...]"
+  -->
+
+## Describe the solution you'd like
+
+<!-- Give a clear description of how you the request might be
+     addressed. If you have ideas about how it could be implemented,
+     separate them from user interface changes.
+  -->
+
+## Additional context
+
+<!-- If you have some context, like places where this would have
+     helped, screenshots or mock ups of an interface, or the sort
+     of results you'd like to see, include them here.
+  -->

.github/pull_request_template.md

@@ -0,0 +1,17 @@
+# Changes
+
+<!-- Describe the changes you've made in this section.
+     Try to explain why they're needed and what they do.
+     Your reviewers will use this to decide whether the
+     change is sufficient and correct.
+     You can include pictures or diagrams in here
+     (see mermaid documentation on GitHub).
+ -->
+
+# Testing
+
+<!-- Describe the testing you have done manually to
+     satisfy yourself that the change works as intended.
+     If automated tests have been updated, state this.
+     Include output or pictures if necessary.
+ -->

.github/workflows/ci.yml

@@ -0,0 +1,35 @@
+---
+# Automatic testing
+#
+
+name: Tests
+
+# Controls when the action will run. Triggers the workflow on:
+#   * push on any branch.
+#   * tag creation for tags beginning with a 'v'
+#   * pull requests
+on:
+  push:
+    branches: ["*"]
+    tags: ["v*"]
+  pull_request:
+    types: [opened, reopened, synchronize]
+    branches: ["*"]
+
+jobs:
+  coverage:
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Prepare packages
+        run: |
+          sudo apt-get install -y python3 virtualenv
+          virtualenv -p python3 venv
+          source venv/bin/activate && \
+            pip install -r requirements.txt
+
+      - name: Run the coverage tests
+        run: |
+          source venv/bin/activate && \
+            timeout 180 make coverage

CODEOWNERS

@@ -0,0 +1,10 @@
+##
+# CODEOWNERS - define who is responsible for parts of the sources
+#
+# See:
+#   https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
+#   https://docs.gitlab.com/user/project/codeowners/reference/
+#
+
+# Default code owners - automatically assigned for reviews
+* @gerph

DisassembleTest.py

@@ -1,18 +1,21 @@
-'''
-Created on 12 Oct 2011
-
-@author: chris.whitworth
-'''
-
-import Disassembler
-import ROMs.TestData as TestData
-
-DecoderTablePath = "insts.csv"
-
-def main():
-    disassembler = Disassembler.Disassembler(DecoderTablePath)
-    disassembler.disassemble(TestData.testROM1)
-
-
-if __name__ == '__main__':
-    main()
+#!/usr/bin/env python
+'''
+Created on 12 Oct 2011
+
+@author: chris.whitworth
+'''
+
+import os
+
+import pybeeb.Disassembler
+import ROMs.TestData as TestData
+
+DecodeFilename = os.path.join(os.path.dirname(pybeeb.__file__), "insts.csv")
+
+def main():
+    disassembler = pybeeb.Disassembler.Disassembler(DecodeFilename)
+    disassembler.disassemble(TestData.testROM1)
+
+
+if __name__ == '__main__':
+    main()