From 4aefcdd5c899b0b3a879d8e58793d84ced06a0c4 Mon Sep 17 00:00:00 2001 From: Zak Farmer Date: Tue, 24 Oct 2023 18:02:52 +0100 Subject: [PATCH 1/2] Create README.md --- README.md | 43 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 43 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..6ae3c05 --- /dev/null +++ b/README.md @@ -0,0 +1,43 @@ +# php-rs + +A minimalistic PHP interpreter. + +## Overview + +With this project I'm attempting to create a lightweight PHP interpreter built using Rust. +It's currently in its early stages and is meant for experimental and educational purposes. + +## Features + +- Basic arithmetic operations +- Conditional operators / boolean expressions + +Expect this list to grow 😁 + +## Usage + +Ensure you have Rust and Cargo installed on your system. Clone the repository and navigate to the project root: + +```bash +git clone https://github.com/ZakFarmer/php-rs.git +cd php-rs +``` + +To run the interpreter: + +```bash +cargo run +``` + +To run the testsuite: +```bash +cargo test +``` + +## Credits +The design of the project was heavily influenced by Thorsten Ball's "Writing an Interpreter in Go" and "Writing a Compiler in Go", of course adapted to Rust. +100% recommend reading both as they're great books if you're interested in language fundamentals. + +## Contributing + +Although this project isn't intended to be anything consequential and certainly won't ever be used in production, contributions for educational purposes or to address small issues are always welcome. From d96791402f5e7bb40d4bc6298de056eef96ed14d Mon Sep 17 00:00:00 2001 From: Zak Farmer Date: Wed, 25 Oct 2023 20:22:12 +0100 Subject: [PATCH 2/2] Update README.md --- README.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/README.md b/README.md index 6ae3c05..8b028e4 100644 --- a/README.md +++ b/README.md @@ -7,6 +7,11 @@ A minimalistic PHP interpreter. With this project I'm attempting to create a lightweight PHP interpreter built using Rust. It's currently in its early stages and is meant for experimental and educational purposes. +## Try it out +I've deployed the REPL to the web using WebAssembly (see the ```wasm``` directory) + +You can find it [here](https://php-rs.zakfarmer.com). + ## Features - Basic arithmetic operations @@ -41,3 +46,9 @@ The design of the project was heavily influenced by Thorsten Ball's "Writing an ## Contributing Although this project isn't intended to be anything consequential and certainly won't ever be used in production, contributions for educational purposes or to address small issues are always welcome. + +Of course! Here's a new section you can add to your `README.md`: + +## Disclaimer + +This project is an independent work and is not affiliated with, endorsed by, or sponsored by the official PHP development team or the PHP Group. The interpreter has been created for experimental and educational purposes only.