chore: update examples, and add just file

Signed-off-by: azjezz <azjezz@protonmail.com>

Author: azjezz

Justfile

@@ -0,0 +1,22 @@
+default:
+  @just --list
+
+# build the library
+build:
+    cargo build
+
+# regenerate schema
+update-examples:
+    rm examples/simple.php examples/complete.php
+    cargo run --example simple >> examples/simple.php
+    cargo run --example complete >> examples/complete.php
+
+# detect linting problems.
+lint:
+    cargo fmt --all -- --check
+    cargo clippy
+
+# fix linting problems.
+fix:
+    cargo fmt
+    cargo clippy --fix --allow-dirty --allow-staged

examples/complete.php

@@ -2,15 +2,51 @@
 
 declare(strict_types=1);
 
-namespace App;
+namespace Foo;
+
+use Foo\Bar\Baz as Qux;
+use Throwable;
+use DateTime;
+use DateTimeImmutable;
+
+use function strlen;
+use function array_map;
+use function array_filter;
+
+use const Foo\HELLO;
+use const Foo\HEY;
+
+
+const A = "Hello World!";
+const B = null;
+const C = 1;
+const D = false;
+const E = null;
+const F = 213.412;
+const G = [1, 25];
 
 /**
- * Format a string with the given arguments using sprintf.
+ * This is a simple hello function.
+ *
+ * @param non-empty-string $firstname
  *
- * @param non-empty-string $template
+ * @return string
  *
  * @pure
  */
+#[Qux(foo: 1, bar: 2)]
+function hello(
+    #[Validation\NotBlank, Validation\Length(min: 2, max: 10)]
+    string $firstname,
+    string $lastname = Qux::Foo,
+): string {
+    return 'Hello ' . $firstname . ' ' . $lastname . '!';
+}
+
+function nothing(): void {
+    // empty body
+}
+
 function format(
     string $template,
     int|float|string|null ...$args,
@@ -21,3 +57,73 @@ function format(
     ));
 }
 
+/**
+ * This is an example class.
+ *
+ * @immutable
+ */
+abstract class Example
+{
+    final const A = "Hello World!";
+
+    protected const B = null;
+
+    private const C = 1;
+
+    public const D = false;
+
+    private string $foo;
+
+    protected string $bar;
+
+    public string|int $baz = "Hello World!";
+
+    /**
+     * This is a simple hello function.
+     *
+     * @param non-empty-string $firstname
+     *
+     * @return string
+     *
+     * @pure
+     */
+    #[Qux(foo: 1, bar: 2), Qux(foo: 1, bar: 2)]
+    function hello(
+        string $firstname,
+        string $lastname = Qux::Foo,
+    ): string {
+        return 'Hello ' . $firstname . ' ' . $lastname . '!';
+    }
+
+    /**
+     * This is a simple x function.
+     *
+     * @pure
+     */
+    #[Foo(foo: 1, bar: 2), Bar(foo: 1, bar: 2)]
+    #[Baz, Qux]
+    public function x(): mixed {
+        return 'Hello!';
+    }
+
+    /**
+     * This is a simple poop function.
+     */
+    public abstract function poop(): void;
+
+    /**
+     * This is a simple echo function.
+     */
+    public final function helloWorld(): void {
+        echo 'Hello World!';
+    }
+}
+
+interface Formatter
+{
+    public function format(
+        string $template,
+        int|float|string|null ...$args,
+    ): string;
+}
+

examples/complete.rs

@@ -6,6 +6,7 @@ use php_codegen::constant::Constant;
 use php_codegen::data_type::DataType;
 use php_codegen::file::File;
 use php_codegen::function::Function;
+use php_codegen::interface::Interface;
 use php_codegen::literal::Value;
 use php_codegen::method::Method;
 use php_codegen::modifiers::Modifier;
@@ -171,6 +172,23 @@ fn main() {
                             indentation.indent("echo 'Hello World!';", level)
                         }),
                 ),
+        )
+        .interface(
+            Interface::new("Formatter").method(
+                Method::new("format")
+                    .parameter(Parameter::new("template").typed(DataType::String))
+                    .parameter(
+                        Parameter::new("args")
+                            .variadic()
+                            .typed(DataType::Union(vec![
+                                DataType::Integer,
+                                DataType::Float,
+                                DataType::String,
+                                DataType::Null,
+                            ])),
+                    )
+                    .returns(DataType::String),
+            ),
         );
 
     print!("{file}");