Rust SDK

example.php

@@ -18,6 +18,7 @@
 use Appwrite\SDK\Language\SwiftClient;
 use Appwrite\SDK\Language\DotNet;
 use Appwrite\SDK\Language\Flutter;
+use Appwrite\SDK\Language\Rust;
 use Appwrite\SDK\Language\Android;
 use Appwrite\SDK\Language\Kotlin;
 
@@ -395,8 +396,32 @@ function getSSLPage($url) {
     ;
     $sdk->generate(__DIR__ . '/examples/CLI');
 
-    // Android
+    // Rust
+    $rust = new Rust();
+    $rust->setPackageName('appwrite');
+
+    $sdk  = new SDK($rust, new Swagger2($spec));
 
+    $sdk
+        ->setName('NAME')
+        ->setDescription('Repo description goes here')
+        ->setShortDescription('Repo short description goes here')
+        ->setURL('https://example.com')
+        ->setLogo('https://appwrite.io/v1/images/console.png')
+        ->setLicenseContent('test test test')
+        ->setWarning('**WORK IN PROGRESS - NOT READY FOR USAGE**')
+        ->setChangelog('**CHANGELOG**')
+        ->setVersion('0.0.1')
+        ->setGitUserName('repoowner')
+        ->setGitRepoName('reponame')
+        ->setDefaultHeaders([
+            'X-Appwrite-Response-Format' => '0.7.0',
+        ])
+    ;
+
+    $sdk->generate(__DIR__ . '/examples/rust');
+
+    // Android
     $sdk = new SDK(new Android(), new Swagger2($spec));
 
     $sdk

src/SDK/Language/Rust.php

@@ -0,0 +1,262 @@
+<?php
+
+namespace Appwrite\SDK\Language;
+
+use Appwrite\SDK\Language;
+
+class Rust extends Language {
+    /**
+     * @var array
+     */
+    protected $params = [
+      'packageName' => 'packageName',
+    ];
+
+    /**
+     * @param string $name
+     * @return $this
+     */
+    public function setPackageName($name)
+    {
+        $this->setParam('packageName', $name);
+
+        return $this;
+    }
+
+    /**
+     * @return string
+     */
+    public function getName()
+    {
+        return 'Rust';
+    }
+
+    /**
+     * Get Language Keywords List
+     *
+     * @return array
+     */
+    public function getKeywords()
+    {
+        return [
+          "type",
+          "as",
+          "break",
+          "const",
+          "continue",
+          "crate",
+          "else",
+          "enum",
+          "extern",
+          "false",
+          "fn",
+          "for",
+          "if",
+          "impl",
+          "in",
+          "let",
+          "loop",
+          "match",
+          "mod",
+          "move",
+          "mut",
+          "pub",
+          "ref",
+          "return",
+          "self",
+          "Self",
+          "static",
+          "struct",
+          "super",
+          "trait",
+          "true",
+          "type",
+          "unsafe",
+          "use",
+          "where",
+          "while",
+          "async",
+          "await",
+          "dyn",
+          "abstract",
+          "become",
+          "box",
+          "do",
+          "final",
+          "macro",
+          "override",
+          "priv",
+          "typeof",
+          "unsized",
+          "virtual",
+          "yield",
+          "try"
+        ];
+    }
+
+    /**
+     * @param $type
+     * @return string
+     */
+    public function getTypeName($type)
+    {
+        switch ($type) {
+            case self::TYPE_OBJECT:
+                return 'Option<HashMap<String, crate::client::ParamType>>';
+            break;
+            case self::TYPE_INTEGER:
+                return 'i64';
+            break;
+            case self::TYPE_STRING:
+                return '&str';
+            break;
+            case self::TYPE_FILE:
+                return 'std::path::PathBuf';
+            break;
+            case self::TYPE_BOOLEAN:
+                return 'bool';
+            break;
+            case self::TYPE_ARRAY:
+              return '&[&str]';
+            case self::TYPE_NUMBER:
+                return 'f64';
+            break;
+        }
+
+        return $type;
+    }
+
+    /**
+     * @param array $param
+     * @return string
+     */
+    public function getParamDefault(array $param)
+    {
+        return "";
+    }
+
+    /**
+     * @param array $param
+     * @return string
+     */
+    public function getParamExample(array $param)
+    {
+        $type       = $param['type'] ?? '';
+        $example    = $param['example'] ?? '';
+
+        $output = '';
+
+        if(empty($example) && $example !== 0 && $example !== false) {
+            switch ($type) {
+                case self::TYPE_FILE:
+                    $output .= 'std::path::PathBuf::from("./path-to-files/image.jpg")';
+                    break;
+                case self::TYPE_NUMBER:
+                case self::TYPE_INTEGER:
+                    $output .= '0';
+                break;
+                case self::TYPE_BOOLEAN:
+                    $output .= 'false';
+                    break;
+                case self::TYPE_STRING:
+                    $output .= 'String::new()';
+                    break;
+                case self::TYPE_OBJECT:
+                    $output .= 'new Object()';
+                    break;
+                case self::TYPE_ARRAY:
+                    $output .= '&[]';
+                    break;
+            }
+        }
+        else {
+            switch ($type) {
+                case self::TYPE_OBJECT:
+                case self::TYPE_FILE:
+                case self::TYPE_NUMBER:
+                case self::TYPE_INTEGER:
+                case self::TYPE_ARRAY:
+                    $output .= $example;
+                    break;
+                case self::TYPE_BOOLEAN:
+                    $output .= ($example) ? 'true' : 'false';
+                    break;
+                case self::TYPE_STRING:
+                    $output .= sprintf('"%s"', $example);
+                    break;
+            }
+        }
+
+        return $output;
+    }
+
+    /**
+     * @return array
+     */
+    public function getFiles()
+    {
+        return [
+            [
+                'scope'         => 'default',
+                'destination'   => 'Cargo.toml',
+                'template'      => '/rust/Cargo.toml.twig',
+                'minify'        => false,
+            ],
+            [
+                'scope'         => 'default',
+                'destination'   => 'README.md',
+                'template'      => '/rust/README.md.twig',
+                'minify'        => false,
+            ],
+            [
+                'scope'         => 'default',
+                'destination'   => 'CHANGELOG.md',
+                'template'      => '/rust/CHANGELOG.md.twig',
+                'minify'        => false,
+            ],
+            [
+                'scope'         => 'default',
+                'destination'   => 'LICENSE',
+                'template'      => '/rust/LICENSE.twig',
+                'minify'        => false,
+            ],
+	          [
+                'scope'         => 'method',
+                'destination'   => 'docs/examples/{{service.name | caseLower}}/{{method.name | caseDash}}.md',
+                'template'      => '/rust/docs/example.md.twig',
+                'minify'        => false,
+            ],
+            [
+              'scope'         => 'method',
+              'destination'   => 'src/lib.rs',
+              'template'      => '/rust/src/lib.rs.twig',
+              'minify'        => false,
+            ],
+            [
+              'scope'         => 'method',
+              'destination'   => 'src/client.rs',
+              'template'      => '/rust/src/client.rs.twig',
+              'minify'        => false,
+            ],
+            [
+              'scope'         => 'method',
+              'destination'   => 'src/services/mod.rs',
+              'template'      => '/rust/src/services/mod.rs.twig',
+              'minify'        => false,
+            ],
+            [
+              'scope'         => 'method',
+              'destination'   => 'src/services/exception.rs',
+              'template'      => '/rust/src/services/exception.rs.twig',
+              'minify'        => false,
+            ],
+            [
+              'scope'         => 'service',
+              'destination'   => 'src/services/{{service.name | caseDash}}.rs',
+              'template'      => '/rust/src/services/service.rs.twig',
+              'minify'        => false,
+          ],
+        ];
+    }
+}
+

src/SDK/SDK.php

@@ -149,7 +149,7 @@ public function __construct(Language $language, Spec $spec)
         $this->twig->addFilter(new TwigFilter('dartComment', function ($value) {
             $value = explode("\n", $value);
             foreach ($value as $key => $line) {
-                $value[$key] = "     /// " . wordwrap($value[$key], 75, "\n     /// ");
+                $value[$key] = "    /// " . wordwrap($value[$key], 75, "\n    /// ");
             }
             return implode("\n", $value);
         }, ['is_safe' => ['html']]));

templates/dart/lib/services/service.dart.twig

@@ -10,11 +10,11 @@ class {{ service.name | caseUcfirst }} extends Service {
     {{ service.name | caseUcfirst }}(Client client): super(client);
 {% for method in service.methods %}
 
-     /// {{ method.title }}
+    /// {{ method.title }}
 {% if method.description %}
-     ///
+    ///
 {{ method.description|dartComment }}
-     ///
+    ///
 {% endif %}
     {% if method.type == 'webAuth' %}Future{% elseif method.type == 'location' %} Future<Uint8List> {% else %} {% if method.responseModel and method.responseModel != 'any' %}Future<models.{{method.responseModel | ucFirstAndEscape}}>{% else %}Future{% endif %}{% endif %} {{ method.name | caseCamel }}({{ _self.method_parameters(method.parameters) }}) async {
         final String path = '{{ method.path }}'{% for parameter in method.parameters.path %}.replaceAll('{{ '{' }}{{ parameter.name | caseCamel }}{{ '}' }}', {{ parameter.name | caseCamel | escapeKeyword }}){% endfor %};

templates/node/lib/services/service.js.twig

@@ -53,4 +53,4 @@ class {{ service.name | caseUcfirst }} extends Service {
 {% endfor %}
 }
 
-module.exports = {{ service.name | caseUcfirst }};
+module.exports = {{ service.name | caseUcfirst }};

templates/rust/.gitignore

@@ -0,0 +1,11 @@
+# Generated by Cargo
+# will have compiled files and executables
+debug/
+target/
+
+# Remove Cargo.lock from gitignore if creating an executable, leave it for libraries
+# More information here https://doc.rust-lang.org/cargo/guide/cargo-toml-vs-cargo-lock.html
+Cargo.lock
+
+# These are backup files generated by rustfmt
+**/*.rs.bk

templates/rust/CHANGELOG.md.twig

@@ -0,0 +1 @@
+{{sdk.changelog}}

templates/rust/Cargo.toml.twig

@@ -0,0 +1,19 @@
+[package]
+name = "{{ language.params.packageName }}"
+version = "{{ sdk.version }}"
+authors = ["Appwrite Team <[email protected]>"]
+edition = "2018"
+description = "{{ sdk.shortDescription }}"
+licence = "{{ sdk.licenseName }}"
+repository = "{{ sdk.gitURL }}"
+
+# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
+
+[dependencies]
+url = "2.2.1"
+reqwest = { version = "0.11", features = ["json", "blocking", "multipart"] }
+
+# Serde
+serde = "1.0.124"
+serde_derive = "1.0.124"
+serde_json = "1.0.59"

templates/rust/LICENSE.twig

@@ -0,0 +1 @@
+{{sdk.licenseContent}}