Martin Krischik
88 lines
3.9 KiB
TOML
88 lines
3.9 KiB
TOML
name = "atari_exe_tools"
|
|
description = "Cross-platform tool for analysing and inspecting Atari 8-bit EXE files"
|
|
long-description = """Atari EXE Tools is a robust, cross-platform utility written in Ada 2022 for analysing Atari 8-bit executable (EXE) files, used in Atari 400/800 and XL/XE systems or emulators like Altirra and Atari800. Unlike most existing tools, which are typically Windows-only, this tool operates seamlessly on macOS, Linux, and Windows, making it an essential asset for retro computing enthusiasts and developers working across diverse platforms.
|
|
|
|
Key features include:
|
|
|
|
**Header Analysis**: Extract and display detailed metadata from EXE files,
|
|
including memory start/end addresses, segment lengths, and init/run vectors.
|
|
|
|
```sh
|
|
> exe_tools-main --print-header ./test/share/atari_check_exe_test/HELLO_C.EXE
|
|
File: ./test/share/atari_check_exe_test/HELLO_C.EXE
|
|
Magic: $FFFF; Start: $2E00; End: $2EF5; Length: 246
|
|
Magic: $0000; Start: $02E2; End: $02E3; Length: 2; Init: $2E47
|
|
Magic: $0000; Start: $2400; End: $28DE; Length: 1247
|
|
Magic: $0000; Start: $02E0; End: $02E1; Length: 2; Run: $2401
|
|
```
|
|
|
|
Data Dumping: Output hexadecimal data from EXE files for inspection, with ATASCII portions omitted to ensure compatibility with non-UTF-8 environments.
|
|
|
|
|
|
```sh
|
|
> exe_tools-main --print-data ./test/share/atari_check_exe_test/HELLO_A.EXE
|
|
File: ./test/share/atari_check_exe_test/HELLO_A.EXE
|
|
2400: 60 60 A2 00 A9 0B 9D 42 03 A9 3F 9D 44 03 A9 24
|
|
2410: 9D 45 03 A9 2E 9D 48 03 A9 00 9D 49 03 20 56 E4
|
|
2420: A2 00 A9 07 9D 42 03 A9 6D 9D 44 03 A9 24 9D 45
|
|
2430: 03 A9 01 9D 48 03 A9 00 9D 49 03 20 56 E4 60 48
|
|
2440: 65 6C 6C 6F 20 57 6F 72 6C 64 21 9B 28 75 73 69
|
|
2450: 6E 67 20 61 20 65 78 65 63 75 74 61 62 6C 65 20
|
|
2460: 69 6E 20 61 73 73 65 6D 62 6C 65 72 29 9B 00
|
|
02E0: 02 24
|
|
Run: $2402
|
|
```
|
|
|
|
The tool includes a comprehensive AUnit test suite to ensure reliability across
|
|
platforms and Atari 8-bit configurations. Source code and tests are available
|
|
on SourceForge. Detailed GNATdoc documentation can be found at 6502
|
|
Tutorial.
|
|
"""
|
|
version = "1.5.1"
|
|
licenses = "GPL-3.0-or-later"
|
|
authors = ["Martin Krischik"]
|
|
maintainers = ["Martin Krischik <krischik@users.sourceforge.net>"]
|
|
maintainers-logins = ["krischik"]
|
|
executables = ["exe_tools-main"]
|
|
website = "https://sourceforge.net/projects/tutorial-6502"
|
|
tags = ["atari", "tools", "retrocomputing", "ada-2022"]
|
|
|
|
[build-switches]
|
|
"*".ada_version = "Ada2022"
|
|
"*".source_encoding = "UTF_8"
|
|
development.compile_checks = "Warnings"
|
|
development.contracts = "Yes"
|
|
development.debug_info = "Yes"
|
|
development.optimization = "Debug"
|
|
development.runtime_checks = "Everything"
|
|
release.compile_checks = "Warnings"
|
|
release.contracts = "Yes"
|
|
release.debug_info = "No"
|
|
release.optimization = "Performance"
|
|
release.runtime_checks = "Everything"
|
|
validation.compile_checks = "Warnings"
|
|
validation.contracts = "Yes"
|
|
validation.debug_info = "Yes"
|
|
validation.optimization = "Debug"
|
|
validation.runtime_checks = "Everything"
|
|
|
|
[[depends-on]]
|
|
adacl = "^6.3.0"
|
|
|
|
[[actions]]
|
|
type = "test"
|
|
command = ["alr", "run"]
|
|
directory = "test"
|
|
|
|
# vim: set textwidth=0 nowrap tabstop=8 shiftwidth=4 softtabstop=4 expandtab :
|
|
# vim: set filetype=toml fileencoding=utf-8 fileformat=unix foldmethod=diff :
|
|
# vim: set spell spelllang=en_gb :
|
|
|
|
[origin]
|
|
hashes = [
|
|
"sha256:d60e073111d639242eedebd3e11b18f781b9d600c12e3d04fbd4bf1dd3f7a9e6",
|
|
"sha512:c2700ec5d401dab2d48027d265d70ccd0985a1c735c6bba692352576c746d83b4195965850e03867de8827e06739e3e09b1375130f0e17db1d5e8cdf362889c5",
|
|
]
|
|
url = "https://sourceforge.net/projects/tutorial-6502/files/Alire/atari_exe_tools-1.5.1.tgz"
|
|
|