agbcc python frontend
Project description
agbpycc
agbpycc is a python based compiler frontend for the agbcc compiler for the GameBoy Advance. It provides an interface more similar to a modern gcc frontend, making it easier to use agbcc with other tools like compiler explorer. agbpycc also does some processing of the assembly code, allowing for easier comparrison to other assembly. This is due to its main usage in decompiling matching binaries.
Installation
You can install agbpycc from pypi using pip. This installs agbpycc as a command line tool, and also as an importable module. You might want to use a virtual environment.
pip install agbpycc
To install from source, you need to build the ASM Parser first. This requires antlr. The provided Makefile takes care of downloading the tool using wget. Should wget not be available to you as a command, download the antlr tool manually, and place it in the projects directory.
git clone https://gitlab.com/henny022/agbpycc
cd agbpycc
make install
To work with the project files directly, you need to install the required dependencies in addition to building the antlr files. You can use the provided make target to do all this
git clone https://gitlab.com/henny022/agbpycc
cd agbpycc
make setup
Usage
To run agbpycc after install, use the agbpycc
command line tool.
agbpycc <arguments>
To run the files from source without installing run the python module from the project directory.
python -m agbpycc <arguments>
The following is a list of the most basic arguments.
Run agbpycc --help
to get a full list.
--cc1 Path to the agbcc binary (required for compiling C)
-o output assembly file name
-g enable debug info
processed output contains only file and line information
Assembling objects and Linking binaries are not yet supported.
Examples
compile a file to cleaned assembly for nice human reading
agbpycc --cc1 agbcc -g -o output.s input.c
clean assembly for nice human reading
agbpycc -o output.s input.s
Support
For problems with the tool, please use the gitlab issue tracker.
For questions you can use the tmc-misc
channel on the zeldaret discord server.
Ping @Henny022 there.
Contributing
To contribute your own code to this project, create a fork, do you changes and open a Merge Request. Please use gitmoji in your commit messages, this creates a neat git history and allows to grasp the contents of a commit in a single look.
Authors and acknowledgment
This was originally based on the pycc.py
file in this repo, most of the has been modified or replaced since. (original file)
Main Contributors:
- Octorock
- Henny022
License
This is licensed under the Unlicense. So you can use this code however you want. Any credit you can give is very appreciated.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.