Plugin quickstart

curl -fsSL cli.noorle.dev | sh
noorle --version

noorle plugin init my-plugin --template rust
cd my-plugin

package example:weather;

world weather-component {
    enum unit { metric, imperial }

    record weather-response {
        location: string,
        temperature: f64,
        humidity: option<u32>,
        weather-conditions: list<string>,
    }

    /// Check the current weather for a location
    export check-weather: func(location: string, unit: unit) -> result<weather-response, string>;
}

#![allow(unsafe_op_in_unsafe_fn)]
wit_bindgen::generate!({ world: "weather-component", path: "./wit" });

struct WeatherComponent;

impl Guest for WeatherComponent {
    fn check_weather(location: String, unit: Unit) -> Result<WeatherResponse, String> {
        // ...
    }
}

export!(WeatherComponent);

schema_version: "1.0"
metadata:
  name: my-plugin
  description: "Fetches current weather for a location"
permissions:
  network:
    allow:
      - host: "api.openweathermap.org"
  environment:
    allow:
      - key: OPENWEATHER_API_KEY

noorle plugin build