🎟️ Ticketing Service Example

This example shows how to build a simple ticketing service using Nylon, supporting create, view, delete, update, and book operations — with plugins written in Go and Rust.

---

🚦 Requirements

• Nylon >= 1.0.0-beta.0
• Go
• Rust

---

🚀 Getting Started

1. Create a new project directory

nylon plugin init ticketing-service
cd ticketing-service

2. Add a new plugin (Go & Rust)

nylon plugin add ticketing-svc --lang go --type ffi
nylon plugin add mid-authz --lang rust --type ffi

---

📁 Project Structure

ticketing-service/
├── c/
│   └── nylon.h                 # C header for FFI plugins
├── build/
│   ├── ticketing-svc.so         # Compiled Go plugin
│   └── mid-authz.so       # Compiled Rust plugin
├── config/
│   ├── conf.d/
│   │   ├── __plugins.yaml      # Auto-generated by Nylon CLI
│   │   └── routes.yaml         # Route configuration
│   └── config.yaml             # Global Nylon config
├── ffi/
│   ├── ticketing-svc/
│   │   ├── main.go             # Main Go plugin code
│   │   ├── go.mod
│   │   └── go.sum
│   └── mid-authz/
│       ├── Cargo.toml
│       └── src/
│           └── lib.rs          # Main Rust plugin code
├── plugins.yaml                # Declare plugin metadata
├── .gitignore
└── README.md

---

3. Start the Dev Server

nylon plugin dev
# Watches for changes and automatically rebuilds plugins

---

4. Write a plugin

ticketing-svc/main.go

//go:build cgo
package main

/*
#include "../../c/nylon.h"
*/
import "C"
import (
  "unsafe"

  "github.com/AssetsArt/nylon/sdk/go/sdk"
)

func main() {}

func SendResponse(sdk_dispatcher *sdk.Dispatcher) C.FfiOutput {
  output := sdk_dispatcher.ToBytes()
  return C.FfiOutput{
    ptr: (*C.uchar)(C.CBytes(output)),
    len: C.ulong(len(output)),
  }
}

func InputToDispatcher(ptr *C.uchar, input_len C.int) *sdk.Dispatcher {
  input := C.GoBytes(unsafe.Pointer(ptr), C.int(input_len))
  dispatcher := sdk.WrapDispatcher(input)
  return dispatcher
}

/*
This function is used to free the memory allocated by the plugin.
It is called by the Nylon runtime.
*/
//export plugin_free
func plugin_free(ptr *C.uchar) {
  C.free(unsafe.Pointer(ptr))
}

//export create_ticket
func create_ticket(ptr *C.uchar, input_len C.int) C.FfiOutput {
  dispatcher := InputToDispatcher(ptr, input_len)
  http_ctx := dispatcher.SwitchDataToHttpContext()

  // TODO: Implement the create ticket logic

  // set http end and data
  dispatcher.SetHttpEnd(true)            // set http end to true
  dispatcher.SetData(http_ctx.ToBytes()) // set data to http context
  return SendResponse(dispatcher)
}

---

📝 Notes & Tips

• Hot-reload: Save your plugin code and nylon plugin dev will auto-rebuild and reload plugins.
• Route mapping: Map HTTP routes to plugin entrypoints via routes.yaml.
• Multi-language support: You can combine Go, Rust, Zig plugins in a single project.
• Explore more: See Nylon plugin docs for all SDK options.

---

Happy Coding!