Lizard

A debugger targeting DosBox with a focus on reverse engineering

Attributions

This project has dependencies on:

• zeroc/ice for RPC between debugger UI and hosts, licensed under GPL v2.0 © ZeroC
• feliwir/SharpFileDialog for cross-platform 'open file' dialogs, licensed under MIT © Stephan Vedder
• csinkers/GhidraProgramData for reading Ghidra XML export data, licensed under MIT
• csinkers/ImGuiColorTextEditNet for code and text editors, licensed under MIT
• microsoft/vscode-codicons is used for toolbar icons and is licensed under CC BY 4.0 © Microsoft
• veldrid is used for access to graphics APIs, licensed under MIT © Eric Mellino and Veldrid contributors
• ImGUI.NET is used for the GUI, licensed under MIT © Eric Mellino and ImGui.NET contributors
• Tooll 3 for some ImGui controls, licensed under MIT © Thomas Mann, Daniel Szymanski, Andreas Rose, Framefield GmbH

Environment setup

Machine install:

Install csharpier VS 2022 plugin

Run pip install pre-commit

Project Install:

dotnet tool install csharpier

Create .csharpierrc:

{
    "printWidth": 120,
    "useTabs": false,
    "tabWidth": 4,
    "endOfLine": "auto"
}

Create .pre-commit-config.yaml:

repos:
  - repo: local
    hooks:
      - id: dotnet-tool-restore
        name: Install .NET tools
        entry: dotnet tool restore
        language: system
        always_run: true
        pass_filenames: false
        stages:
          - commit
          - push
          - post-checkout
          - post-rewrite
        description: Install the .NET tools listed at .config/dotnet-tools.json.
      - id: csharpier
        name: Run CSharpier on C# files
        entry: dotnet tool run dotnet-csharpier
        language: system
        types:
          - c#
        description: CSharpier is an opinionated C# formatter inspired by Prettier.

Run pre-commit install Test against all files: pre-commit run --all-files