atari_exe_tools 1.5.1 (#1589)

2025-09-06 17:00:41 +02:00
parent 37be358fbb
commit 49984d991b
1 changed files with 87 additions and 0 deletions
@@ -0,0 +1,87 @@
+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"
+