Update top level init

examples/service/README.md

@@ -0,0 +1,38 @@
+# Service
+
+This is an example of creating a micro service using the top level interface.
+
+## Prereqs
+
+Micro services need a discovery system so they can find each other. Micro uses consul by default but 
+its easily swapped out with etcd, kubernetes, or various other systems. We'll run consul for convenience.
+
+1. Follow the install instructions - [https://www.consul.io/intro/getting-started/install.html](https://www.consul.io/intro/getting-started/install.html)
+
+2. Run Consul
+
+```shell
+$ consul agent -server -bootstrap-expect 1 -data-dir /tmp/consul
+```
+
+## Run the example
+
+1. Get the service
+
+```shell
+go get github.com/micro/go-micro/examples/service
+```
+
+2. Run the server
+
+```shell
+$GOPATH/bin/service
+```
+
+3. Run the client
+
+```shell
+$GOPATH/bin/service --client
+```
+
+And that's all there is to it.

examples/service/main.go

@@ -0,0 +1,93 @@
+package main
+
+import (
+	"fmt"
+	"os"
+
+	"github.com/micro/cli"
+	micro "github.com/micro/go-micro"
+	proto "github.com/micro/go-micro/examples/service/proto"
+	"golang.org/x/net/context"
+)
+
+/*
+
+Example usage of top level service initialisation
+
+*/
+
+type Greeter struct{}
+
+func (g *Greeter) Hello(ctx context.Context, req *proto.HelloRequest, rsp *proto.HelloResponse) error {
+	rsp.Greeting = "Hello " + req.Name
+	return nil
+}
+
+// Setup and the client
+func client(service micro.Service) {
+	// Create new greeter client
+	greeter := proto.NewGreeterClient("greeter", service.Client())
+
+	// Call the greeter
+	rsp, err := greeter.Hello(context.TODO(), &proto.HelloRequest{Name: "John"})
+	if err != nil {
+		fmt.Println(err)
+	}
+
+	// Print response
+	fmt.Println(rsp.Greeting)
+}
+
+// Setup some command line flags
+func flags(service micro.Service) {
+	app := service.Cmd().App()
+	app.Flags = append(app.Flags,
+		&cli.BoolFlag{
+			Name:  "server",
+			Usage: "Launch the server",
+		},
+		&cli.BoolFlag{
+			Name:  "client",
+			Usage: "Launch the client",
+		},
+	)
+
+	// Let's launch the server or the client
+	app.Action = func(c *cli.Context) {
+		if c.Bool("client") {
+			client(service)
+			os.Exit(0)
+		}
+	}
+}
+
+func main() {
+	// Create a new service. Optionally include some options here.
+	service := micro.NewService(
+		micro.Name("greeter"),
+		micro.Version("latest"),
+		micro.Metadata(map[string]string{
+			"type": "helloworld",
+		}),
+	)
+
+	// Setup some flags. Specify --client to run the client
+	flags(service)
+
+	// Init will parse the command line flags. Any flags set will
+	// override the above settings. Options defined here will
+	// override anything set on the command line.
+	service.Init()
+
+	// By default we'll run the server unless the flags catch us
+
+	// Setup the server
+
+	// Register handler
+	proto.RegisterGreeterHandler(service.Server(), new(Greeter))
+
+	// Run the server
+	if err := service.Run(); err != nil {
+		fmt.Println(err)
+	}
+}

examples/service/proto/greeter.pb.go

@@ -0,0 +1,124 @@
+// Code generated by protoc-gen-go.
+// source: go-micro/examples/service/proto/greeter.proto
+// DO NOT EDIT!
+
+/*
+Package greeter is a generated protocol buffer package.
+
+It is generated from these files:
+	go-micro/examples/service/proto/greeter.proto
+
+It has these top-level messages:
+	HelloRequest
+	HelloResponse
+*/
+package greeter
+
+import proto "github.com/golang/protobuf/proto"
+import fmt "fmt"
+import math "math"
+
+import (
+	client "github.com/micro/go-micro/client"
+	server "github.com/micro/go-micro/server"
+	context "golang.org/x/net/context"
+)
+
+// Reference imports to suppress errors if they are not otherwise used.
+var _ = proto.Marshal
+var _ = fmt.Errorf
+var _ = math.Inf
+
+type HelloRequest struct {
+	Name string `protobuf:"bytes,1,opt,name=name" json:"name,omitempty"`
+}
+
+func (m *HelloRequest) Reset()                    { *m = HelloRequest{} }
+func (m *HelloRequest) String() string            { return proto.CompactTextString(m) }
+func (*HelloRequest) ProtoMessage()               {}
+func (*HelloRequest) Descriptor() ([]byte, []int) { return fileDescriptor0, []int{0} }
+
+type HelloResponse struct {
+	Greeting string `protobuf:"bytes,2,opt,name=greeting" json:"greeting,omitempty"`
+}
+
+func (m *HelloResponse) Reset()                    { *m = HelloResponse{} }
+func (m *HelloResponse) String() string            { return proto.CompactTextString(m) }
+func (*HelloResponse) ProtoMessage()               {}
+func (*HelloResponse) Descriptor() ([]byte, []int) { return fileDescriptor0, []int{1} }
+
+func init() {
+	proto.RegisterType((*HelloRequest)(nil), "HelloRequest")
+	proto.RegisterType((*HelloResponse)(nil), "HelloResponse")
+}
+
+// Reference imports to suppress errors if they are not otherwise used.
+var _ context.Context
+var _ client.Option
+var _ server.Option
+
+// Client API for Greeter service
+
+type GreeterClient interface {
+	Hello(ctx context.Context, in *HelloRequest, opts ...client.CallOption) (*HelloResponse, error)
+}
+
+type greeterClient struct {
+	c           client.Client
+	serviceName string
+}
+
+func NewGreeterClient(serviceName string, c client.Client) GreeterClient {
+	if c == nil {
+		c = client.NewClient()
+	}
+	if len(serviceName) == 0 {
+		serviceName = "greeter"
+	}
+	return &greeterClient{
+		c:           c,
+		serviceName: serviceName,
+	}
+}
+
+func (c *greeterClient) Hello(ctx context.Context, in *HelloRequest, opts ...client.CallOption) (*HelloResponse, error) {
+	req := c.c.NewRequest(c.serviceName, "Greeter.Hello", in)
+	out := new(HelloResponse)
+	err := c.c.Call(ctx, req, out, opts...)
+	if err != nil {
+		return nil, err
+	}
+	return out, nil
+}
+
+// Server API for Greeter service
+
+type GreeterHandler interface {
+	Hello(context.Context, *HelloRequest, *HelloResponse) error
+}
+
+func RegisterGreeterHandler(s server.Server, hdlr GreeterHandler) {
+	s.Handle(s.NewHandler(&Greeter{hdlr}))
+}
+
+type Greeter struct {
+	GreeterHandler
+}
+
+func (h *Greeter) Hello(ctx context.Context, in *HelloRequest, out *HelloResponse) error {
+	return h.GreeterHandler.Hello(ctx, in, out)
+}
+
+var fileDescriptor0 = []byte{
+	// 153 bytes of a gzipped FileDescriptorProto
+	0x1f, 0x8b, 0x08, 0x00, 0x00, 0x09, 0x6e, 0x88, 0x02, 0xff, 0xe2, 0xd2, 0x4d, 0xcf, 0xd7, 0xcd,
+	0xcd, 0x4c, 0x2e, 0xca, 0xd7, 0x4f, 0xad, 0x48, 0xcc, 0x2d, 0xc8, 0x49, 0x2d, 0xd6, 0x2f, 0x4e,
+	0x2d, 0x2a, 0xcb, 0x4c, 0x4e, 0xd5, 0x2f, 0x28, 0xca, 0x2f, 0xc9, 0xd7, 0x4f, 0x2f, 0x4a, 0x4d,
+	0x2d, 0x49, 0x2d, 0xd2, 0x03, 0xf3, 0x94, 0x64, 0xb8, 0x78, 0x3c, 0x52, 0x73, 0x72, 0xf2, 0x83,
+	0x52, 0x0b, 0x4b, 0x53, 0x8b, 0x4b, 0x84, 0x78, 0xb8, 0x58, 0xf2, 0x12, 0x73, 0x53, 0x25, 0x18,
+	0x15, 0x18, 0x35, 0x38, 0x95, 0x14, 0xb9, 0x78, 0xa1, 0xb2, 0xc5, 0x05, 0xf9, 0x79, 0xc5, 0xa9,
+	0x42, 0x02, 0x5c, 0x1c, 0x60, 0xfd, 0x99, 0x79, 0xe9, 0x12, 0x4c, 0x20, 0x25, 0x46, 0xc6, 0x5c,
+	0xec, 0xee, 0x10, 0x13, 0x85, 0x34, 0xb8, 0x58, 0xc1, 0xaa, 0x85, 0x78, 0xf5, 0x90, 0xcd, 0x94,
+	0xe2, 0xd3, 0x43, 0x31, 0x44, 0x89, 0x21, 0x89, 0x0d, 0x6c, 0xb9, 0x31, 0x20, 0x00, 0x00, 0xff,
+	0xff, 0x0f, 0xa9, 0x59, 0xb3, 0xad, 0x00, 0x00, 0x00,
+}

examples/service/proto/greeter.proto

@@ -0,0 +1,13 @@
+syntax = "proto3";
+
+service Greeter {
+	rpc Hello(HelloRequest) returns (HelloResponse) {}
+}
+
+message HelloRequest {
+	string name = 1;
+}
+
+message HelloResponse {
+	string greeting = 2;
+}