Home

Overview

The Apple ][ Kit, or a2kit, is a command line program, and also a library, supporting disk image manipulations with language comprehension. It is written entirely in rust. The tool is designed to work with a wide variety of operating system and shell combinations.

Install

One way to install the latest is with cargo. More here after the first release.

General Principle

The tool is intended to be used with shell pipelines. The a2kit command takes as its first argument one of several subcommands, such as get, put, tokenize, etc.. Each subcommand is designed to be serviceable either as a node in a pipeline, or as a stand-alone console interaction. As an example, if one types

a2kit get -f hello -t atok -d hello.dsk

the console will display a hex dump of the tokenized Applesoft program HELLO that is found on the disk image hello.dsk. In order to display the BASIC listing, this can be piped into the detokenize subcommand:

a2kit get -f hello -t atok -d hello.dsk | a2kit detokenize -t atok

Note on Input Redirection

If you are using a shell that supports input redirection (PowerShell does not), there is sometimes a more compact notation. For example, the following are equivalent:

a2kit get -f prog.bas | a2kit tokenize -t atxt -a 2049

a2kit tokenize -t atxt -a 2049 < prog.bas