eclipse-vertx/vert.x

Vert.x is a toolkit for building reactive applications on the JVM, which is the runtime environment that Java programs use. This repository holds the core piece of Vert.x. The README describes core as containing low-level functionality, including support for HTTP, TCP networking, file system access, and other features. The core can be used directly inside an application, and it also serves as the base that many other Vert.x components are built on top of. The README is short and points readers to the project website at vertx.io for the bigger picture of what Vert.x is and where core fits. The repository itself does not try to explain the toolkit in depth. Instead it focuses on the practical steps a contributor or builder would take when working with the source code. Most of the README is build instructions. You can produce the Vert.x artifacts by running a Maven package command. You can run the tests with a Maven test command, optionally setting HTTP and HTTPS ports. Vert.x supports what it calls native transport on BSD and Linux systems, with separate test profiles for NativeEpoll, NativeIoUring, and NativeKQueue. There is also a Linux-only mode for testing with domain sockets, and a separate integration test setup that runs the JVM with different configuration. The final section explains how to build the documentation locally by running a Maven docs profile, then opening the generated HTML file in a browser. Beyond that the README does not cover usage examples, API details, or design philosophy, so a reader who wants to learn how to write a Vert.x app would need to follow the link to the website.