Commit 1098347fa5efc757aafc22513f1af67fba759d18 - SixtyPical

+3

-0

HISTORY.md less more

7	7	approximates the set of routines which are not called
8	8	by any other routine, with an eye to omitting them from
9	9	the final executable.
	10	* A routine can be declared `preserved`, which prevents a
	11	compiler from omitting it from the final executable, even
	12	if it determines it is not called by any other routine.
10	13	* The `dcc6502-adapter` test adapter was updated to conform
11	14	to the output of the latest version of `dcc6502`.
12	15

+2

-2

src/sixtypical/callgraph.py less more

32	32	potential_calls = node['potentially-calls']
33	33	if routine.name in potential_calls:
34	34	potentially_called_by.append(name)
35		if getattr(routine, 'explicitly_marked_as_called', None) or routine.name == 'main':
36		potentially_called_by.append('marked')
	35	if getattr(routine, 'preserved', None) or routine.name == 'main':
	36	potentially_called_by.append('preserved')
37	37	graph[routine.name]['potentially-called-by'] = potentially_called_by
38	38
39	39	return graph

+4

-0

src/sixtypical/parser.py less more

110	110	name = self.scanner.token
111	111	self.scanner.scan()
112	112	self.current_routine_name = name
	113	preserved = False
	114	if self.scanner.consume('preserved'):
	115	preserved = True
113	116	type_, routine = self.routine(name)
114	117	self.declare(name, routine, type_)
	118	routine.preserved = preserved
115	119	routines.append(routine)
116	120	self.current_routine_name = None
117	121	self.scanner.check_type('EOF')

+34

-5

tests/SixtyPical Callgraph.md less more

11	11
12	12	The `main` routine is always called. The thing that it will
13	13	be called by is the system, but the callgraph analyzer will
14		simply consider it to be "marked as called".
	14	simply consider it to be "marked as preserved".
15	15
16	16	\| define main routine
17	17	\| {

19	19	= {
20	20	= "main": {
21	21	= "potentially-called-by": [
22		= "marked"
	22	= "preserved"
23	23	= ],
24	24	= "potentially-calls": []
25	25	= }

38	38	= {
39	39	= "main": {
40	40	= "potentially-called-by": [
41		= "marked"
	41	= "preserved"
42	42	= ],
43	43	= "potentially-calls": [
44	44	= "other"

67	67	= {
68	68	= "main": {
69	69	= "potentially-called-by": [
70		= "marked"
	70	= "preserved"
71	71	= ],
72	72	= "potentially-calls": []
73	73	= },
74	74	= "other": {
75	75	= "potentially-called-by": [],
	76	= "potentially-calls": []
	77	= }
	78	= }
	79
	80	If a routine is not called by another routine, but it is declared
	81	explicitly as `preserved`, then it will not be considered unused,
	82	and a compiler or linker will not be permitted to omit it from
	83	the final executable. This is useful for interrupt routines and
	84	such that really are used by some part of the system, even if not
	85	directly by another SixtyPical routine.
	86
	87	\| define main routine
	88	\| {
	89	\| }
	90	\|
	91	\| define other preserved routine
	92	\| {
	93	\| }
	94	= {
	95	= "main": {
	96	= "potentially-called-by": [
	97	= "preserved"
	98	= ],
	99	= "potentially-calls": []
	100	= },
	101	= "other": {
	102	= "potentially-called-by": [
	103	= "preserved"
	104	= ],
76	105	= "potentially-calls": []
77	106	= }
78	107	= }

97	126	= {
98	127	= "main": {
99	128	= "potentially-called-by": [
100		= "marked"
	129	= "preserved"
101	130	= ],
102	131	= "potentially-calls": []
103	132	= },

+12

-0

tests/SixtyPical Syntax.md less more

70	70	\| outputs a
71	71	\| trashes x
72	72	\| @ 65487
	73	= ok
	74
	75	Preserved routine.
	76
	77	\| define main routine {
	78	\| ld a, $ff
	79	\| add a, $01
	80	\| }
	81	\| define foo preserved routine {
	82	\| ld a, 0
	83	\| add a, 1
	84	\| }
73	85	= ok
74	86
75	87	Trash.