Skip to content

beltradini/espressia

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Espressia

License: MIT

Overview

Espressia is a visionary espresso simulation system crafted in Rust, designed to elevate the art of coffee extraction into a realm of technological marvel. This project delivers a RESTful API to simulate espresso brewing with precision, allowing users to customize parameters like temperature, pressure, and extraction time while preserving metrics for analysis and inspiration.

Features

  • Espresso Simulation Utopia: Simulate brewing with unparalleled realism and control.
  • Customizable Parameters: Fine-tune temperature, pressure, and time to craft the perfect shot.
  • Precision Validation: Ensures every input aligns with the science of espresso perfection.
  • Metrics Eternity: Stores extraction data in a robust format for reflection and growth.
  • RESTful Elegance: Offers intuitive endpoints to initiate extractions and explore past brilliance.

Installation

To embark on the Espressia journey, follow these steps:

  1. Clone the repository:

    git clone https://github.com/beltradini/espressia.git
    cd espressia
  2. Install Rust (if not already installed):

    curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
  3. Build and run the project:

    cargo run

API Endpoints

Start an Espresso Extraction

POST /start

Query Parameters:

  • temperature (default: 93.0°C)
  • pressure (default: 9.0 bar)
  • time_seconds (default: 25s)

Example:

curl -X POST "http://127.0.0.1:3000/start?temperature=95&pressure=9.5&time_seconds=27"

Retrieve Extraction Metrics

GET /metrics

Example:

curl -X GET "http://127.0.0.1:3000/metrics"

Future Improvements

  • Forge a database to immortalize metrics with grace and speed.
  • Unveil a gallery of espresso recipes for instant mastery.
  • Enhance error whispers and log every moment of brilliance.
  • Expand the API to simulate a universe of beverages.

License

Espressia is released under the MIT License.