Skip to content
CodeUpdateAndModificationSystemPublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

21 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AGROWS

Almost Good RPC Over WebSockets

Overview

AGROWS is a framework that allows you to easily execute server-side functions from a WebAssembly (WASM) client using WebSockets. It enables you to define your RPC functions in Golang without worrying about the complexities of client-server communication.

Installation and Setup

Prerequisites

  • Go 1.22.1 or higher

Installation

  1. Clone the repository:

    git clone https://github.com/codeupdateandmodificationsystem/agrows.git
    cd agrows
  2. Install dependencies:

    go mod download

Usage

Defining RPC Functions

Define your RPC functions in a Go file. Here is an example:

package functions

import "context"

// SayHello sends a greeting
func SayHello(name string) string {
    return "Hello, " + name
}

// CrazyMath performs some math operations
type CalcInput struct {
    A int
    B int
}

func CrazyMath(inp CalcInput) string {
    return fmt.Sprintf("Result: %d", inp.A+inp.B)
}

Generating Client and Server Code

  1. Generate the client and server code using the agrows CLI:
agrows --input internal/functions/functions.go client agrows --input internal/functions/functions.go server
  1. The generated code will be saved as agrows_client_functions.go and agrows_server_functions.go.

Running the Server

To start the server, run:

go run cmd/main.go

Configuration

AGROWS provides the following CLI options:

  • --input: Specifies the input file containing the RPC functions (required).
  • --output: Specifies the output file for the generated code (default: agrows_<server|client>_<input_file>).
  • --dbg: Enables debug logging.
  • --compress: Enables compression in the protocol.

Example

The usage example repository demonstrates a full application using AGROWS, Templ, TypeScript, and HTMX. It includes development features like auto-reloading. To explore the example:

  1. Clone the usage example repository:
git clone https://github.com/codeupdateandmodificationsystem/agrows-usage-example.git cd agrows-usage-example
  1. Run the example:
just watch

Contributing

Contributions are welcome! Please fork the repository and submit a pull request.

License

AGROWS is released under the GPL license. See LICENSE for details.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages

⌂ 换网址