Rust

​

Supported versions

• 1

​

Deprecated versions

​

Retired versions

​

Dependencies

​

Building and running your app

applications:
  # The app's name, which must be unique within the project.
  myapp:

    # The language and version for your app.
    type: 'rust:1'

    hooks:
      build:
        cargo build

    web:
      commands:
        # Customize the start command with your own target.
        start: './target/debug/hello'

      locations:
        /:
          # Route all requests to the Rust app, unconditionally.
          allow: false
          passthru: true

​

Built-in variables

let port : String = env::var("PORT").unwrap_or(String::from("8888"));

use base64::{Engine as _, engine::{general_purpose}};
use serde_json::Value;

let bytes = general_purpose::STANDARD.decode(env::var("PLATFORM_RELATIONSHIPS").unwrap_or(String::new())).unwrap();
let psh_config: Value = serde_json::from_slice(&bytes).unwrap();
println!("{}", psh_config["database"]);

​

Complete example

1. Install Rust and Cargo.
2. Create a repository for your app and add the following Cargo.toml file:
   [package]
   name = "hello_world"
   version = "0.1.0"
   edition = "2021"
   
   [[bin]]
   name = "hello"
   path = "hello.rs"
   
   [dependencies]
   time = "0.1.12"
   regex = "0.1.41"
   base64 = "0.21.0"
   serde = { version = "1.0", features = ["derive"] }
   
   serde_json = "1.0"
   
3. Add the following app configuration:
   .upsun/config.yaml

   applications:
     # The app's name, which must be unique within the project.
     myapp:
   
       # The language and version for your app.
       type: 'rust:1'
   
       hooks:
         build:
           cargo build
   
       web:
         commands:
           # Customize the start command with your own target.
           start: './target/debug/hello'
   
       locations:
         /:
           # Route all requests to the Rust app, unconditionally.
           allow: false
           passthru: true
   
4. To generate a Cargo.lock file, run the following command:
   cargo generate-lockfile
   
5. Add the following hello.rs file:
   /* Simple HTTP Server */
   /* Author : Ramesh Vyas */
   use std::io::prelude::*;
   use std::net::TcpListener;
   use std::net::TcpStream;
   use std::fs;
   use std::env;
   
   fn main() {
   
       /* Creating a Local TcpListener at Port 8888 */
       const HOST : &str ="127.0.0.1";
       let port : String = env::var("PORT").unwrap_or(String::from("8888"));
   
       /* Concating Host address and Port to Create Final Endpoint */
       let end_point : String = HOST.to_owned() + ":" +  &port;
   
       /*Creating TCP Listener at our end point */
       let listener = TcpListener::bind(end_point).unwrap();
   
       println!("Web server is listening at port {}",port);
   
       /* Connecting to any incoming connections */
       for stream in listener.incoming() {
           let _stream = stream.unwrap();
           // Call Function to process any incomming connections
           handle_connection(_stream);
       }
   
   }
   
   fn handle_connection(mut stream: TcpStream) {
       let mut buffer = [0; 1024];
       stream.read(&mut buffer).unwrap();
   
       let get = b"GET / HTTP/1.1\r\n";
   
       if buffer.starts_with(get) {
           let contents = fs::read_to_string("index.html").unwrap();
   
           let response = format!(
               "HTTP/1.1 200 OK\r\nContent-Length: {}\r\n\r\n{}",
               contents.len(),
               contents
           );
   
           stream.write(response.as_bytes()).unwrap();
           stream.flush().unwrap();
       } else {
           // some other request
       }
   }