https://github.com/overmighty/i-use-arch-btw

"I use Arch btw" but it's a Turing-complete programming language.
https://github.com/overmighty/i-use-arch-btw

arch-linux archlinux brainfuck c cpp esoteric-language esoteric-programming-language interpreter jit

Last synced: 19 days ago
JSON representation

"I use Arch btw" but it's a Turing-complete programming language.

• Host: GitHub
• URL: https://github.com/overmighty/i-use-arch-btw
• Owner: overmighty
• License: gpl-3.0
• Created: 2019-07-24T18:19:13.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2024-07-12T08:28:22.000Z (4 months ago)
• Last Synced: 2024-10-05T22:58:16.543Z (about 1 month ago)
• Topics: arch-linux, archlinux, brainfuck, c, cpp, esoteric-language, esoteric-programming-language, interpreter, jit
• Language: C
• Homepage:
• Size: 117 KB
• Stars: 803
• Watchers: 10
• Forks: 22
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

• stars - overmighty/i-use-arch-btw - complete programming language. (HarmonyOS / Windows Manager)
• awesome-github-repos - overmighty/i-use-arch-btw - "I use Arch btw" but it's a Turing-complete programming language. (C)
• awesome-list - i-use-arch-btw - complete programming language. | overmighty | 423 | (C)

README

        
# I use Arch btw

> "I use Arch btw" but it's a Turing-complete programming language.

## Introduction

I use Arch btw is an esoteric programming language based on [Brainfuck](

https://en.wikipedia.org/wiki/Brainfuck) in which the commands are the following

keywords:

`i`, `use`, `arch`, `linux`, `btw`, `by`, `the`, `way`, `gentoo`.

See the [language specification](./docs/language_specification.md) for more

information.

This repository contains a [C/C++ library implementing I use Arch btw](./lib)

and a dependent [command-line interpreter](./cmd).

## Getting Started

### Prerequisites

- [CMake](https://cmake.org/) >= 3.23

- a C99 and C++17 compiler toolchain supported by CMake and providing POSIX

  [`unistd.h`](https://en.wikipedia.org/wiki/Unistd.h), `mmap()`, `MAP_ANON`,

  and defining `__x86_64__` when targeting x86-64

### Building

    $ mkdir build

    $ cd build

    $ cmake -DCMAKE_BUILD_TYPE=Release -DBUILD_SHARED_LIBS=ON ..

    $ cmake --build .

### Installation

    # cmake --install .

### Usage

#### Command-line interpreter

    $ i-use-arch-btw 

Try some of the [example I use Arch btw programs](./examples) as source files.

For details:

    $ i-use-arch-btw -h

#### C/C++ library

For documentation of the public API, see the [public headers](

./lib/include/iuab).

For example usage, see the [command-line interpreter](./cmd) and [example

libiuab programs](./examples/libiuab).

## License

This software is licensed under the [GNU General Public License, version 3](

./LICENSE.md).