GitHub - intelliconnect/rust-lang-apps: General Rust Actix Applications and AWS Programming Utilities

3 min read Original article ↗

RUST Actix-Web Microservice

Our Rust Beginners Kit for Application Development

A collection of sample code using the actix rust framework to

A) Develop REST API

Sample Code :

Functionality API Description
Post JSON data and recieve JSON data http://0.0.0.0:9000/register_user Recieve user details, query to create new user and respond with status of request
Post JSON data and recieve jwt token for auth http://0.0.0.0:9000/login Recieve username and passwrod, query and verify if credentials are correct, generate and respond with jwt
Fetch JSON Array http://0.0.0.0:9000/view_holidays Recieve input year, query database for holiday dates and respond with results
Raw Query example http://0.0.0.0:9000/list_users Raw sql query and Manually specifying sql datatypes for structs
AWS Lambda function invoke http://0.0.0.0:9000/lambda_example Invoke the function synchronously
Upload to AWS S3 http://0.0.0.0:9000/upload_file ----
Dynamodb Query http://0.0.0.0:9000/dynamodb_example Simple Dynamodb Query Example

B) Road Map

  • Integrate with Generally used Amazon Web Services ( more coming soon )

  • Integrate with Elastic Search

  • Graphql

  • Better Error handling

C) Features :

  • Actix Web framework

  • Serde serialization framework

  • Bcrypt for password hashing

  • JWT token Based Authontication

  • Postgres databse

  • Use of Diesel ORM

  • AWS Lambda, Dynamodb, S3 examples

D) Dependencies:

Here's what does what:

Crate Description
actix-web Actix Web is a powerful, pragmatic, and extremely fast web framework for Rust.
Diesel Diesel is a Safe, Extensible ORM and Query Builder for Rust
Serde Serde is a framework for serializing and deserializing Rust data structures
rusoto Rusoto is an AWS SDK for Rust.
dotenv Required for loading environment variables from .env file
env_logger Implements a logger that can be configured via environment variables.
jsonwebtoken To Create and parses JWT (JSON Web Tokens)
http A general purpose library of common HTTP types
easy_password Simple crate for password hashing

E) Run locally

Before you get started, make sure that you have PostgreSQL, Rust, Cargo, and the Diesel CLI installed and that you have Postgres running somewhere.

# Fetch the repo
git clone https://github.com/intelliconnect/rust-lang-apps.git


# Add environment variables to .env file.
nano .env

diesel setup
diesel migration run

cargo check
cargo run # could take a while!

F) Example requests

1) Register

curl -i --request POST \
  --url http://0.0.0.0:9000/register_user \
  --header 'content-type: application/json' \
  --data '{
        "firstname":"abc",
        "lastname":"bbq",
        "username":"admin",
        "email":"admin@gmail.com",
        "mobile":"123456789",
        "password":"1313n218u41",
        "ip_address":"124.245.55.124",
        "isactive":true
}'

2) Login

curl -i --request POST \
  --url http://0.0.0.0:9000/login \
  --header 'content-type: application/json' \
  --data '{ "username":"admin","password":"1313n218u41"}'

3) View Holidays

curl -i --request GET \
  --url http://0.0.0.0:9000/view_holidays \
  --header 'content-type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{ "year": "2020" }'

4) AWS Lambda Invoke

curl -i --request GET \
--url http://0.0.0.0:9000/lambda_example \
--header 'content-type: application/json'

make sure you have lambda function similar to this

Screenshot

5) AWS S3 Upload

make sure you have a bucket on S3 "elastic-search-bucket-test"

curl -i POST \
--url http://0.0.0.0:9000/upload_file   \
--header 'content-type: multipart/form-data' \
-F "file=@image_upload_test.jpg"

6) AWS Dynamodb Query

make sure you have table with name "rusttest" and an item similar to this

Screenshot

curl -i --request GET \
--url http://0.0.0.0:9000/dynamodb_example \
--header 'content-type: application/json' \
--data '{"id":"ICT"}'