Skip to content
<open-source>
Oeiuwq Faith Blog OpenSource Porfolio

haze/pill

the ill programming language & interpreter
Source code at GitHub https://pill.ill.fi
haze/pill.json
{
  "createdAt": "2017-07-05T20:14:17Z",
  "defaultBranch": "master",
  "description": "the ill programming language & interpreter",
  "fullName": "haze/pill",
  "homepage": "https://pill.ill.fi",
  "language": "Rust",
  "name": "pill",
  "pushedAt": "2018-10-10T21:27:29Z",
  "stargazersCount": 13,
  "topics": [
    "assembly",
    "programming-language",
    "rust"
  ],
  "updatedAt": "2021-10-12T17:54:24Z",
  "url": "https://github.com/haze/pill"
}

pill

Section titled “pill”

The (Pretty) Ill Programming Language’s Rust Interpreter

Getting Started

Section titled “Getting Started”
  1. Clone the repo and cd. git clone https://github.com/hvze/pill & cd pill
  2. Build (or run) the project.

cargo build --release & ./target/release/pill <files> or cargo run -- <flags> <files>

Prerequisites

Section titled “Prerequisites”

I’m like 100% sure you need to have the rust toolchain installed, if you need to do that, try rustup.rs

Installing

Section titled “Installing”

clone the repository and run cargo build --release to produce a binary, then copy to your PATH variable for use elsewhere.

git clone https://github.com/hvze/pill && cd pill && cargo run -- tests/programs/do_good.ill

Running `target/debug/pill tests/programs/do/do_good.ill`
 a_res = 1
 PILL Execution took: 0s, (1 ms)

Running the tests

Section titled “Running the tests”

Categorized tests

Section titled “Categorized tests”

Most of the tests are pretty organized, just run the interpreter with the -d flag and see what the output is and if you see anything suspicious or unexpected output, let me know. Migration to a test suite will come soon!

pill -d <test_file>.ill

Deployment

Section titled “Deployment”

Clone the repository and run cargo build --release to produce a binary, then copy to your PATH variable for use elsewhere.

Built With

Section titled “Built With”

The following rust crates:

  • clap, v2.25.0
  • time, v0.1.37
  • termcolor, v0.3.3
  • pcre, v0.2.3
  • either, v1.2.0

Contributing

Section titled “Contributing”

Just make a pull request, and I’ll review it. No Code of Conduct or anything similar here.

Versioning

Section titled “Versioning”

Versioning is a bit hectic as I haven’t been keeping tags or marks on what i’ve added, but after the website is released i will start doing versioned releaes.

Authors

Section titled “Authors”
  • Haze Booth - Initial work - hvze

License

Section titled “License”

This project is licensed under the MIT License

Acknowledgments

Section titled “Acknowledgments”
  • Hat tip to anyone who’s code was used
  • Inspired loosely by FASM