vibecode the entire rgz ig

rgz_vlasd/TESTING.md

@@ -0,0 +1,84 @@
+# Brief testing guide
+
+## 1. Build and start
+
+```bash
+make
+make run
+```
+
+`make run` starts the program with `disk.img` as the virtual carrier file.
+
+## 2. Basic filesystem scenario
+
+Enter these commands inside the program:
+
+```text
+format 512
+mkdir /docs
+touch /docs/test.txt
+write /docs/test.txt hello filesystem
+ls /docs
+cat /docs/test.txt
+rename /docs/test.txt renamed.txt
+cat /docs/renamed.txt
+info
+```
+
+Expected result:
+
+- formatting succeeds;
+- `/docs` contains one file;
+- `cat` prints `hello filesystem`;
+- after renaming, the file is available as `renamed.txt`;
+- `info` shows a 512 KiB carrier and occupied clusters.
+
+## 3. Compression and defragmentation
+
+```text
+touch /docs/repeat.txt
+write /docs/repeat.txt aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
+compress /docs/repeat.txt
+ls /docs
+defrag
+cat /docs/repeat.txt
+```
+
+Expected result:
+
+- `compress` succeeds for repeated text;
+- in `ls`, `stored` is smaller than `size` for `repeat.txt`;
+- after `defrag`, the file still reads correctly.
+
+## 4. Import and export
+
+Before starting the program, create a host file:
+
+```bash
+echo "outside file" > host.txt
+```
+
+Then inside the program:
+
+```text
+import host.txt /docs/imported.txt
+cat /docs/imported.txt
+export /docs/imported.txt exported.txt
+```
+
+After leaving the program, verify:
+
+```bash
+cat exported.txt
+```
+
+Expected result: `exported.txt` contains `outside file`.
+
+## 5. Cleanup
+
+```bash
+make clean
+rm -f host.txt exported.txt
+```
+
+`make clean` removes the executable and the default virtual disk image.