ines-parser 1.2.0__tar.gz → 1.2.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: ines-parser
3
- Version: 1.2.0
3
+ Version: 1.2.1
4
4
  Summary: A Python library and utilities for parsing iNES format NES ROM files
5
5
  Author: Leonid Kabanov
6
6
  License-Expression: MIT
@@ -25,7 +25,7 @@ from .mappers import (
25
25
  is_known_mapper,
26
26
  )
27
27
 
28
- __version__ = "1.2.0"
28
+ __version__ = "1.2.1"
29
29
  __author__ = "Leonid Kabanov"
30
30
  __all__ = [
31
31
  "parse_ines_header",
@@ -0,0 +1,463 @@
1
+ """
2
+ Mapper information database
3
+
4
+ Provides lookup tables for mapper names and additional information.
5
+
6
+ Coverage follows MAME's ``nes_ines.hxx`` ``mmc_list`` (PCB identifiers and
7
+ comments from that file), merged with the curated names from the NESdev Wiki
8
+ summary table where those entries overlap. Many mapper numbers outside the
9
+ short wiki table only appear here via the MAME mapping.
10
+
11
+ NESdev list (short summary): https://www.nesdev.org/wiki/List_of_mappers
12
+ Category index: https://www.nesdev.org/wiki/Category:INES_Mappers
13
+ MAME source of mmc_list: https://github.com/mamedev/mame/blob/master/src/devices/bus/nes/nes_ines.hxx
14
+ """
15
+
16
+ from typing import Dict, List, Any
17
+
18
+ # Mapper database: mapper_number -> (primary_name, [alternate_names], notes)
19
+ MAPPER_DATABASE: Dict[int, tuple] = {
20
+ 0: ('NROM', [], ''),
21
+ 1: ('MMC1', ['SxROM'], ''),
22
+ 2: ('UxROM', [], ''),
23
+ 3: ('CNROM', [], ''),
24
+ 4: ('MMC3', ['TxROM', 'MMC6'], ''),
25
+ 5: ('MMC5', ['ExROM'], 'Contains expansion sound'),
26
+ 6: ('FFE4 Board', [], ''),
27
+ 7: ('AxROM', [], ''),
28
+ 8: ('FFE3 Board', [], ''),
29
+ 9: ('MMC2', ['PxROM'], ''),
30
+ 10: ('MMC4', ['FxROM'], ''),
31
+ 11: ('Color Dreams', [], ''),
32
+ 12: ('Rexsoft DBZ5', [], ''),
33
+ 13: ('CPROM', [], ''),
34
+ 14: ('Rexsoft SL1632', [], ''),
35
+ 15: ('100-in-1 Contra Function 16', [], 'Multicart'),
36
+ 16: ('Bandai EPROM (24C02)', [], ''),
37
+ 17: ('FFE8 Board', [], ''),
38
+ 18: ('Jaleco SS8806', [], ''),
39
+ 19: ('Namco 163', [], 'Contains expansion sound'),
40
+ 21: ('VRC4', ['VRC4a', 'VRC4c'], ''),
41
+ 22: ('VRC2', ['VRC2a'], ''),
42
+ 23: ('VRC2/VRC4', ['VRC2b', 'VRC4e'], ''),
43
+ 24: ('VRC6', ['VRC6a'], 'Contains expansion sound'),
44
+ 25: ('VRC4', ['VRC4b', 'VRC4d'], ''),
45
+ 26: ('VRC6', ['VRC6b'], 'Contains expansion sound'),
46
+ 27: ('Unlicensed CC21', [], 'Mihunche, but previously used for World Hero'),
47
+ 28: ('Unlicensed ACTION53', [], 'Multi-discrete PCB designed by Tepples for Action 53'),
48
+ 29: ('Sealie Cufrom', [], 'homebrew PCB used by Glider'),
49
+ 30: ('Sealie UNROM512', [], 'UNROM 512 + Flash'),
50
+ 31: ('Unlicensed 2A03PURITANS', [], 'PCB designed by infinitelives & rainwarrior for 2A03 Puritans Album'),
51
+ 32: ('Irem G101', [], ''),
52
+ 33: ('Taito TC0190FMC', [], ''),
53
+ 34: ('BNROM', ['NINA-001'], ''),
54
+ 35: ('Unlicensed SC127', [], ''),
55
+ 36: ('TXC Strikew', [], ''),
56
+ 37: ('PAL ZZ', [], ''),
57
+ 38: ('Discrete logic 74X161X138', [], ''),
58
+ 39: ('Unlicensed Studyngame', [], ''),
59
+ 40: ('Bootleg SMB2JA', [], ''),
60
+ 41: ('Caltron 6IN1', [], ''),
61
+ 42: ('Bootleg Mariobaby', [], 'ai senshi nicole too, changed by crc_hack'),
62
+ 43: ('Unlicensed SMB2J', [], ''),
63
+ 44: ('Multicart Superbig 7IN1', [], ''),
64
+ 45: ('Multicart HIK8IN1', [], ''),
65
+ 46: ('Rumblestation Board', [], ''),
66
+ 47: ('NES QJ', [], ''),
67
+ 48: ('Taito TC0190FMCP', [], ''),
68
+ 49: ('Multicart Superhik 4IN1', [], ''),
69
+ 50: ('Bootleg SMB2JB', [], ''),
70
+ 51: ('Multicart Ballgames 11IN1', [], ''),
71
+ 52: ('Multicart Gold 7IN1', [], ''),
72
+ 53: ('SVISION16 Board', [], ''),
73
+ 54: ('Multicart 21IN1', [], 'duplicate of mapper 201, though possibly should be "Unused"'),
74
+ 55: ('Unlicensed Mmalee', [], 'Genius SMB'),
75
+ 56: ('Kaiser KS202', [], ''),
76
+ 57: ('Multicart GKA', [], ''),
77
+ 58: ('Multicart GKB', [], ''),
78
+ 59: ('Multicart VT5201', [], 'and BMC-T3H53, BMC-D1038'),
79
+ 60: ('Multicart 4IN1RESET', [], ''),
80
+ 61: ('RCM TF9IN1', [], ''),
81
+ 62: ('Multicart Super 700IN1', [], ''),
82
+ 63: ('Multicart TH22913', [], 'Powerful 250/255'),
83
+ 64: ('RAMBO-1', [], 'MMC3 clone with extra features'),
84
+ 65: ('Irem H3001', [], ''),
85
+ 66: ('GxROM', ['MxROM'], ''),
86
+ 67: ('Sunsoft 3', [], ''),
87
+ 68: ('After Burner', [], 'ROM-based nametables'),
88
+ 69: ('Sunsoft FME-7', ['Sunsoft 5B'], 'The 5B is the FME-7 with expansion sound'),
89
+ 70: ('Discrete logic 74X161X161X32', [], ''),
90
+ 71: ('Camerica/Codemasters', [], 'Similar to UNROM'),
91
+ 72: ('Jaleco JF17', [], ''),
92
+ 73: ('VRC3', [], ''),
93
+ 74: ('Pirate MMC3 derivative', [], 'Has both CHR ROM and CHR RAM (2k)'),
94
+ 75: ('VRC1', [], ''),
95
+ 76: ('Namco 109 variant', [], ''),
96
+ 77: ('Irem LROG017', [], ''),
97
+ 78: ('Irem Holydivr', [], ''),
98
+ 79: ('NINA-03/NINA-06', [], "It's either 003 or 006, we don't know right now"),
99
+ 80: ('Taito X1 005', [], ''),
100
+ 81: ('Nanjing / NTDEC N715021', [], '81 Super Gun'),
101
+ 83: ('Cony Board', [], ''),
102
+ 85: ('VRC7', [], 'Contains expansion sound'),
103
+ 86: ('JALECO-JF-13', [], ''),
104
+ 87: ('Discrete logic 74X139X74', [], ''),
105
+ 88: ('Namcot 34X3', [], ''),
106
+ 89: ('Sunsoft 2', [], ''),
107
+ 90: ('Jycompany A', [], ''),
108
+ 91: ('Unlicensed JY830623C', [], ''),
109
+ 92: ('Jaleco JF19', [], ''),
110
+ 93: ('Sunsoft 2', [], ''),
111
+ 94: ('Senjou no Ookami', [], ''),
112
+ 95: ('Namcot 3425', [], ''),
113
+ 96: ('Bandai Oekakids', [], ''),
114
+ 97: ('Irem TAM S1', [], ''),
115
+ 103: ('Unlicensed 2708', [], '103 Bootleg cart 2708 (Doki Doki Panic - FDS Conversion)'),
116
+ 104: ('Camerica Goldenfive', [], ''),
117
+ 105: ('NES-EVENT', [], 'Similar to MMC1'),
118
+ 106: ('Bootleg SMB3', [], ''),
119
+ 107: ('Magicseries MD', [], ''),
120
+ 108: ('Unlicensed LH28 LH54', [], '108 has 4 variant boards'),
121
+ 112: ('Nanjing / NTDEC Asder', [], ''),
122
+ 113: ('HES NTD-8', [], 'For multicarts including mapper 79 games'),
123
+ 114: ('Supergame Lionking', [], ''),
124
+ 115: ('Kasing Board', [], ''),
125
+ 116: ('Somari SL12', [], ''),
126
+ 117: ('Futuremedia Board', [], ''),
127
+ 118: ('TxSROM', ['MMC3'], 'MMC3 with independent mirroring control'),
128
+ 119: ('TQROM', ['MMC3'], 'Has both CHR ROM and CHR RAM'),
129
+ 120: ('Bootleg Tobidase', [], ''),
130
+ 121: ('KAY Board', [], ''),
131
+ 123: ('Unlicensed H2288', [], ''),
132
+ 125: ('Unlicensed LH32', [], 'Monty no Doki Doki Daidassou - FDS Conversion'),
133
+ 126: ('Multicart PJOY84', [], ''),
134
+ 132: ('TXC 22211', [], ''),
135
+ 133: ('Sachen SA72008', [], ''),
136
+ 134: ('Multicart Family 4646', [], ''),
137
+ 136: ('Sachen TCU02', [], ''),
138
+ 137: ('Sachen 8259D', [], ''),
139
+ 138: ('Sachen 8259B', [], ''),
140
+ 139: ('Sachen 8259C', [], ''),
141
+ 140: ('Jaleco JF11', [], ''),
142
+ 141: ('Sachen 8259A', [], ''),
143
+ 142: ('Kaiser KS7032', [], ''),
144
+ 143: ('Sachen TCA01', [], ''),
145
+ 144: ('Agci 50282', [], ''),
146
+ 145: ('Sachen SA72007', [], ''),
147
+ 146: ('AVE NINA06', [], 'basically same as Mapper 79 (Nina006)'),
148
+ 147: ('Sachen TCU01', [], ''),
149
+ 148: ('Sachen SA0037', [], ''),
150
+ 149: ('Sachen SA0036', [], ''),
151
+ 150: ('Sachen 74LS374', [], ''),
152
+ 152: ('Discrete logic 74X161X161X32', [], ''),
153
+ 153: ('Bandai LZ93', [], ''),
154
+ 154: ('Namcot 34X3', [], ''),
155
+ 155: ('MMC1A', ['SxROM'], 'same as mapper 1 but forces the use of MMC1A'),
156
+ 156: ('Opencorp DAOU306', [], ''),
157
+ 157: ('Bandai Datach', [], 'Datach Reader games -> must go in the Datach subslot'),
158
+ 158: ('Tengen 800037', [], ''),
159
+ 159: ('Bandai EPROM (24C01)', [], ''),
160
+ 160: ('Sachen SA009', [], ''),
161
+ 162: ('Waixing FS304', [], 'not confirmed, but a lot of chinese releases use it like this...'),
162
+ 163: ('Nanjing Board', [], ''),
163
+ 164: ('Waixing FFV', [], ''),
164
+ 165: ('Waixing SH2', [], ''),
165
+ 166: ('SUBOR', [], ''),
166
+ 167: ('SUBOR', [], ''),
167
+ 168: ('Unlicensed Racermate', [], ''),
168
+ 171: ('Kaiser KS7058', [], ''),
169
+ 172: ('TXC Dumaracing', [], ''),
170
+ 173: ('TXC Mjblock', [], ''),
171
+ 174: ('Multicart 2751', [], ''),
172
+ 175: ('Kaiser KS7022', [], ''),
173
+ 176: ('Unlicensed Xiaozy', [], ''),
174
+ 177: ('Hengg Srich', [], ''),
175
+ 178: ('Waixing Sgzlz', [], ''),
176
+ 179: ('Hengg Xhzs', [], ''),
177
+ 180: ('Crazy Climber', [], 'Variation of UNROM, fixed first bank at $8000'),
178
+ 182: ('Supergame Lionking', [], 'duplicate of mapper 114'),
179
+ 183: ('Bootleg Shuiguan', [], ''),
180
+ 184: ('Sunsoft 1', [], ''),
181
+ 185: ('CNROM with protection diodes', [], ''),
182
+ 186: ('Fukutake Board', [], ''),
183
+ 187: ('Unlicensed KOF96', [], ''),
184
+ 188: ('Bandai Karaoke', [], ''),
185
+ 189: ('TXC TW', [], ''),
186
+ 190: ('Zemina Board', [], ''),
187
+ 191: ('Waixing Type B', [], ''),
188
+ 192: ('Pirate MMC3 derivative', [], 'Has both CHR ROM and CHR RAM (4k)'),
189
+ 193: ('Nanjing / NTDEC Fightinghero', [], ''),
190
+ 194: ('Waixing Type D', [], ''),
191
+ 195: ('Waixing Type E', [], ''),
192
+ 196: ('Bootleg SBROS11', [], ''),
193
+ 197: ('Unlicensed SF3', [], ''),
194
+ 198: ('Waixing Type F', [], ''),
195
+ 199: ('Waixing Type F1', [], ''),
196
+ 200: ('Multicart 36IN1', [], ''),
197
+ 201: ('Multicart 21IN1', [], ''),
198
+ 202: ('Multicart 150IN1', [], ''),
199
+ 203: ('Multicart 35IN1', [], ''),
200
+ 204: ('Multicart 64IN1', [], ''),
201
+ 205: ('Multicart 15IN1', [], ''),
202
+ 206: ('DxROM', ['Namco 118', 'MIMIC-1'], 'Simplified MMC3 predecessor lacking some features'),
203
+ 207: ('Taito X1 005', [], ''),
204
+ 208: ('Gouder 37017', [], ''),
205
+ 209: ('Jycompany C', [], ''),
206
+ 210: ('Namco 175 and 340', [], 'Namco 163 with different mirroring'),
207
+ 211: ('Jycompany B', [], ''),
208
+ 212: ('Multicart Superhik 300IN1', [], ''),
209
+ 213: ('Multicart GKB', [], 'duplicate of mapper 58'),
210
+ 214: ('Multicart Supergun 20IN1', [], ''),
211
+ 215: ('Unlicensed 8237', [], 'and UNL_8237A'),
212
+ 216: ('RCM GS2015', [], ''),
213
+ 217: ('Multicart 500IN1', [], ''),
214
+ 218: ('Nocash Nochr', [], ''),
215
+ 219: ('Unlicensed A9746', [], ''),
216
+ 221: ('Unlicensed N625092', [], ''),
217
+ 222: ('Bootleg Dragonninja', [], ''),
218
+ 223: ('Waixing Type I', [], "(according to NEStopia source, it's MMC3 with more WRAM)"),
219
+ 224: ('Waixing Type J', [], "(according to NEStopia source, it's MMC3 with more WRAM)"),
220
+ 225: ('Multicart 72IN1', [], ''),
221
+ 226: ('Multicart 76IN1', [], ''),
222
+ 227: ('Multicart 1200IN1', [], ''),
223
+ 228: ('Action 52', [], ''),
224
+ 229: ('Multicart 31IN1', [], ''),
225
+ 230: ('Multicart 22GAMES', [], ''),
226
+ 231: ('Multicart 20IN1', [], ''),
227
+ 232: ('Camerica/Codemasters Quattro', [], 'Multicarts'),
228
+ 233: ('Multicart 42IN1RESET', [], ''),
229
+ 234: ('AVE MAXI15', [], ''),
230
+ 235: ('Multicart GOLD260', [], '235 Golden Game x-in-1 games'),
231
+ 236: ('Multicart 70IN1', [], ''),
232
+ 237: ('Multicart Teletubbies', [], ''),
233
+ 238: ('Unlicensed 603 5052', [], ''),
234
+ 240: ('CNE Shlz', [], ''),
235
+ 241: ('TXC Commandos', [], ''),
236
+ 242: ('Waixing Wxzs', [], ''),
237
+ 243: ('Sachen 74LS374 ALT', [], ''),
238
+ 244: ('CNE Decathlon', [], ''),
239
+ 245: ('Waixing Type H', [], ''),
240
+ 246: ('CNE FSB', [], ''),
241
+ 249: ('Waixing Security', [], ''),
242
+ 250: ('Nitra TDA', [], ''),
243
+ 252: ('Waixing SGZ', [], ''),
244
+ 253: ('Hengg SHJY3', [], ''),
245
+ 254: ('Bootleg PIKACHUY2K', [], ''),
246
+ 255: ('Multicart 72IN1', [], 'duplicate of mapper 225'),
247
+ 258: ('Unlicensed 158B', [], ''),
248
+ 259: ('Multicart F15', [], ''),
249
+ 261: ('Multicart 810544C', [], ''),
250
+ 262: ('Sachen Shero', [], ''),
251
+ 263: ('Unlicensed KOF97', [], ''),
252
+ 264: ('Yoko Board', [], ''),
253
+ 265: ('Multicart T262', [], ''),
254
+ 266: ('Unlicensed Cityfight', [], ''),
255
+ 267: ('Multicart EL861121C', [], ''),
256
+ 268: ('SMD133 Board', [], ''),
257
+ 274: ('Multicart 80013B', [], ''),
258
+ 283: ('RCM GS2004', [], 'and RCM_GS2013'),
259
+ 285: ('Multicart A65AS', [], ''),
260
+ 286: ('Multicart Benshieng', [], ''),
261
+ 287: ('Multicart 411120C', [], ''),
262
+ 288: ('Multicart GKCXIN1', [], ''),
263
+ 289: ('Multicart 60311C', [], ''),
264
+ 290: ('Multicart NTD 03', [], ''),
265
+ 291: ('Multicart NT639', [], ''),
266
+ 292: ('Unlicensed BMW8544', [], 'Dragon Fighter by Flying Star'),
267
+ 294: ('Multicart Family 4646', [], 'FIXME: is this really exactly the same as mapper 134?'),
268
+ 297: ('TXC 22110', [], '2-in-1 Uzi Lightgun'),
269
+ 298: ('Unlicensed TF1201', [], 'Lethal Weapon (Enforcers) pirate'),
270
+ 299: ('Multicart 11160', [], ''),
271
+ 300: ('Multicart 190IN1', [], ''),
272
+ 301: ('Multicart 8157', [], ''),
273
+ 302: ('Kaiser KS7057', [], 'Gyruss FDS conversion'),
274
+ 303: ('Kaiser KS7017', [], 'Almana no Kiseki FDS conversion'),
275
+ 304: ('Bootleg 09034A', [], 'various FDS conversions'),
276
+ 305: ('Kaiser KS7031', [], 'Dracula II FDS conversion'),
277
+ 306: ('Kaiser KS7016', [], 'Exciting Basket FDS conversion'),
278
+ 307: ('Kaiser KS7037', [], 'Metroid FDS conversion'),
279
+ 308: ('Unlicensed TH21311', [], 'Batman (Sunsoft) pirate on VRC2 clone hardware'),
280
+ 309: ('Unlicensed LH51', [], 'Ai Senshi Nicol alt FDS conversion'),
281
+ 312: ('Kaiser KS7013B', [], 'Highway Star Kaiser bootleg'),
282
+ 313: ('Multicart Resettxrom', [], ''),
283
+ 314: ('Multicart 64IN1NR', [], ''),
284
+ 319: ('Multicart HP898F', [], ''),
285
+ 320: ('Multicart 830425C', [], ''),
286
+ 322: ('Multicart K3033', [], ''),
287
+ 323: ('Farid SLROM8IN1', [], 'homebrew 8-in-1'),
288
+ 324: ('Farid UNROM8IN1', [], 'homebrew 8-in-1'),
289
+ 325: ('Unlicensed Malisb', [], 'Super Mali Splash Bomb pirate hack'),
290
+ 326: ('Bootleg Contraj', [], ''),
291
+ 328: ('Unlicensed RT01', [], 'test cart (Russia)'),
292
+ 329: ('Unlicensed EDU2K', [], ''),
293
+ 330: ('Bootleg L001', [], 'Sangokushi II bootleg (retitled part III)'),
294
+ 331: ('Multicart 12IN1', [], ''),
295
+ 332: ('Multicart WS', [], ''),
296
+ 333: ('Multicart 8IN1', [], ''),
297
+ 334: ('Multicart 5IN1 1993', [], ''),
298
+ 335: ('Multicart CTC09', [], ''),
299
+ 336: ('Multicart K3046', [], ''),
300
+ 337: ('Multicart CTC 12IN1', [], ''),
301
+ 338: ('Multicart SA005A', [], ''),
302
+ 339: ('Multicart K3006', [], ''),
303
+ 340: ('Multicart K3036', [], ''),
304
+ 341: ('Multicart TJ03', [], ''),
305
+ 345: ('Multicart L6IN1', [], ''),
306
+ 346: ('Kaiser KS7012', [], 'Zanac alt FDS conversion'),
307
+ 347: ('Kaiser KS7030', [], 'Doki Doki Panic alt FDS conversion'),
308
+ 348: ('Multicart 830118C', [], ''),
309
+ 349: ('Multicart G146', [], ''),
310
+ 350: ('Multicart 891227', [], ''),
311
+ 351: ('Multicart TECHLINE9IN1', [], ''),
312
+ 352: ('Kaiser KS106C', [], '4-in-1'),
313
+ 353: ('Multicart 810305C', [], 'Super Mario Family multicart'),
314
+ 354: ('Multicart FAM250', [], ''),
315
+ 356: ('Multicart JY208', [], ''),
316
+ 361: ('Multicart YY841101C', [], ''),
317
+ 362: ('Multicart 830506C', [], ''),
318
+ 364: ('Multicart 830832C', [], ''),
319
+ 366: ('Multicart GN45', [], ''),
320
+ 368: ('Bootleg YUNG08', [], 'SMB2 FDS conversion'),
321
+ 370: ('Multicart F600', [], 'Golden Mario Party II multicart'),
322
+ 372: ('Multicart SFC12', [], ''),
323
+ 374: ('Multicart Resetsxrom', [], ''),
324
+ 376: ('Multicart YY841155C', [], ''),
325
+ 377: ('Multicart EL860947C', [], ''),
326
+ 380: ('Multicart 970630C', [], ''),
327
+ 381: ('Unlicensed KN42', [], '2-in-1 Big Nose games'),
328
+ 382: ('Multicart 830928C', [], ''),
329
+ 389: ('Caltron 9IN1', [], ''),
330
+ 392: ('Multicart 00202650', [], ''),
331
+ 393: ('Multicart 820720C', [], ''),
332
+ 396: ('Multicart 850437C', [], ''),
333
+ 399: ('Batmap 000', [], 'homebrew game Star Versus'),
334
+ 401: ('Multicart KC885', [], ''),
335
+ 404: ('Multicart JY012005', [], ''),
336
+ 409: ('Sealie Dpcmcart', [], 'A Winner is You homebrew music cart'),
337
+ 410: ('Multicart JY302', [], ''),
338
+ 411: ('Multicart A88S1', [], ''),
339
+ 413: ('Batmap Srrx', [], 'homebrew game Super Russian Roulette'),
340
+ 415: ('Bootleg 0353', [], 'Lucky (Roger) Rabbit FDS conversion'),
341
+ 416: ('Multicart N32 4IN1', [], ''),
342
+ 417: ('Bootleg Batmanfs', [], '"Fine Studio" Batman bootleg'),
343
+ 418: ('Unlicensed LH42', [], 'Highway Star Whirlwind Manu bootleg'),
344
+ 428: ('Multicart TF2740', [], ''),
345
+ 431: ('Multicart GN91B', [], ''),
346
+ 433: ('Multicart NC20MB', [], ''),
347
+ 434: ('Multicart S009', [], ''),
348
+ 437: ('Multicart TH2348', [], ''),
349
+ 438: ('Multicart K3071', [], ''),
350
+ 447: ('Multicart KL06', [], ''),
351
+ 452: ('Multicart DS927', [], ''),
352
+ 512: ('Sachen Zgdh', [], ''),
353
+ 513: ('Sachen SA9602B', [], ''),
354
+ 516: ('Cocoma Board', [], ''),
355
+ 519: ('Unlicensed EH8813A', [], 'Dr Mario II Chinese pirate'),
356
+ 520: ('Bootleg 2YUDB', [], ''),
357
+ 521: ('Dreamtech Board', [], 'Korean Igo'),
358
+ 522: ('Unlicensed LH10', [], 'Fuuun Shaolin Kyo FDS conversion'),
359
+ 524: ('Bootleg 900218', [], 'Lord of King pirate'),
360
+ 525: ('Kaiser KS7021A', [], 'GetsuFumaDen pirate (and maybe a Contra?)'),
361
+ 527: ('Unlicensed AX40G', [], 'Fudou Myouou Den pirate'),
362
+ 528: ('Multicart 831128C', [], '1995 New Series Super 2-in-1'),
363
+ 529: ('Unlicensed T230', [], 'Datach Dragon Ball Z IV bootleg'),
364
+ 530: ('Unlicensed AX5705', [], 'Super Mario Bros Pocker Mali'),
365
+ 533: ('Sachen 3014', [], 'Dong Dong Nao II'),
366
+ 535: ('Unlicensed LH53', [], 'Nazo no Murasamejo FDS conversion'),
367
+ 539: ('Bootleg Palthena', [], 'Hikari Shinwa (Kid Icarus) FDS conversion'),
368
+ 541: ('Multicart LITTLECOM160', [], ''),
369
+ 543: ('Multicart Srpg 5IN1', [], ''),
370
+ 549: ('Kaiser KS7016B', [], 'Meikyuu Jiin Dababa alt FDS conversion'),
371
+ 550: ('Multicart JY820845C', [], ''),
372
+ 551: ('Jncota KT1001', [], ''),
373
+ 552: ('Taito X1 017', [], ''),
374
+ 553: ('Sachen 3013', [], 'Dong Dong Nao 1'),
375
+ 554: ('Kaiser KS7010', [], 'Akumajo Dracula FDS conversion'),
376
+ 555: ('NES-EVENT 2', [], ''),
377
+ 557: ('Unlicensed LG25', [], 'Moero TwinBee FDS conversion'),
378
+ }
379
+
380
+
381
+ def get_mapper_name(mapper_number: int) -> str:
382
+ """
383
+ Get the primary name for a mapper number.
384
+
385
+ Args:
386
+ mapper_number: The mapper number
387
+
388
+ Returns:
389
+ Primary mapper name, or "Unknown" if not found
390
+ """
391
+ if mapper_number in MAPPER_DATABASE:
392
+ return MAPPER_DATABASE[mapper_number][0]
393
+ return f"Unknown ({mapper_number})"
394
+
395
+
396
+ def get_mapper_alternate_names(mapper_number: int) -> List[str]:
397
+ """
398
+ Get alternate names for a mapper.
399
+
400
+ Args:
401
+ mapper_number: The mapper number
402
+
403
+ Returns:
404
+ List of alternate names, empty list if none
405
+ """
406
+ if mapper_number in MAPPER_DATABASE:
407
+ return MAPPER_DATABASE[mapper_number][1]
408
+ return []
409
+
410
+
411
+ def get_mapper_notes(mapper_number: int) -> str:
412
+ """
413
+ Get notes/information about a mapper.
414
+
415
+ Args:
416
+ mapper_number: The mapper number
417
+
418
+ Returns:
419
+ Notes string, empty if none
420
+ """
421
+ if mapper_number in MAPPER_DATABASE:
422
+ return MAPPER_DATABASE[mapper_number][2]
423
+ return ""
424
+
425
+
426
+ def get_mapper_info(mapper_number: int) -> Dict[str, Any]:
427
+ """
428
+ Get complete mapper information.
429
+
430
+ Args:
431
+ mapper_number: The mapper number
432
+
433
+ Returns:
434
+ Dictionary with 'name', 'alternates', and 'notes'
435
+ """
436
+ if mapper_number in MAPPER_DATABASE:
437
+ name, alternates, notes = MAPPER_DATABASE[mapper_number]
438
+ return {
439
+ 'name': name,
440
+ 'alternates': alternates,
441
+ 'notes': notes,
442
+ 'all_names': [name] + alternates,
443
+ }
444
+
445
+ return {
446
+ 'name': f"Unknown ({mapper_number})",
447
+ 'alternates': [],
448
+ 'notes': '',
449
+ 'all_names': [f"Unknown ({mapper_number})"],
450
+ }
451
+
452
+
453
+ def is_known_mapper(mapper_number: int) -> bool:
454
+ """
455
+ Check if a mapper number is in the database.
456
+
457
+ Args:
458
+ mapper_number: The mapper number
459
+
460
+ Returns:
461
+ True if mapper is known, False otherwise
462
+ """
463
+ return mapper_number in MAPPER_DATABASE
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: ines-parser
3
- Version: 1.2.0
3
+ Version: 1.2.1
4
4
  Summary: A Python library and utilities for parsing iNES format NES ROM files
5
5
  Author: Leonid Kabanov
6
6
  License-Expression: MIT
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "ines-parser"
7
- version = "1.2.0"
7
+ version = "1.2.1"
8
8
  description = "A Python library and utilities for parsing iNES format NES ROM files"
9
9
  readme = "README.md"
10
10
  license = "MIT"
@@ -1,147 +0,0 @@
1
- """
2
- Mapper information database
3
-
4
- Provides lookup tables for mapper names and additional information.
5
- Based on NESdev Wiki mapper list.
6
- """
7
-
8
- from typing import Dict, Optional, List, Any
9
-
10
- # Mapper database: mapper_number -> (primary_name, [alternate_names], notes)
11
- MAPPER_DATABASE: Dict[int, tuple] = {
12
- 0: ("NROM", [], ""),
13
- 1: ("MMC1", ["SxROM"], ""),
14
- 2: ("UxROM", [], ""),
15
- 3: ("CNROM", [], ""),
16
- 4: ("MMC3", ["TxROM", "MMC6"], ""),
17
- 5: ("MMC5", ["ExROM"], "Contains expansion sound"),
18
- 7: ("AxROM", [], ""),
19
- 9: ("MMC2", ["PxROM"], ""),
20
- 10: ("MMC4", ["FxROM"], ""),
21
- 11: ("Color Dreams", [], ""),
22
- 13: ("CPROM", [], ""),
23
- 15: ("100-in-1 Contra Function 16", [], "Multicart"),
24
- 16: ("Bandai EPROM (24C02)", [], ""),
25
- 18: ("Jaleco SS8806", [], ""),
26
- 19: ("Namco 163", [], "Contains expansion sound"),
27
- 21: ("VRC4", ["VRC4a", "VRC4c"], ""),
28
- 22: ("VRC2", ["VRC2a"], ""),
29
- 23: ("VRC2/VRC4", ["VRC2b", "VRC4e"], ""),
30
- 24: ("VRC6", ["VRC6a"], "Contains expansion sound"),
31
- 25: ("VRC4", ["VRC4b", "VRC4d"], ""),
32
- 26: ("VRC6", ["VRC6b"], "Contains expansion sound"),
33
- 34: ("BNROM", ["NINA-001"], ""),
34
- 64: ("RAMBO-1", [], "MMC3 clone with extra features"),
35
- 66: ("GxROM", ["MxROM"], ""),
36
- 68: ("After Burner", [], "ROM-based nametables"),
37
- 69: ("Sunsoft FME-7", ["Sunsoft 5B"], "The 5B is the FME-7 with expansion sound"),
38
- 71: ("Camerica/Codemasters", [], "Similar to UNROM"),
39
- 73: ("VRC3", [], ""),
40
- 74: ("Pirate MMC3 derivative", [], "Has both CHR ROM and CHR RAM (2k)"),
41
- 75: ("VRC1", [], ""),
42
- 76: ("Namco 109 variant", [], ""),
43
- 79: ("NINA-03/NINA-06", [], "It's either 003 or 006, we don't know right now"),
44
- 85: ("VRC7", [], "Contains expansion sound"),
45
- 86: ("JALECO-JF-13", [], ""),
46
- 94: ("Senjou no Ookami", [], ""),
47
- 105: ("NES-EVENT", [], "Similar to MMC1"),
48
- 113: ("NINA-03/NINA-06??", [], "For multicarts including mapper 79 games"),
49
- 118: ("TxSROM", ["MMC3"], "MMC3 with independent mirroring control"),
50
- 119: ("TQROM", ["MMC3"], "Has both CHR ROM and CHR RAM"),
51
- 159: ("Bandai EPROM (24C01)", [], ""),
52
- 166: ("SUBOR", [], ""),
53
- 167: ("SUBOR", [], ""),
54
- 180: ("Crazy Climber", [], "Variation of UNROM, fixed first bank at $8000"),
55
- 185: ("CNROM with protection diodes", [], ""),
56
- 192: ("Pirate MMC3 derivative", [], "Has both CHR ROM and CHR RAM (4k)"),
57
- 206: ("DxROM", ["Namco 118", "MIMIC-1"], "Simplified MMC3 predecessor lacking some features"),
58
- 210: ("Namco 175 and 340", [], "Namco 163 with different mirroring"),
59
- 228: ("Action 52", [], ""),
60
- 232: ("Camerica/Codemasters Quattro", [], "Multicarts"),
61
- }
62
-
63
-
64
- def get_mapper_name(mapper_number: int) -> str:
65
- """
66
- Get the primary name for a mapper number.
67
-
68
- Args:
69
- mapper_number: The mapper number
70
-
71
- Returns:
72
- Primary mapper name, or "Unknown" if not found
73
- """
74
- if mapper_number in MAPPER_DATABASE:
75
- return MAPPER_DATABASE[mapper_number][0]
76
- return f"Unknown ({mapper_number})"
77
-
78
-
79
- def get_mapper_alternate_names(mapper_number: int) -> List[str]:
80
- """
81
- Get alternate names for a mapper.
82
-
83
- Args:
84
- mapper_number: The mapper number
85
-
86
- Returns:
87
- List of alternate names, empty list if none
88
- """
89
- if mapper_number in MAPPER_DATABASE:
90
- return MAPPER_DATABASE[mapper_number][1]
91
- return []
92
-
93
-
94
- def get_mapper_notes(mapper_number: int) -> str:
95
- """
96
- Get notes/information about a mapper.
97
-
98
- Args:
99
- mapper_number: The mapper number
100
-
101
- Returns:
102
- Notes string, empty if none
103
- """
104
- if mapper_number in MAPPER_DATABASE:
105
- return MAPPER_DATABASE[mapper_number][2]
106
- return ""
107
-
108
-
109
- def get_mapper_info(mapper_number: int) -> Dict[str, Any]:
110
- """
111
- Get complete mapper information.
112
-
113
- Args:
114
- mapper_number: The mapper number
115
-
116
- Returns:
117
- Dictionary with 'name', 'alternates', and 'notes'
118
- """
119
- if mapper_number in MAPPER_DATABASE:
120
- name, alternates, notes = MAPPER_DATABASE[mapper_number]
121
- return {
122
- 'name': name,
123
- 'alternates': alternates,
124
- 'notes': notes,
125
- 'all_names': [name] + alternates,
126
- }
127
-
128
- return {
129
- 'name': f"Unknown ({mapper_number})",
130
- 'alternates': [],
131
- 'notes': '',
132
- 'all_names': [f"Unknown ({mapper_number})"],
133
- }
134
-
135
-
136
- def is_known_mapper(mapper_number: int) -> bool:
137
- """
138
- Check if a mapper number is in the database.
139
-
140
- Args:
141
- mapper_number: The mapper number
142
-
143
- Returns:
144
- True if mapper is known, False otherwise
145
- """
146
- return mapper_number in MAPPER_DATABASE
147
-
File without changes
File without changes
File without changes