TheLazy.Dev
Portfolio GitHub

Blog

appwrite |dart |opensource |hacktoberfest

Appwrite with Dart!

timothy22000

timothy22000

Posted on October 31, 2021

Appwrite with Dart!

Welcome! This blogpost will be going through using the Appwrite Dart SDK to interact with Appwrite APIs (Users, Database, Storage, Functions, Accounts)

Setting up Appwrite and Dart SDK

Firstly, you will need to install Appwrite and Dart before you can follow along with this tutorial. The main website for each of them have really good documentation on installing them.

Appwrite Installation and running your local instance:
https://appwrite.io/docs/installation

Flutter (the Dart SDK will be installed as part of it starting with Flutter version 1.19.0):
https://flutter.dev/docs/get-started/install

Once you have both of them set up, then start running your Appwrite Server and create your own Dart project.

Within the pubspec.yaml file of your Dart project, you need to ensure that you have Appwrite Dart SDK as a dependency there.

Run the command below if it is missing:

dart pub add dart_appwrite
Enter fullscreen mode Exit fullscreen mode

Pubspec.yaml example:
Image description

Now that we have that out of the way, let's get the ball rolling!

Image description

Importing the Appwrite Dart SDK and creating the client

1) If you have the Appwrite Dart SDK dependency in your pubspec.yaml, then you should be able to import the package:

import 'package:dart_appwrite/dart_appwrite.dart';
Enter fullscreen mode Exit fullscreen mode

2) Create the Appwrite client:

Client client = Client();
Enter fullscreen mode Exit fullscreen mode

3) Then, we need to set the endpoint, project ID and secret key for the client.

  client
      .setEndpoint(endpoint) 
      .setProject(projectid) // Project ID
      .setKey(secret) // Your Appwrite secret key
      .setSelfSigned(status: true); //Don't use this in production
Enter fullscreen mode Exit fullscreen mode

4) Those information can be found in the Appwrite Console. Examples of where you can find the information below.

Project ID and Endpoint:
Project ID and Endpoint

API Key:
Image description

Next, we will move on to interacting with the different Appwrite APIs.

Users

The Users service allows you to manage your project users. Use this service to search, block, and view your users' info, current sessions, and latest activity logs. You can also use the Users service to edit your users' preferences and personal info.

We will be going through some of examples of interacting with the Users API with Appwrite Dart SDK.

Firstly, we need to create a Users service by passing the client we defined earlier as an argument.

Users users = Users(client);
Enter fullscreen mode Exit fullscreen mode

Once we have the Users service then we can go on to interact with our Appwrite backend through the Users API.

Creating a new user

This is how you would create a new user using the Dart SDK.

Future response = users.create(
 email: "example@gmail.com",
 password: "example123",
 name: "example"
);
Enter fullscreen mode Exit fullscreen mode

The arguments that are accepted by the users.create(...) function are:

email - The first argument is the email of the user and this is Required. The type provided should be string.

password - The second argument takes the password of the user and this is required. The type of the password should be string.

name - The third argument is the name of the user (max length is 128 characters) and this is Optional. The type provided should be string

Now we can see our new user created in the Appwrite Console under "Develop > Users".

Image description

Note that we will have the response from the Create User request and we will also always have response whenever we make a request to Appwrite. You can check what the response with the code below:

response
    .then((response) {
    print(response);
  }).catchError((error) {
    print(error.response);
  });
Enter fullscreen mode Exit fullscreen mode

The response will be in JSON format and here is how the response for the Create User Request looks like:

{
    "$id": "617eb25e03167",
    "name": "example",
    "registration": 1635693866,
    "status": 0,
    "passwordUpdate": 1635693866,
    "email": "example@gmail.com",
    "emailVerification": false,
    "prefs": {}
}
Enter fullscreen mode Exit fullscreen mode

Listing users

We can also list all the users that are currently defined.

Future response = users.list();
Enter fullscreen mode Exit fullscreen mode

Example JSON Response:

{
    "sum": 1,
    "users": [
        {
            "$id": "617eb25e03167",
            "name": "example",
            "registration": 1635693866,
            "status": 0,
            "passwordUpdate": 1635693866,
            "email": "example@gmail.com",
            "emailVerification": false,
            "prefs": {}
        }
    ]
}
Enter fullscreen mode Exit fullscreen mode

Deleting a user

To delete a user, you have to provide the user's user ID as an argument to the delete function.

Future result = users.delete(userId:'617eb25e03167');
Enter fullscreen mode Exit fullscreen mode

This response does not have a payload so you will have to list all the users again using the function mentioned in the earlier section to see your changes or view it in the Appwrite console.

Storage

The Storage service allows you to manage your project files. Using the Storage service, you can upload, view, download, and query all your project files.

Each file in the service is granted with read and write permissions to manage who has access to view or edit it.

We first define the Storage service:

Storage storage = Storage(client);
Enter fullscreen mode Exit fullscreen mode

Create file

The example here assumes that you have a file called "test.jpg" in your project folder which will be uploaded to the Appwrite Storage service. We will be using the createFile function to upload our file.

final file = await MultipartFile.fromPath('file', './test.jpg', filename: 'test.jpg');

Future response = storage.createFile(
    file: file, //multipart file
    read: ['*'],
    write: ['*'],
  );
Enter fullscreen mode Exit fullscreen mode

Here are the arguments that we can provide to the storage.createFile(...) function.

file - The binary data of the file that you want to create to upload into Appwrite service and this is a Required argument.

read - An array of strings to containing a specific user, team or everyone (denoted by the wildcard permission '*') to bestow with write permissions and this is Optional. Only the current user is granted with read permissions as default. The type that should be provided is Array.

write - An array of strings to containing a specific user, team or everyone (denoted by the wildcard permission '*') to bestow with write permissions and this is Optional. Only the current user is granted with write permissions as default. The type that should be provided is Array.

You can read more about permissions in Appwrite here:
https://appwrite.io/docs/permissions

Now, we can see the changes reflected under the "Develop > Storage" section of Appwrite.

Image description

Example of JSON response for Create File request:

{
    "$id": "617ec67928ccd",
    "$permissions": {
        "read": ["*"],
        "write": ["*"]
    },
    "name": "test.jpg",
    "dateCreated": 1635698297,
    "signature": "288da602ad6002d9720f52aa97b49d8c",
    "mimeType": "image/jpeg",
    "sizeOriginal": 84647
}
Enter fullscreen mode Exit fullscreen mode

List files

We can then list our files from the Storage service using listFiles function other than viewing it in the Appwrite Console.

Future response = storage.listFiles()
Enter fullscreen mode Exit fullscreen mode

Example of JSON Response:

{
    "sum": 1,
    "files": [{
        "$id": "617ec67928ccd",
        "$permissions": {
            "read": ["*"],
            "write": ["*"]
        },
        "name": "test.jpg",
        "dateCreated": 1635698297,
        "signature": "288da602ad6002d9720f52aa97b49d8c",
        "mimeType": "image/jpeg",
        "sizeOriginal": 84647
    }]
}
Enter fullscreen mode Exit fullscreen mode

Delete file

To delete the file from the Storage service, we will be using the deleteFile function by providing the file ID as an argument.

Future response = storage.deleteFile(fileId: '617ec67928ccd')
Enter fullscreen mode Exit fullscreen mode

This response does not have a payload so you will have to list all the users again using the function mentioned in the earlier section to see your changes or view it in the Appwrite console.

Functions:

Appwrite Functions allow you to extend and customize your Appwrite server functionality by executing your custom code. Appwrite can execute your custom code in response to any Appwrite system event like account creation, user login, or document update. You can also schedule your functions to run according to a CRON schedule or start them manually by triggering your function from an HTTP endpoint using the Appwrite client or server APIs.

Appwrite Functions run in a secure, isolated Docker container. Appwrite supports multiple runtimes for different programming languages such as Kotlin, Python and others that you can use to run your code.

Firstly, we will create our Functions service using our client defined earlier.

Functions functions = Functions(client);
Enter fullscreen mode Exit fullscreen mode

Create Function

Here, we will be creating a function called test_function that will be our custom written code that we want it to be executed with all read and write permissions. We also want this function to be execution in the Python 3.9 runtime.

Future response = functions.create(
  name: '[test_function]',
  execute: [*],
  runtime: 'python-3.9',
);
Enter fullscreen mode Exit fullscreen mode

The arguments that we are passing to the functions.create(...) shown above:

name - The name of the function that that you want (maximum length is 128 characters) to upload into Appwrite service and this is a Required argument.

execute - An array of strings to containing a specific user, team or everyone (denoted by the wildcard permission '*') to bestow with execute permissions and this is Required. No user is granted with read permissions as default. The type that should be provided is Array.

runtime - This sets the execution runtime for the function. The list of supported runtimes are: https://appwrite.io/docs/functions#supportedRuntimes. The type that should be provided is string.

Additional arguments that can be provided: https://appwrite.io/docs/server/functions?sdk=dart-default#functionsCreate

We should be able to see our new function at the "Develop > Functions" section of Appwrite now.
Image description

Example of JSON response for create function request:

{
    "$id": "617ec96ceb93e",
    "$permissions": {
        "execute": ["*"]
    },
    "name": "[test_function]",
    "dateCreated": 1635699052,
    "dateUpdated": 1635699052,
    "status": "disabled",
    "runtime": "python-3.9",
    "tag": "",
    "vars": [],
    "events": [],
    "schedule": "",
    "scheduleNext": 0,
    "schedulePrevious": 0,
    "timeout": 15
}
Enter fullscreen mode Exit fullscreen mode

List Functions

List our functions from the Functions service using the list function other than viewing it in the Appwrite Console.

Future response = functions.list();
Enter fullscreen mode Exit fullscreen mode

Example of JSON response:

{
    "sum": 1,
    "functions": [{
        "$id": "617ec96ceb93e",
        "$permissions": {
            "execute": ["*"]
        },
        "name": "[test_function]",
        "dateCreated": 1635699052,
        "dateUpdated": 1635699052,
        "status": "disabled",
        "runtime": "python-3.9",
        "tag": "",
        "vars": [],
        "events": [],
        "schedule": "",
        "scheduleNext": 0,
        "schedulePrevious": 0,
        "timeout": 15
    }]
}
Enter fullscreen mode Exit fullscreen mode

Delete Functions

We can delete the function that we have created using the Appwrite Dart SDK by doing:

Future result = functions.delete(functionId:'617ec96ceb93e');
Enter fullscreen mode Exit fullscreen mode

Further Resources

Some of the features that are present in Appwrite Dart SDK was discussed in this post. If you wish to learn more then, please do take a look at the Appwrite documentation:

https://appwrite.io/docs

If you want to help out with bugs and new features for Appwrite, then check out the Appwrite Github:
https://github.com/appwrite/appwrite

My Github Profile: https://github.com/timothy22000

💖 💪 🙅 🚩
timothy22000
timothy22000

Posted on October 31, 2021

Join Our Newsletter. No Spam, Only the good stuff.

Sign up to receive the latest update from our blog.

Related

Appwrite with Dart!
appwrite Appwrite with Dart!

October 31, 2021