Celeris

Overview

Celeris is a backend technology built with C++. Inspired by the Latin word for "fast" or "rapid," Celeris provides a modern and efficient way to build backend APIs. It combines the power and speed of C++ with a clean, developer-friendly API design, similar to popular frameworks like FastAPI or Node.js.

Features

• High Performance: Leverages C++’s speed for fast and efficient API handling, ideal for high-demand applications.
• Dynamic Routing: Simple and flexible route definition with built-in support for GET and POST methods.
• JSON Handling: Provides built-in serialization and deserialization of JSON using the nlohmann JSON library.
• Extensible: Modular design allows easy addition of new features and extensions.

Installation

To get started with Celeris, follow these steps:

1. Clone the Repository:

   git clone https://github.com/Alazar42/Celeris.git

2. Build the Project:

   cd Celeris
   mkdir build && cd build
   cmake ..
   make

   Celeris comes with pre-included dependencies like Boost and nlohmann JSON, so there’s no need to install them separately.

Getting Started

Here’s a basic example to set up a simple server using Celeris:

#include <celeris/celeris.hpp>

int main() {
    // Create a Celeris server instance
    Celeris app(8080, "127.0.0.1");

    // Define a simple GET route
    app.get("/hello", [](const Request& req, Response& res) {
        nlohmann::json json_response = {{"message", "Hello, world!"}};
        res.set_json(json_response);
    });

    // Define a POST route
    app.post("/echo", [](const Request& req, Response& res) {
        nlohmann::json json_request = nlohmann::json::parse(req.body);
        res.set_json(json_request);
    });

    // Start the server
    app.listen();

    return 0;
}

Explanation:

• Creates a Celeris server instance on port 8080.
• Defines a simple GET route (/hello) that responds with a JSON message.
• Defines a POST route (/echo) that echoes the received JSON request back in the response.
• Starts the server and listens for incoming requests.

Contributing

Celeris is actively developed, and we encourage contributions! Here’s how you can contribute:

1. Fork the Repository.
2. Create a New Branch:

   git checkout -b feature-branch

3. Make Your Changes.
4. Submit a Pull Request with a clear description of your changes.

Looking for Contributors

We’re seeking collaborators to help expand Celeris, particularly for adding:

• Database Integration (preferably with ORM support)
• WebSocket Support

License

Celeris is licensed under the GNU General Public License. For more details, see the LICENSE file.

Contact

For questions, issues, or feature requests, please open an issue on GitHub or contact us at alazartesfaye42@gmail.com.