GOSK is an assembler project written in Go, designed to parse an assembly language similar to NASK (a language used in the "30 days self-made OS" book) and generate machine code (currently supporting COFF format). It utilizes PEG (Parsing Expression Grammar) for parsing.
- Parses NASK-like assembly code.
- Generates COFF object files.
- Includes a test suite for verification.
Requires Go and Make installed.
# Clone the repository (if you haven't already) # git clone https://github.com/HobbyOSs/gosk.git # cd gosk # Build the executable make build # Or install directly (might require setting up GOPATH/GOBIN) # Note: This installs the command to your $GOPATH/bin or $GOBIN go install github.com/HobbyOSs/gosk/cmd/gosk@latest
# Display help message ./gosk --help # Assemble a source file (e.g., input.nas) into an object file (e.g., output.o) ./gosk input.nas output.o # Assemble and generate a listing file (e.g., output.lst) ./gosk input.nas output.o output.lst
The command-line interface is:
usage: ./gosk [--help | -v] source [object/binary] [list]
source: Input assembly file (.nas)
object/binary: Output object file (e.g., .o, .obj) or raw binary file (Optional, defaults based on source name)
list: Output listing file (Optional)
--help: Show this help message
-v: Show version and license information
Contributions are welcome! Please refer to the project's issue tracker and coding guidelines. (Details might be found in the memory-bank directory).
This project is licensed under the LICENSE file.