MC6809 0.7.3

MC6809 CPU仿真器，用Python编写

MC6809是一个开源（GPL v3或更高版本）的6809 CPU仿真器，用于1980年代构建的老式家用电脑Dragon 32/64和Tandy TRS-80 Color Computer (CoCo)...

在Python 3.8、3.9、3.10和PyPy3上进行了测试

示例用法可以在： MC6809/example6809.py 中找到

入门

~$ git clone https://github.com/6809/MC6809.git
~$ cd MC6809
~/MC6809 $ ./cli.py --help

./cli.py --help的输出如下

Usage: ./cli.py [OPTIONS] COMMAND [ARGS]...

╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮
│ --help      Show this message and exit.                                                          │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────╮
│ benchmark                 Run a MC6809 emulation benchmark                                       │
│ example                   Just run the MC6809/example6809.py example (CRC32 calculation)         │
│ profile                   Profile the MC6809 emulation benchmark                                 │
│ update-readme-history     Update project history base on git commits/tags in README.md           │
│ version                   Print version and exit                                                 │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯

有一个简单的基准测试。例如运行

~/MC6809$ ./cli.py benchmark --help

./cli.py benchmark --help的输出如下

Usage: ./cli.py benchmark [OPTIONS]

 Run a MC6809 emulation benchmark

╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮
│ --loops       INTEGER  How many benchmark loops should be run? [default: 6]                      │
│ --multiply    INTEGER  est data multiplier [default: 15]                                         │
│ --help                 Show this message and exit.                                               │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯

profile

您可以对基准测试运行Python分析器，例如

~/MC6809$ ./cli.py profile --help

./cli.py profile --help的输出如下

Usage: ./cli.py profile [OPTIONS]

 Profile the MC6809 emulation benchmark

╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮
│ --loops       INTEGER  How many benchmark loops should be run? [default: 6]                      │
│ --multiply    INTEGER  est data multiplier [default: 15]                                         │
│ --help                 Show this message and exit.                                               │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯

development

开发存在dev-cli，例如

~/MC6809$ ./dev-cli.py --help

./dev-cli.py --help的输出如下

Usage: ./dev-cli.py [OPTIONS] COMMAND [ARGS]...

╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮
│ --help      Show this message and exit.                                                          │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────╮
│ check-code-style            Check code style by calling darker + flake8                          │
│ coverage                    Run tests and show coverage report.                                  │
│ fix-code-style              Fix code style of all cli_base source code files via darker          │
│ install                     Run pip-sync and install 'cli_base' via pip as editable.             │
│ mypy                        Run Mypy (configured in pyproject.toml)                              │
│ pip-audit                   Run pip-audit check against current requirements files               │
│ publish                     Build and upload this project to PyPi                                │
│ test                        Run unittests                                                        │
│ tox                         Run tox                                                              │
│ update                      Update "requirements*.txt" dependencies files                        │
│ update-test-snapshot-files  Update all test snapshot files (by remove and recreate all snapshot  │
│                             files)                                                               │
│ version                     Print version and exit                                               │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯

运行测试，例如

~/DragonPy$ ./dev-cli.py coverage
# or just:
~/DragonPy$ ./dev-cli.py test
# or with different Python versions:
~/DragonPy$ ./dev-cli.py tox

TODO

• 更新 'cpu6809_html_debug.py'
• 使用bottle用于http控制服务器部分
• 未实现的操作
  • RESET
  • SWI / SWI2 / SWI3
  • SYNC

发布新版本

我们使用cli-base-utilities来生成此README中的历史记录。

要发布新版本，请执行以下操作

• 增加您项目版本号
• 运行测试以更新README
• 提交更改
• 创建发布

历史记录

（其中一些点与DragonPy Emulator相关）

• v0.7.3
  • 2024-09-24 - 修复"publish"命令的bug
  • 2024-09-24 - 向应用CLI添加"example"命令
  • 2024-09-24 - + pre-commit钩子
  • 2024-09-24 - 根据manageprojects更新拆分CLI
  • 2024-09-24 - 更新需求
  • 2023-11-29 - 更新需求 + 修复代码风格 + manageprojects更新
• v0.7.2
  • 2023-11-03 - 自动生成README历史记录
  • 2023-11-03 - 修复代码风格
  • 2023-11-03 - 应用 manageprojects 更新 + 更新需求
  • 2023-11-03 - 使用 cli_base 中的 verbose_check_call
  • 2023-11-02 - 将 pip 从 23.2.1 升级到 23.3
• v0.7.1
  • 2023-08-05 - 修复 publish 调用
  • 2023-08-05 - 通过 apply manageprojects update 分离 CLI
  • 2023-08-04 - 更新需求
• v0.7.0
  • 2023-03-07 - 将 "benchmark" 和 "profile" 添加到 CLI，并移除 dev-shell，添加 DocTests
  • 2023-03-07 - 应用 managedprojects 更新：通过 bx_py_utils 辅助函数添加 DocTests
  • 2023-03-06 - 更新 README.md
  • 2023-03-06 - 迁移到 https://github.com/jedie/cookiecutter_templates
  • 2022-09-04 - 停用 pypy3
  • 2022-09-04 - 修复 Windows 下的测试
  • 2022-09-04 - 修复代码风格
  • 2022-09-04 - 用 "dev-shell" 替换 Makefile
  • 2022-09-04 - 更新 Makefile
  • 2022-09-04 - 更新 README
  • 2022-09-04 - 小型代码更新
  • 2022-09-04 - 删除 travis 配置
  • 2022-09-04 - flynt 更新
  • 2022-09-04 - 修复 flynt 调用
  • 2022-09-04 - 用 markdown 替换 Creole README
  • 2022-09-04 - 修复 pytest 配置
  • 2022-09-04 - 更新 github CI
  • 2022-09-04 - 添加 "make update"
  • 2022-09-04 - 修复 editorconfig

捐赠

• Flattr This!
• 向 Bitcoins 发送 1823RZ5Md1Q2X5aSXRC5LRPcYdveCiVX6F