drifblim/README.md

33 lines
1.5 KiB
Markdown

# Drifblim
[Drifblim](https://wiki.xxiivv.com/drifblim) is a [Uxntal](https://wiki.xxiivv.com/site/uxntal.html) assembler, written in that same language.
The assembler is designed to help bootstrap the Uxn ecosystem, it is available as an assembled rom, a symbols file and a print-friendly source code, along with its hexadecimal data and the _napkin definition_ of the Uxn virtual machine.
## Build
This assembler is written in the language it is assembling, creating a chicken-and-egg problem. You have two choices, download a pre-assembled [drifblim.rom](https://rabbits.srht.site/drifblim/drifblim.rom)(1300 bytes), or use [uxnasm.c](https://git.sr.ht/~rabbits/uxn/tree/main/item/src/uxnasm.c).
```sh
# start with uxnasm
uxnasm src/drifblim.tal bin/drifblim-seed.rom
# from drifblim.rom
uxncli bin/drifblim-seed.rom src/drifblim.tal bin/drifblim.rom
# Assembling hello.tal
uxncli bin/drifblim.rom etc/hello.tal bin/hello.rom
uxncli bin/hello.rom
```
If do not wish to assemble it yourself, you can download [drifblim.rom](https://rabbits.srht.site/drifblim/drifblim.rom).
[![builds.sr.ht status](https://builds.sr.ht/~rabbits/drifblim.svg)](https://builds.sr.ht/~rabbits/drifblim?)
_Drifblim is strong enough to lift Pokemon or people but has no control over its flight. This causes it to drift with the wind and end up anywhere._
## Support
- Assembled with [itself](https://git.sr.ht/~rabbits/drifblim)
- Linted with [uxnlin.rom](https://git.sr.ht/~rabbits/uxnlin)
- Formatted with [uxnfor](https://git.sr.ht/~rabbits/uxnfor)