mirror of
https://git.fddl.dev/fddl/fddl.dev.git
synced 2024-12-25 23:10:31 +00:00
103 lines
5.3 KiB
HTML
103 lines
5.3 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="UTF-8">
|
|
<title>fddl Programming Language</title>
|
|
<!-- Google Fonts -->
|
|
<link href="https://fonts.googleapis.com/css?family=Roboto:400,700|Source+Code+Pro" rel="stylesheet">
|
|
<!-- Highlight.js Styles -->
|
|
<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/default.min.css">
|
|
<!-- Custom Stylesheet -->
|
|
<link rel="stylesheet" href="styles.css">
|
|
</head>
|
|
<body>
|
|
<header>
|
|
<h1>fddl Programming Language</h1>
|
|
</header>
|
|
<main>
|
|
<section class="images">
|
|
<img src="01.png" alt="Lexer Screenshot">
|
|
<img src="02.png" alt="Lexer Tests Screenshot">
|
|
<img src="03.png" alt="REPL Screenshot">
|
|
<img src="04.png" alt="Parsing 'hello, world'">
|
|
</section>
|
|
|
|
<h2>Overview</h2>
|
|
<p>fddl is a small programming language inspired by various languages, designed to help learn language implementation concepts in <a href="https://rust-lang.org">Rust</a>.</p>
|
|
<p>I have, off and on throughout the last 15 or so years attempted to learn a programming language of some sort. I could always get through the basics, but would get stuck with any real-world projects. And I wouldn't know who to turn to even if I knew where to start.</p>
|
|
<p>So I started learning Rust and really like it. I've been following some tutorials and the <a href="http://craftinginterpreters.com/">Crafting Interpreters</a> site as guides for this very problematic programming language.</p>
|
|
<p>I like aspects of so many programming languages, but I don't really like any of them, so I always found it hard to pick one and stick with it. But I had the same problem playing World of Warcraft, too.</p>
|
|
<p>So I, like many of you, decided to make a hobby programming language to see what may be able to be done with it. This is a brand new project as of September 2024 and I am one person.</p>
|
|
<p>The fact that I have a REPL working in this language is nothing short of amazing to me. It's fucking magic.</p>
|
|
|
|
<h2>Features</h2>
|
|
<ul>
|
|
<li>Custom syntax with unique (and arguably deranged) operators and keywords</li>
|
|
<li>Documentation comments using <code>#</code>, similar to Rust's style</li>
|
|
<li>Lexer and parser built from scratch</li>
|
|
</ul>
|
|
|
|
<h2>Getting Started</h2>
|
|
<p>To clone the repo:</p>
|
|
<pre><code class="language-bash">git clone https://git.fddl.dev/tristan/fddl.git</code></pre>
|
|
<p>To run the REPL:</p>
|
|
<pre><code class="language-bash">cargo run</code></pre>
|
|
<p>To run a fddl script:</p>
|
|
<pre><code class="language-bash">cargo run path/to/script.fddl</code></pre>
|
|
|
|
<h2>Examples</h2>
|
|
<p>Your basic hello, world:</p>
|
|
<pre><code class="language-rust">
|
|
func main() {
|
|
print(`hello, world in fddl`);
|
|
}
|
|
</code></pre>
|
|
<p>Defining a function inside a module, squaring a number:</p>
|
|
<pre><code class="language-rust">##! This is a sample module
|
|
|
|
module math {
|
|
|
|
### Computes the square of a number
|
|
func square(x) => x ^ 2;
|
|
}
|
|
|
|
define $number := 5;
|
|
print(`The square of $number is ${math.square($number)}`);</code></pre>
|
|
<p>(At least for right now.)</p>
|
|
|
|
<h2>License</h2>
|
|
<p>This project is licensed under the MIT License.</p>
|
|
|
|
<div class="notes">
|
|
<h2>Notes and Next Steps</h2>
|
|
<ul>
|
|
<li class="task-list-item"><input type="checkbox" checked disabled> Added first new set of tokens and features, added the first lexer tests.</li>
|
|
<li class="task-list-item"><input type="checkbox" disabled> <code>parser</code> module is a placeholder.</li>
|
|
<li class="task-list-item"><input type="checkbox" disabled> <code>interpreter</code> module is a placeholder.</li>
|
|
<li class="task-list-item"><input type="checkbox" disabled> Implement a more robust error handling mechanism instead of using <code>stderr</code>.</li>
|
|
<li class="task-list-item"><input type="checkbox" disabled> Implement string interpolation (backticks with <code>$variable</code>)</li>
|
|
<li class="task-list-item"><input type="checkbox" disabled> Continue to expand tests to cover all new syntax and features.</li>
|
|
<li class="task-list-item"><input type="checkbox" checked disabled> Made a crappy website.</li>
|
|
</ul>
|
|
</div>
|
|
|
|
<h2>Running the Project</h2>
|
|
<p>Make sure your project compiles and the tests pass:</p>
|
|
<pre><code class="language-bash">cargo build
|
|
cargo test</code></pre>
|
|
|
|
<div class="contact">
|
|
<p><a href="/cdn-cgi/l/email-protection#cabeb8a3b9beaba48aacaeaea6e4aeafbc">Contact</a></p>
|
|
<p><a href="https://git.fddl.dev/tristan/fddl">Git repo</a></p>
|
|
</div>
|
|
</main>
|
|
<footer>
|
|
© 2024 fddl Programming Language
|
|
</footer>
|
|
<!-- Highlight.js Scripts -->
|
|
<script src="//cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
|
|
<script>hljs.highlightAll();</script>
|
|
<!-- Cloudflare Email Protection Script -->
|
|
<script data-cfasync="false" src="/cdn-cgi/scripts/5c5dd728/cloudflare-static/email-decode.min.js"></script>
|
|
</body>
|
|
</html>
|