Add breakpoint support for MacOS by f1ammable · Pull Request #3 · f1ammable/caesar

f1ammable · 2026-02-22T16:10:23Z

Add breakpoint support via Mach exceptions

Implements breakpoints on arm64 macOS using Mach exception handling. You can now set, disable, toggle breakpoints and resume execution after hitting them.

Also includes:

Process launch with proper exception port setup
Exit code and signal reporting
Better test coverage for the interpreter
Various refactors to clean up the codebase

use `oldState` and `newState` to set thread state instead of `thread_set_state`

github-actions · 2026-02-23T02:15:31Z

Code Coverage Report

### Per-File Coverage Summary
Filename                      Regions    Missed Regions     Cover   Functions  Missed Functions  Executed       Lines      Missed Lines     Cover    Branches   Missed Branches     Cover
-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
cmd/callable.hpp                    1                 0   100.00%           1                 0   100.00%           1                 0   100.00%           0                 0         -
cmd/environment.cpp                19                 0   100.00%           5                 0   100.00%          40                 0   100.00%          10                 0   100.00%
cmd/environment.hpp                 2                 0   100.00%           1                 0   100.00%           7                 0   100.00%           0                 0         -
cmd/expr.hpp                       38                 3    92.11%          25                 3    88.00%          64                 7    89.06%           2                 0   100.00%
cmd/interpreter.cpp                55                 2    96.36%          18                 0   100.00%         147                 5    96.60%          46                 3    93.48%
cmd/object.hpp                     25                 1    96.00%          17                 1    94.12%         118                 2    98.31%           2                 0   100.00%
cmd/parser.cpp                    102                 2    98.04%          21                 0   100.00%         143                 0   100.00%          62                 6    90.32%
cmd/parser.hpp                     19                 0   100.00%           1                 0   100.00%           3                 0   100.00%          16                 0   100.00%
cmd/scanner.cpp                    80                 0   100.00%          12                 0   100.00%         120                 0   100.00%          68                 2    97.06%
cmd/scanner.hpp                     1                 0   100.00%           1                 0   100.00%           4                 0   100.00%           0                 0         -
cmd/stdlib.hpp                     85                65    23.53%          23                 9    60.87%         162               110    32.10%          42                38     9.52%
cmd/stmnt.hpp                      13                 1    92.31%           8                 1    87.50%          14                 1    92.86%           0                 0         -
cmd/subcommand.hpp                  7                 0   100.00%           2                 0   100.00%          10                 0   100.00%           2                 0   100.00%
cmd/token.hpp                       4                 0   100.00%           1                 0   100.00%           3                 0   100.00%           0                 0         -
cmd/util.cpp                       26                16    38.46%           3                 2    33.33%          39                24    38.46%          24                20    16.67%
core/context.hpp                    3                 2    33.33%           3                 2    33.33%           6                 5    16.67%           0                 0         -
core/target.cpp                    11                11     0.00%           4                 4     0.00%          30                30     0.00%           6                 6     0.00%
core/target.hpp                     4                 4     0.00%           4                 4     0.00%           4                 4     0.00%           0                 0         -
core/util.hpp                       8                 8     0.00%           5                 5     0.00%          27                27     0.00%           0                 0         -
error.cpp                           6                 0   100.00%           6                 0   100.00%          24                 0   100.00%           0                 0         -
error.hpp                           8                 0   100.00%           2                 0   100.00%          21                 0   100.00%           0                 0         -
expected.hpp                       11                11     0.00%           8                 8     0.00%          10                10     0.00%           0                 0         -
formatter.hpp                      58                 0   100.00%           9                 0   100.00%          99                 2    97.98%           2                 0   100.00%
-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
TOTAL                             586               126    78.50%         180                39    78.33%        1096               227    79.29%         282                75    73.40%

Detailed HTML report available in artifacts.

github-actions · 2026-02-23T02:24:59Z

Code Coverage Report

### Per-File Coverage Summary
Filename                      Regions    Missed Regions     Cover   Functions  Missed Functions  Executed       Lines      Missed Lines     Cover    Branches   Missed Branches     Cover
-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
cmd/callable.hpp                    1                 0   100.00%           1                 0   100.00%           1                 0   100.00%           0                 0         -
cmd/environment.cpp                19                 0   100.00%           5                 0   100.00%          41                 0   100.00%          10                 0   100.00%
cmd/environment.hpp                 2                 0   100.00%           1                 0   100.00%           7                 0   100.00%           0                 0         -
cmd/expr.hpp                       38                 3    92.11%          25                 3    88.00%          64                 7    89.06%           2                 0   100.00%
cmd/interpreter.cpp                55                 2    96.36%          18                 0   100.00%         147                 5    96.60%          46                 3    93.48%
cmd/object.hpp                     25                 1    96.00%          17                 1    94.12%         120                 2    98.33%           2                 0   100.00%
cmd/parser.cpp                    102                 2    98.04%          21                 0   100.00%         144                 0   100.00%          62                 6    90.32%
cmd/parser.hpp                     19                 0   100.00%           1                 0   100.00%           3                 0   100.00%          16                 0   100.00%
cmd/scanner.cpp                    80                 0   100.00%          12                 0   100.00%         120                 0   100.00%          68                 2    97.06%
cmd/scanner.hpp                     1                 0   100.00%           1                 0   100.00%           4                 0   100.00%           0                 0         -
cmd/stdlib.hpp                     85                65    23.53%          23                 9    60.87%         162               110    32.10%          42                38     9.52%
cmd/stmnt.hpp                      13                 1    92.31%           8                 1    87.50%          14                 1    92.86%           0                 0         -
cmd/subcommand.hpp                  7                 0   100.00%           2                 0   100.00%          10                 0   100.00%           2                 0   100.00%
cmd/token.hpp                       4                 0   100.00%           1                 0   100.00%           3                 0   100.00%           0                 0         -
cmd/util.cpp                       26                16    38.46%           3                 2    33.33%          39                24    38.46%          24                20    16.67%
core/context.hpp                    3                 2    33.33%           3                 2    33.33%           8                 7    12.50%           0                 0         -
core/target.cpp                    11                11     0.00%           4                 4     0.00%          30                30     0.00%           6                 6     0.00%
core/target.hpp                     4                 4     0.00%           4                 4     0.00%           4                 4     0.00%           0                 0         -
core/util.hpp                       8                 8     0.00%           5                 5     0.00%          27                27     0.00%           0                 0         -
error.cpp                           6                 0   100.00%           6                 0   100.00%          24                 0   100.00%           0                 0         -
error.hpp                           8                 0   100.00%           2                 0   100.00%          21                 0   100.00%           0                 0         -
expected.hpp                       11                11     0.00%           8                 8     0.00%          10                10     0.00%           0                 0         -
formatter.hpp                      58                 0   100.00%           9                 0   100.00%          99                 2    97.98%           2                 0   100.00%
-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
TOTAL                             586               126    78.50%         180                39    78.33%        1102               229    79.22%         282                75    73.40%

Detailed HTML report available in artifacts.

f1ammable · 2026-02-23T02:28:55Z

I'm not going to diagnose clang version mismatches giving different clang-format output, on brew llvm 21.1.8 all formatting checks pass

f1ammable added 30 commits January 11, 2026 18:50

force brew llvm on osx

04fbc31

add example subcommand

a43e714

check binary type against current platform (WIP)

328a159

update core and cmd libs to be in include path

649b1af

start target and wait for it to finish

303b8b7

split Error into component-specific error type

3c1b0aa

refactor Target

299a1a7

move Macho into own library

affb947

build: enforce stricter brew llvm checks

cabd816

feat: trace process via mach exceptions

9c3fde7

chore: update vcpkg

c0dcce5

refactor(core/macho): remove global variable usage

c51a53a

refactor(macho): handle unix signals refiring

be7e211

use `oldState` and `newState` to set thread state instead of `thread_set_state`

feat(macho): show exception reason and unix signal

4c8a799

feat(macho): implement resume command

d76b7c7

feat(macho): start process suspended

abedf4e

feat(macho): show exit code when target exits

807d874

style: allow non-private members in classes

2fbb1e2

feat(macho): arm64 set breakpoints

6ee7f9f

feat(macho): resume execution after breakpoints

caab317

build: link core library for tests

2fa48d0

test(cmd): don't treat variables as function calls

2adf8bd

style: exclude mig-generated headers

261abff

fix(cmd): return early in checkNumberOperand

baebb3b

test(cmd): improve test coverage for interpreter

d3c4ea0

test(cmd): add tests for Expr and lint file

69be254

test(cmd): add tests for subcommands

e73aa67

test(cmd): add tests for built-in functions

3e5b7ab

feat(core/cmd): disable and toggle breakpoints

4a39780

fix(core/macho): use map reference instead of copy

45ec152

f1ammable added 12 commits February 19, 2026 23:04

refactor(core/macho): make m_target static

33423ef

refactor(cmd/mach): consolidate removing and toggling breakpoints

3c6b24c

refactor(core): use Expected for casting address

e314c7c

perf: re-arrange member variables to reduce padding

241036b

fix(mach): decode exit status

88856ad

fix(core/mach): use typedefs + wait for event loop to finish

e76ac6a

docs: update readme

72aed90

fix: remove unused includes and files

b73360f

fix: include mach headers only if on osx

fff94fc

fix: remove even more apple includes

162bdee

fix: add header guards for osx includes

2464bb8

fix: add format include

41f6cf4

style: run formatter

42ee492

f1ammable merged commit e4f9a0a into main Feb 23, 2026
2 of 3 checks passed

f1ammable deleted the feature/breakpoints branch February 23, 2026 02:29

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add breakpoint support for MacOS#3

Add breakpoint support for MacOS#3
f1ammable merged 43 commits intomainfrom
feature/breakpoints

f1ammable commented Feb 22, 2026

Uh oh!

github-actions bot commented Feb 23, 2026

Uh oh!

github-actions bot commented Feb 23, 2026

Uh oh!

f1ammable commented Feb 23, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

f1ammable commented Feb 22, 2026

Uh oh!

github-actions bot commented Feb 23, 2026

Code Coverage Report

Uh oh!

github-actions bot commented Feb 23, 2026

Code Coverage Report

Uh oh!

f1ammable commented Feb 23, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant