✨ paekli-rs ✨

This is a guide for an exercise project in Rust. It is intended as the next thing to do after reading The Rust Programming Language.

The aim of paekli-rs is to bridge the gap between the book and production-ready code, emphasizing among other things:

  • library usage
  • inter-process communication
  • integration in a polyglot environment
  • automated testing and delivery (CI/CD)
  • having lots of fun! 😃

The Topic

In order to have a little bit of fun, the application will be themed as a simulation of a postal service. In practice, that's just a messaging application. This topic was chosen because its feature set is very flexible and can adapt to what and how much you want to do.

Our postal service could be sending "packages" around, but that word has another meaning in the software world. So, we'll be using the less ambiguous term paekli to refer to deliverables in our business domain.

Choose your own components

This book is structured around self-contained guides for what we'll call components. You can choose to implement almost any combination of them in almost any order. In its simplest form, the application can be a single component, e.g. a CLI app, without any integrations with other components. If you choose to go the extra mile, the application can grow into a diverse set of interacting clients and servers.

For example, a python script might call into a Rust library that sends a paekli to an http server which live-updates a wasm-based browser app over websocket! Very cool!

As you can see in the sidebar, the components are loosely categorized into clients, servers and storage backends.

  • Clients can be stand-alone and may use servers and storage backends.
  • Servers can be stand-alone, but are probably difficult to use without a client. They may also use storage backends.
  • Storage backends can't be stand-alone, as their only purpose is to be used by clients and servers.

Choose your own difficulty

The guides are supposed to be at moderate to low difficulty, although there is some variability. If you'd like a bigger challenge, you are always welcome to go off the beaten path! Are you a web developer and find the HTTP server guide boring? Invent a new feature that requires you to use query params and try to make them type-safe. You get the idea. The more you go off the beaten path, the more difficult it will be to integrate different components, which might be exactly the challenge you're looking for.

Requirements

The book assumes that you're using a Unix-like operating system. Linux is officially supported, but Mac should work just as well. If you're on Windows, you should be fine by using WSL. However, please do not open issues related to that.

You also need to be familiar with version control, i.e. git. If you aren't, paekli-rs is probably not right for you. This book assumes you use git, but if you know what you're doing, feel free to use a git-compatible alternative like the excellent jujutsu.

If you're ready to get started, proceed to the project setup.