README-ar.md

@@ -0,0 +1,198 @@
+<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)

README.md

@@ -5,6 +5,9 @@
 </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 💫
@@ -194,4 +197,4 @@ bfy # REPL mode
 - [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)
+- [An elegant programming language: Brainfuck](https://www.neperos.com/article/raqehg6b24ceadba)