A blazingly fast drop-in replacement for the Mastodon streaming API server
Go to file
Daniel Sockwell d6ae45b292 Code reorganization 2019-07-08 07:31:42 -04:00
src Code reorganization 2019-07-08 07:31:42 -04:00
tests Code reorganization 2019-07-08 07:31:42 -04:00
.gitignore Initial project files 2019-02-11 09:45:14 +01:00
Cargo.lock Code reorganization 2019-07-08 07:31:42 -04:00
Cargo.toml Remove outdated files and update dependencies 2019-05-10 06:23:07 -04:00
LICENSE Initial commit 2019-02-08 10:35:26 +01:00
README.md Update README 2019-05-10 07:33:58 -04:00

README.md

Mastodon Streaming Server

A WIP blazingly fast drop-in replacement for the Mastodon streaming api server.

Current status

The streaming server is very much a work in progress. It is currently missing essential features including support for SSL, CORS, and separate development/production environments. However, it has reached the point where it is usable/testable in a localhost development environment and I would greatly appreciate any testing, bug reports, or other feedback you could provide.

Installation

Installing the WIP version requires the Rust toolchain (the released version will be available as a pre-compiled binary). To install, clone this repository and run cargo build (to build the server) cargo run (to both build and run the server), or cargo build --release (to build the server with release optimizations).

Connection to Mastodon

The streaming server expects to connect to a running development version of Mastodon built off of the master branch. Specifically, it needs to connect to both the Postgres database (to authenticate users) and to the Redis database. You should run Mastodon in whatever way you normally do and configure the streaming server to connect to the appropriate databases.

Configuring

You may edit the (currently limited) configuration variables in the .env file. Note that, by default, this server is configured to run on port 4000. This allows for easy testing with the development version of Mastodon (which, by default, is configured to communicate with a streaming server running on localhost:4000). However, it also conflicts with the current/Node.js version of Mastodon's streaming server, which runs on the same port. Thus, to test this server, you should disable the other streaming server or move it to a non-conflicting port.

Documentation

Build documentation with cargo doc --open, which will build the Markdown docs and open them in your browser. Please consult those docs for a description of the code structure/organization.

Running

As noted above, you can run the server with cargo run. Alternatively, if you built the sever using cargo build or cargo build --release, you can run the executable produced in the target/build/debug folder or the target/build/release folder.

Unit and (limited) integration tests

You can run basic unit test of the public Server Sent Event endpoints with cargo test. You can run integration tests of the authenticated SSE endpoints (which require a Postgres connection) with cargo test -- --ignored.

Manual testing

Once the streaming server is running, you can also test it manually. You can test it using a browser connected to the relevant Mastodon development server. Or you can test the SSE endpoints with curl, PostMan, or any other HTTP client. Similarly, you can test the WebSocket endpoints with websocat or any other WebSocket client.

Memory/CPU usage

Note that memory usage is higher when running the development version of the streaming server (the one generated with cargo run or cargo build). If you are interested in measuring RAM or CPU usage, you should likely run cargo build --release and test the release version of the executable.

Load testing

I have not yet found a good way to test the streaming server under load. I have experimented with using artillery or other load-testing utilities. However, every utility I am familiar with or have found is built around either HTTP requests or WebSocket connections in which the client sends messages. I have not found a good solution to test receiving SSEs or WebSocket connections where the client does not transmit data after establishing the connection. If you are aware of a good way to do load testing, please let me know.