A CLI tool (ws-cli) to Manage GRPC Services Workspace

Note: This is an additional tooling to help you be productive building GRPC Server with Rust

Mainly used to Initialize a new Workpspace for Server Template and add Service with Service Template

Installation

1. You can Download and Install workspacer cli on Releases Page

Note: on MacOS you might need to go to System Preferences > Security & Privacy > General and click Open Anyway to install it

Note: on Windows you might need to Add the command to ENV PATH

or Install via Cargo

cargo install ws-cli

Note: if you dont like typing ws-cli you can alias it to ws

2. Build it from source

Clone

git clone htps://github.com/codeitlikemiley/ws-cli.git ws
cd ws

For MacOS

./provision.sh
# you can use ws command instead of ws-cli (longer)

For Linux

cargo build --release
mv ./target/release/ws-cli /usr/local/bin/ws
chmod +x /usr/local/bin/ws

For Windows

cargo build --release

# Replace 'YourUsername' with your actual username
Move-Item .\target\release\ws-cli.exe C:\Users\YourUsername\bin\ws.exe

# Again, replace 'YourUsername' with your actual username
$env:Path += ";C:\Users\YourUsername\bin"

Developer Workflow

1. Initialize a new workspace

mkdir workspace
cd workspace
ws init

2. Create Server Template

cd workspace
cargo generate --git codeitlikemiley/server_template --name server

3. Generate Services

mkdir services
ws add auth
cd services
cargo generate --git codeitlikemiley/services_template --name auth

CLI Example Usage

ws

Manage workspace for GRPC services

Usage: ws <COMMAND>

Commands:
  init    Initializes a new workspace
  add     Adds a member to the workspace
  remove  Removes a member from the workspace
  ls      Lists members of the workspace
  help    Print this message or the help of the given subcommand(s)

Options:
  -h, --help     Print help
  -V, --version  Print version