Compare commits
No commits in common. "master" and "0.1.0" have entirely different histories.
20
.github/workflows/test.yml
vendored
|
@ -1,20 +0,0 @@
|
|||
name: test
|
||||
|
||||
on:
|
||||
push:
|
||||
branches:
|
||||
- master
|
||||
pull_request:
|
||||
branches:
|
||||
- master
|
||||
|
||||
jobs:
|
||||
test:
|
||||
name: Test
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- uses: actions/checkout@v3
|
||||
- name: Build
|
||||
run: cargo build
|
||||
- name: Run tests
|
||||
run: cargo test
|
3
.gitmodules
vendored
|
@ -1,3 +0,0 @@
|
|||
[submodule "archpackage/bfy"]
|
||||
path = archpackage/bfy
|
||||
url = ssh://aur@aur.archlinux.org/bfy.git
|
|
@ -1,7 +0,0 @@
|
|||
pull_request_rules:
|
||||
- name: Automatic merge on approval
|
||||
conditions:
|
||||
- "#approved-reviews-by>=1"
|
||||
actions:
|
||||
merge:
|
||||
method: merge
|
10
Cargo.toml
|
@ -1,6 +1,6 @@
|
|||
[package]
|
||||
name = "bfy"
|
||||
version = "0.1.1"
|
||||
version = "0.1.0"
|
||||
edition = "2021"
|
||||
authors = ["Anas Elgarhy <anas.elgarhy.dev@gmail.com>"]
|
||||
license = "MIT"
|
||||
|
@ -31,12 +31,12 @@ exclude = [
|
|||
# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
|
||||
|
||||
[dependencies]
|
||||
clap = { version = "4.3.2", features = ["derive", "color", "cargo", "wrap_help", "suggestions"] }
|
||||
log = "0.4.18"
|
||||
pretty_env_logger = "0.5.0"
|
||||
clap = { version = "4.0.14", features = ["derive", "color", "cargo", "wrap_help", "suggestions"] }
|
||||
log = "0.4.17"
|
||||
pretty_env_logger = "0.4.0"
|
||||
colored = "2.0.0"
|
||||
# no-panic = "0.1.16"
|
||||
console = "0.15.7"
|
||||
console = "0.15.2"
|
||||
|
||||
[dev-dependencies]
|
||||
pretty_assertions = "1.3.0"
|
||||
|
|
198
README-ar.md
|
@ -1,198 +0,0 @@
|
|||
<p align="center">
|
||||
|
||||
<img alt="brainfuc*k interpreter" src="./assets/cover.png" width="100%" />
|
||||
|
||||
</p>
|
||||
|
||||
# ممترجم بسيط وREPL للغة brainfu*k مكتوب باللغة Rust🦀
|
||||
#### *اقرأ هذا في لغات أخرى.*
|
||||
[EN English](README.md)
|
||||
## المميزات
|
||||
-مترجم بسيط وREPL للغة brainfu*k مكتوب باللغة Rust 💫
|
||||
- تشغيل brainfuc * k رمز مباشر من REPL🚀
|
||||
- دعم أحرف UTF-8 بما في ذلك الرموز التعبيرية 😍 (اختياري)
|
||||
- يمكنك التحكم في حجم المصفوفة 📏
|
||||
|
||||
## تثبيت
|
||||
|
||||
- من crates.io:
|
||||
```shell
|
||||
cargo install bfy
|
||||
```
|
||||
- من aur:
|
||||
```shell
|
||||
yay -S bfy
|
||||
```
|
||||
|
||||
## الخيارات والحجج
|
||||
<details>
|
||||
<summary>جدول الخيارات</summary>
|
||||
<table>
|
||||
<thead>
|
||||
<tr>
|
||||
<th>اختيار</th>
|
||||
<th>وصف</th>
|
||||
<th>إفتراضي</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><code>-h</code>, <code>--help</code></td>
|
||||
<td>طباعة معلومات المساعدة</td>
|
||||
<td></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>-V</code>, <code>--version</code></td>
|
||||
<td>يطبع معلومات الإصدار</td>
|
||||
<td></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>-f</code>, <code>--features</code></td>
|
||||
<td>
|
||||
الميزات الإضافية للتمكين<br/>
|
||||
القيم الممكنة:
|
||||
<ul>
|
||||
<li>no-reverse-value:<br/>
|
||||
إذا كانت القيمة تريد إنقاص القيمة وكانت القيمة 0 ، فلا تعين القيمة على 255 ، وإلا قلل القيمة. <br/>
|
||||
إذا كانت القيمة تريد زيادة القيمة وكانت القيمة 255 ، فلا تقم بتعيين القيمة على 0 ، وإلا قم بزيادة القيمة. الاسم المستعار هو:
|
||||
"nrv"
|
||||
</li>
|
||||
<li>reverse-pointer:<br/>
|
||||
إذا كان المؤشر في نهاية المصفوفة ، فاضبط المؤشر على 0 ، وإلا قم بزيادة المؤشر. <br/>
|
||||
إذا كان المؤشر في بداية المصفوفة ، فاضبط المؤشر على نهاية المصفوفة ، وإلا قلل المؤشر. الاسم المستعار هو: `rp`
|
||||
</li>
|
||||
<li>allow-utf8:<br/>
|
||||
اسمح باستخدام أحرف utf8 (32 بت) ، وإلا فلن يُسمح إلا باستخدام أحرف 8 بت. <br/>
|
||||
استخدم هذه الميزة بحذر لأنها تزيد حجم الخلية من 8 بت إلى 32 بت. <br/>
|
||||
كما يسمح لك باستخدام الرموز التعبيرية في كود مخادعك: D ، هذا إذا استطعت
|
||||
حافظ على عقلك حتى تتمكن من الوصول إلى قيمتها الرقمية :). <br/>
|
||||
يمكن لـ "u32" في الصدأ تخزين القيم من 0 إلى 4294967295 فقط ، لكننا
|
||||
يمكن فقط استخدام 0 إلى 1114111 (0x10FFFF) في الوقت الحالي. الاسم المستعار هو: `utf8`
|
||||
</li>
|
||||
</ul>
|
||||
</td>
|
||||
<td>غير متوفر</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>-a</code>, <code>--array-size</code></td>
|
||||
<td>حجم المصفوفة</td>
|
||||
<td>30000</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>-w</code>, <code>--without-tiles</code></td>
|
||||
<td>لا تقم بطباعة المربعات (مثل رمز الخروج واسم الملف وما إلى ذلك)</td>
|
||||
<td></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</details>
|
||||
|
||||
|
||||
<details>
|
||||
<summary>مساعدة خيار الإخراج</summary>
|
||||
|
||||
```shell
|
||||
bfy --help
|
||||
```
|
||||
```text
|
||||
Brainfu*k interpreter and REPL written in Rust
|
||||
|
||||
Usage: bfy [OPTIONS] [SOURCE]
|
||||
|
||||
Arguments:
|
||||
[SOURCE]
|
||||
The brainfuck source code file to run (if not will be entered in REPL mode)
|
||||
|
||||
Options:
|
||||
-f, --features <FEATURES>
|
||||
Possible values:
|
||||
- no-reverse-value:
|
||||
If the value is you want decrement the value and the value is 0, don't set the value to 255, otherwise decrement the value. If the
|
||||
value is you want increment the value and the value is 255, don't set the value to 0, otherwise increment the value. The alias are:
|
||||
`nrv`
|
||||
- reverse-pointer:
|
||||
If the pointer at the end of the array, set the pointer to 0, otherwise increment the pointer. If the pointer at the beginning of the
|
||||
array, set the pointer to the end of the array, otherwise decrement the pointer. The alias are: `rp`
|
||||
- allow-utf8:
|
||||
Allow the use of utf8 characters (32 bit), otherwise only 8 bit characters are allowed. Use this feature with caution because it
|
||||
increases the cell size from 8 bits to 32 bits. It also allow you to use the emoji in your brainfuck code :D, This is if you can
|
||||
preserve your mind so that you can access their digital value :). The `u32` in rust can only store values from 0 to 4294967295, but we
|
||||
can only use 0 to 1114111 (0x10FFFF) for now. The alias are: `utf8`
|
||||
|
||||
-a, --array-size <ARRAY_SIZE>
|
||||
The brainfuck array size
|
||||
|
||||
[default: 30000]
|
||||
|
||||
-w, --without-tiles
|
||||
Dont print the tiles (e.g. exit code, file name, etc)
|
||||
|
||||
-h, --help
|
||||
Print help information (use `-h` for a summary)
|
||||
|
||||
-V, --version
|
||||
Print version information
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
### أمثلة
|
||||
|
||||
```bash
|
||||
bfy test_code/hello_world.bf
|
||||
```
|
||||
```text
|
||||
Hello world!
|
||||
Successfully ran brainfuck source code from file: test_code/hello_world.bf
|
||||
Exiting with code: 0
|
||||
```
|
||||
|
||||
```bash
|
||||
bfy -w test_code/hello_world.bf
|
||||
```
|
||||
```text
|
||||
Hello world!
|
||||
```
|
||||
|
||||
```bash
|
||||
bfy test_code/print_hi_yooo.bf
|
||||
```
|
||||
```text
|
||||
Hi yoooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooo!Successfully ran brainfuck source code from file: test_code/print_hi_yooo.bf
|
||||
Exiting with code: 0
|
||||
```
|
||||
|
||||
```bash
|
||||
bfy -w test_code/print_hi_yooo.bf
|
||||
```
|
||||
```text
|
||||
Hi yoooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooo!
|
||||
```
|
||||
|
||||
```bash
|
||||
bfy test_code/like_cat.bf
|
||||
```
|
||||
![output](./screenshots/like_cat_output.png)
|
||||
> ملاحظة: الإخراج ليس هو نفسه الإصدار الحالي للمترجم الفوري ، ولكنه مماثل لإخراج المترجم الفوري عندما أكتب الكود.
|
||||
|
||||
## REPL
|
||||
```bash
|
||||
bfy # REPL mode
|
||||
```
|
||||
![print @ and A in the repl](./screenshots/repl_print_at_and_A_0.1.0.png)
|
||||
|
||||
## لكى يفعل
|
||||
- [ ] أضف المزيد من الاختبارات
|
||||
- [ ] أضف المزيد من الأمثلة
|
||||
- [ ] قم بإنشاء منسق brainfu * k
|
||||
- [ ] أضف تمييز بناء الجملة في REPL
|
||||
- [ ] أضف الإكمال التلقائي في REPL
|
||||
- [ ] دعم ميزة حجم الصفيف الديناميكي
|
||||
|
||||
## مصادر
|
||||
- [Brainfuck in Wikipedia](https://en.wikipedia.org/wiki/Brainfuck)
|
||||
- [Programming in Brainfuck](http://cydathria.com/bf/brainfuck.html)
|
||||
- [Brainfuck: An Eight-Instruction Turing-Complete Programming Language](http://www.muppetlabs.com/~breadbox/bf)
|
||||
- [brainfuck-visualizer](https://github.com/usaikiran/brainfuck-visualizer)
|
||||
- [Basics of BrainFuck](https://gist.github.com/roachhd/dce54bec8ba55fb17d3a)
|
||||
- [An elegant programming language: Brainfuck](https://www.neperos.com/article/raqehg6b24ceadba)
|
|
@ -5,15 +5,6 @@
|
|||
</p>
|
||||
|
||||
# brainfuc*k interpreter: a simple brainfuc*k interpreter and REPL writen in rust 🦀
|
||||
#### *Read this in other languages.*
|
||||
|
||||
[AR Arabic-العربية](README-ar.md)
|
||||
|
||||
## Features
|
||||
- Run brainfuc*k code from a file 💫
|
||||
- Run brainfuc*k live code from the REPL 🚀
|
||||
- Support utf-8 characters including emojis 😍 (optional)
|
||||
- You can control in the array size 📏
|
||||
|
||||
## Install
|
||||
|
||||
|
|
|
@ -1,14 +0,0 @@
|
|||
pkgbase = bfy
|
||||
pkgdesc = brainfuc*k interpreter: a simple brainfuc*k interpreter and REPL writen in rust 🦀🤪
|
||||
pkgver = 0.1.1
|
||||
pkgrel = 1
|
||||
url = https://github.com/anas-elgarhy/bfy
|
||||
arch = x86_64
|
||||
license = MIT
|
||||
makedepends = cargo
|
||||
provides = bfy
|
||||
replaces = bfy
|
||||
source = bfy-0.1.1.tar.gz::https://static.crates.io/crates/bfy/bfy-0.1.1.crate
|
||||
sha256sums = 7994e9b500c63e09e5ee47e72b5654c84a2130c968256cebb687fce94ec6c55b
|
||||
|
||||
pkgname = bfy
|
|
@ -1,6 +1,6 @@
|
|||
# Maintainer: Anas Elgarhy <anas.elgarhy.dev@gmail.com>
|
||||
pkgname=bfy
|
||||
pkgver=0.1.1
|
||||
pkgver=0.1.0
|
||||
pkgrel=1
|
||||
epoch=
|
||||
pkgdesc="brainfuc*k interpreter: a simple brainfuc*k interpreter and REPL writen in rust 🦀🤪"
|
||||
|
@ -38,4 +38,3 @@ package() {
|
|||
cd "$pkgname-$pkgver"
|
||||
sudo install -Dm0755 -t "/usr/bin/" "target/release/$pkgname"
|
||||
}
|
||||
sha256sums=('7994e9b500c63e09e5ee47e72b5654c84a2130c968256cebb687fce94ec6c55b')
|
||||
|
|
|
@ -1 +0,0 @@
|
|||
Subproject commit 56d11304b639b13de32b5bc850da6bd719bbc3a8
|
BIN
assets/cover.jpg
Before Width: | Height: | Size: 38 KiB After Width: | Height: | Size: 40 KiB |
BIN
assets/cover.png
Before Width: | Height: | Size: 79 KiB After Width: | Height: | Size: 87 KiB |
|
@ -1,6 +0,0 @@
|
|||
{
|
||||
"$schema": "https://docs.renovatebot.com/renovate-schema.json",
|
||||
"extends": [
|
||||
"config:base"
|
||||
]
|
||||
}
|
Before Width: | Height: | Size: 12 KiB After Width: | Height: | Size: 16 KiB |
Before Width: | Height: | Size: 92 KiB After Width: | Height: | Size: 116 KiB |
|
@ -1,4 +0,0 @@
|
|||
++++++++++>>>>>+>>>+>>>+>+>>+[>++++++[-<[<<++++++++<]>>>[>>>]<<]<[<<.<]>>>[>>>]<
|
||||
<++++++[-<[<<--------<]>>>[>>>]<<]<[<<<]<<.>>>>>[[-]<+<[->>+<<]>>[[-<<+>>]<->]<[
|
||||
>+>>]<<<[-]>>>>]>>>[-<+>]<[->+<<<+>>]<<<<-[->+<]>[[-<+>]>+<]<<[<<+++++++++<]>>>[
|
||||
>>>]<<<]<++++++[-<++++++>]<++.
|
|
@ -1,6 +0,0 @@
|
|||
>++++++++++>+>+[
|
||||
[+++++[>++++++++<-]>.<++++++[>--------<-]+<<<]>.>>[
|
||||
[-]<[>+<-]>>[<<+>+>-]<[>+<-[>+<-[>+<-[>+<-[>+<-[>+<-
|
||||
[>+<-[>+<-[>+<-[>[-]>+>+<<<-[>+<-]]]]]]]]]]]+>>>
|
||||
]<<<
|
||||
]
|