grpc-api-experiments

Read the RFC to support gRPC on DDN here

ddn_grpc_client_demo.mp4

Server Instructions

• cd/server
• python3 -m venv venv-grpc
• source venv-grpc/bin/activate
• pip install grpcio grpcio-tools grpcio-reflection sqlalchemy psycopg2-binary
• python -m grpc_tools.protoc -I. --python_out=. --grpc_python_out=. item.proto
• export DATABASE_URL="postgresql://read_only_user:readonlyuser@35.236.11.122:5432/v3-docs-sample-app"
• python grpc_server.py

Client Intstructions

Using goclient

• Install the "vscode-proto3" extension for VSCode

• cd client

• go install google.golang.org/protobuf/cmd/protoc-gen-go@latest

• go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest

• protoc --proto_path=. --proto_path=./proto --go_out=. --go-grpc_out=. item.proto

• go run main.go

• Update VScode workspace settings.json

• Run the "Go: Install/Update Tools" command from the Command Palette and ensure all tools are up to date.

  {
      "protoc": {
      "path": "/path/to/protoc",
      "options": [
          "--proto_path=protos"
      ]
      }
  }

Using grpcurl

grpcurl -plaintext -d '{
  "base_request": {
    "pagination": {
      "skip": 1,
      "limit": 5
    },
    "order_by": [
      {
        "field": "category.name",
        "direction": "DESC"
      }
    ],
    "filter": {
      "and": {
        "filters": [
          {
            "field": {
              "field": "country_of_origin",
              "string_op": {
                "eq": "US"
              }
            }
          },
          {
            "field": {
              "field": "category.name",
              "string_op": {
                "eq": "T-Shirts"
              }
            }
          }
        ]
      }
    },
    "field_mask": {
      "paths": ["id", "name", "price", "description", "manufacturer.name"]
    }
  },
  "nested_filters": {
    "review_filter": {
      "pagination": {
        "skip": 0,
        "limit": 3
      },
      "order_by": [
        {
          "field": "rating",
          "direction": "ASC"
        }
      ],
      "filter": {
        "field": {
          "field": "created_at",
          "timestamp_op": {
            "gt": "2023-10-15T00:00:00Z"
          }
        }
      },
      "field_mask": {
        "paths": ["rating", "text"]
      }
    }
  }
}' localhost:50051 item.ProductService/ListProducts

Using grpcui

grpcui -plaintext localhost:50051

---

Notes - https://buf.build/product/bsr