Intro to web programming in Rust for NodeJS developersBastian GruberBlockedUnblockFollowFollowingMar 10Rust is different.
You can pick up Python or Ruby over the weekend, create a first CRUD application and be happy with the results.
With Rust… with Rust you will struggle to pass a String to a different method, change and return it.
You then will order the Rust book, see its size, *sigh* and get started.
After a few weeks fighting through the book after work, you give up and wait until someone else creates an easy-to-follow tutorial.
Here is your “easy” tutorialI struggled with the same problems.
Life circumstances however gave me a few months time on my hands to really focus on Rust.
What follows is a first overview, concept and paths to follow.
In the coming weeks and months I’ll publish a series of articles to help you getting from concept to product.
NodeJS vs RustAfter installing (I chose brew for macOS in this example, the method doesn’t matter), the underlying stack looks different.
NodeJS needs V8, the runtime engine from Google, and bindings to the JavaScript library to run JavaScript code.
Rust depends almost completely on Rust itself.
Just the compiler is using llvm libraries, which are written in C and C++.
How much “web” is in Rust?It was and is a design decision not to include a standard http library in Rust.
The OSI layer is therefore covered differently:Node covers the whole stack, and offers with koa and express two well-known and “rock-solid” web frameworks which help you to build applications on top of HTTP.
On the Rust side of things, just TCP is implemented in the Rust Core.
The current web frameworks (actix and rocket) are implementing everything up until HTTP though.
So you don’t need to care where this is coming from.
If you want to use pure HTTP calls without any larger framework, you can install “crates” (npm packages in the Node world) which implemented the HTTP protocol (like hyper and tiny_http).
npm vs cargoNode is using npm for its package management:npm install is installing dependenciesnpm run xyz is executing scripts inside the package.
jsonOn the Rust side, cargo is handling everything related to your project:cargo new NAME –bin is creating an applicationcargo new NAME –lib to create a librarycargo run is executing the codecargo build is creating an executablecargo test is running all tests inside the projectThere is an open PR to add cargo add to install dependencies.
Right now you have to add them by hand to your Cargo.
toml file.
As you see, you don’t need to include scripts in a package.
json to run tests or build and test your application.
EcosystemNode is not successful for no reason.
The ecosystem is rich and flourishing.
Rust is still developing, but has already many great “crates”.
The website arewewebyet.
org is tracking the progress and showing you interesting packages in the Rust world.
There is also an attempt to create an official Rust Web Framework, called Tide.
It is already pretty mature and can be used for side projects.
Feel free to contribute and help craft a great environment for web development in Rust.
Asnyc programming aka Promises aka FuturesNodes killer feature are Promises.
Although not always easy to understand and handle, Promises and the event loop are what makes Node so lucrative.
Rust is also implementing asynchronous mechanism, which are not yet in the final version.
They are called Futures.
A library called Tokio is already offering an asynchronous run time.
You can track the progress on asynchronous programming in Rust over at areweasyncyet.
How to get started?Install Rust: curl https://sh.
rustup.
rs -sSf | shCreate a new project: cargo new web-app –bincd web-appNow you can choose your web framework of choice.
You can either start with Rocket or actix.
You can follow the tutorials on the website to get a first web application running.
Heads up: undefined, borrowing and typesTo not to get frustrated until my next post, here are the main four things about Rust you will have to get used to (which are quite awesome after a while).
There is no undefined.
Rust has no real null value.
This is a feature.
Rust has a type called Option, which encapsulates either the return value or None.
In this case, we use the Result type to return a value.
You could, instead of return a String, return an Option which might have a String value, or None if the website we are fetching from doesn’t contain any text.
An easy solution, which you should not use in production, is to .
unwrap() results to get the String out of the encapsulation.
Homework: Try to check if the GET request errored and return an Error in this case instead of Ok().
You must have heard about borrowing.
In short: Every assignment (=) to a non trivial type (everything which doesn’t have a fixed size) moves the ownership over.
The method fetch_text() is not taking ownership over the url but just using a reference to it (via the & ).
Homework: Figure out why this code here fails and how to solve it.
You always have to know which type is returned from a method.
In this example, our HTTP crate reqwest is returning a Response struct (type) which implements certain methods.
The documentation is, as with so many crates, excellent.
So have a look here.
You don’t have to type return to return a value from a method.
Just don’t put a ; at the end of a statement and this becomes your return value.
Use this example to play around, see where you can get errors and learn to fix them.
Is this all?Two opinions:“Sadly no!”“No, but that’s a good thing!”You actually have to learn a decent amount of Rust to get started.
This is what I am here for.
In the next few days, weeks and months I will cover the basics up until creating a solid web application.
Up until then I can recommend the Rust track on Exercism.
io and the Rust Book which you can find also in a paper version at your local book store or at Amazon.
As mentioned in my first article, Rust is making you a better developer, so the road will be long at times, but always worth it.
Follow me on twitter or Medium to stay up to date!.