Twitter API (#207)

* add twitter service

* update readme

twitter/.gitignore

@@ -0,0 +1,2 @@
+
+twitter

twitter/Dockerfile

@@ -0,0 +1,3 @@
+FROM alpine
+ADD twitter /twitter
+ENTRYPOINT [ "/twitter" ]

twitter/Makefile

@@ -0,0 +1,28 @@
+
+GOPATH:=$(shell go env GOPATH)
+.PHONY: init
+init:
+	go get -u github.com/golang/protobuf/proto
+	go get -u github.com/golang/protobuf/protoc-gen-go
+	go get github.com/micro/micro/v3/cmd/protoc-gen-micro
+	go get github.com/micro/micro/v3/cmd/protoc-gen-openapi
+
+.PHONY: api
+api:
+	protoc --openapi_out=. --proto_path=. proto/twitter.proto
+
+.PHONY: proto
+proto:
+	protoc --proto_path=. --micro_out=. --go_out=:. proto/twitter.proto
+	
+.PHONY: build
+build:
+	go build -o twitter *.go
+
+.PHONY: test
+test:
+	go test -v ./... -cover
+
+.PHONY: docker
+docker:
+	docker build . -t twitter:latest

twitter/README.md

@@ -0,0 +1,6 @@
+Simple twitter timeline
+
+# Twitter Service
+
+Retrieve the twitter timeline for a user without all the extra baggage
+

twitter/examples.json

@@ -0,0 +1,20 @@
+{
+    "timeline": [{
+        "title": "Get a twitter timeline",
+        "run_check": false,
+        "request": {
+          "username": "m3oservices",
+          "limit": 1
+        },
+        "response": {
+          "tweets": [{
+            "id": "1437415171966873611",
+	    "text": "Leveraging Micro APIs through Nocode (using @bubble) https://t.co/I5Z6bx31c7 #bubble #nocode #microapis #publicapis #m3o",
+	    "username": "m3oservices",
+	    "created_at": "Mon Sep 13 13:57:37 +0000 2021",
+	    "retweeted_count": "2",
+	    "favourited_count": "2"
+          }]
+        }
+    }]
+}

twitter/generate.go

@@ -0,0 +1,3 @@
+package main
+
+//go:generate make proto

twitter/handler/twitter.go

@@ -0,0 +1,84 @@
+package handler
+
+import (
+	"context"
+
+	"github.com/dghubble/go-twitter/twitter"
+	"github.com/micro/micro/v3/service/config"
+	"github.com/micro/micro/v3/service/errors"
+	"github.com/micro/micro/v3/service/logger"
+	pb "github.com/micro/services/twitter/proto"
+	"golang.org/x/oauth2"
+	"golang.org/x/oauth2/clientcredentials"
+)
+
+type Twitter struct {
+	Client *twitter.Client
+}
+
+func New() *Twitter {
+	v, err := config.Get("twitter.api_key")
+	if err != nil {
+		logger.Fatalf("twitter.api_key config not found: %v", err)
+	}
+	apiKey := v.String("")
+	if len(apiKey) == 0 {
+		logger.Fatal("twitter.api_key config not found")
+	}
+	v, err = config.Get("twitter.api_secret")
+	if err != nil {
+		logger.Fatalf("twitter.api_secret config not found: %v", err)
+	}
+	apiSecret := v.String("")
+	if len(apiSecret) == 0 {
+		logger.Fatal("twitter.api_secret config not found")
+	}
+
+	// oauth2 configures a client that uses app credentials to keep a fresh token
+	config := &clientcredentials.Config{
+		ClientID:     apiKey,
+		ClientSecret: apiSecret,
+		TokenURL:     "https://api.twitter.com/oauth2/token",
+	}
+	// http.Client will automatically authorize Requests
+	httpClient := config.Client(oauth2.NoContext)
+
+	// Twitter client
+	client := twitter.NewClient(httpClient)
+
+	return &Twitter{
+		Client: client,
+	}
+}
+
+func (t *Twitter) Timeline(ctx context.Context, req *pb.TimelineRequest, rsp *pb.TimelineResponse) error {
+	if len(req.Username) == 0 {
+		return errors.BadRequest("twitter.timeline", "missing username")
+	}
+
+	if req.Limit <= 0 {
+		req.Limit = 20
+	}
+
+	tweets, _, err := t.Client.Timelines.UserTimeline(&twitter.UserTimelineParams{
+		ScreenName: req.Username,
+		Count:      int(req.Limit),
+	})
+	if err != nil {
+		logger.Errorf("Failed to retrieve tweets for %v: %v", req.Username, err)
+		return errors.InternalServerError("twitter.timeline", "Failed to retrieve tweets for %v: %v", req.Username, err)
+	}
+
+	for _, tweet := range tweets {
+		rsp.Tweets = append(rsp.Tweets, &pb.Tweet{
+			Id:              tweet.ID,
+			Text:            tweet.Text,
+			CreatedAt:       tweet.CreatedAt,
+			FavouritedCount: int64(tweet.FavoriteCount),
+			RetweetedCount:  int64(tweet.RetweetCount),
+			Username:        tweet.User.ScreenName,
+		})
+	}
+
+	return nil
+}

twitter/main.go

@@ -0,0 +1,24 @@
+package main
+
+import (
+	"github.com/micro/micro/v3/service"
+	"github.com/micro/micro/v3/service/logger"
+	"github.com/micro/services/twitter/handler"
+	pb "github.com/micro/services/twitter/proto"
+)
+
+func main() {
+	// Create service
+	srv := service.New(
+		service.Name("twitter"),
+		service.Version("latest"),
+	)
+
+	// Register handler
+	pb.RegisterTwitterHandler(srv.Server(), handler.New())
+
+	// Run service
+	if err := srv.Run(); err != nil {
+		logger.Fatal(err)
+	}
+}

twitter/micro.mu

@@ -0,0 +1 @@
+service twitter

twitter/proto/twitter.pb.go

@@ -0,0 +1,346 @@
+// Code generated by protoc-gen-go. DO NOT EDIT.
+// versions:
+// 	protoc-gen-go v1.26.0
+// 	protoc        v3.15.6
+// source: proto/twitter.proto
+
+package twitter
+
+import (
+	protoreflect "google.golang.org/protobuf/reflect/protoreflect"
+	protoimpl "google.golang.org/protobuf/runtime/protoimpl"
+	reflect "reflect"
+	sync "sync"
+)
+
+const (
+	// Verify that this generated code is sufficiently up-to-date.
+	_ = protoimpl.EnforceVersion(20 - protoimpl.MinVersion)
+	// Verify that runtime/protoimpl is sufficiently up-to-date.
+	_ = protoimpl.EnforceVersion(protoimpl.MaxVersion - 20)
+)
+
+type Tweet struct {
+	state         protoimpl.MessageState
+	sizeCache     protoimpl.SizeCache
+	unknownFields protoimpl.UnknownFields
+
+	// id of the tweet
+	Id int64 `protobuf:"varint,1,opt,name=id,proto3" json:"id,omitempty"`
+	// text of the tweet
+	Text string `protobuf:"bytes,2,opt,name=text,proto3" json:"text,omitempty"`
+	// username of the person who tweeted
+	Username string `protobuf:"bytes,3,opt,name=username,proto3" json:"username,omitempty"`
+	// time of tweet
+	CreatedAt string `protobuf:"bytes,4,opt,name=created_at,json=createdAt,proto3" json:"created_at,omitempty"`
+	// number of times retweeted
+	RetweetedCount int64 `protobuf:"varint,5,opt,name=retweeted_count,json=retweetedCount,proto3" json:"retweeted_count,omitempty"`
+	// number of times favourited
+	FavouritedCount int64 `protobuf:"varint,6,opt,name=favourited_count,json=favouritedCount,proto3" json:"favourited_count,omitempty"`
+}
+
+func (x *Tweet) Reset() {
+	*x = Tweet{}
+	if protoimpl.UnsafeEnabled {
+		mi := &file_proto_twitter_proto_msgTypes[0]
+		ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+		ms.StoreMessageInfo(mi)
+	}
+}
+
+func (x *Tweet) String() string {
+	return protoimpl.X.MessageStringOf(x)
+}
+
+func (*Tweet) ProtoMessage() {}
+
+func (x *Tweet) ProtoReflect() protoreflect.Message {
+	mi := &file_proto_twitter_proto_msgTypes[0]
+	if protoimpl.UnsafeEnabled && x != nil {
+		ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+		if ms.LoadMessageInfo() == nil {
+			ms.StoreMessageInfo(mi)
+		}
+		return ms
+	}
+	return mi.MessageOf(x)
+}
+
+// Deprecated: Use Tweet.ProtoReflect.Descriptor instead.
+func (*Tweet) Descriptor() ([]byte, []int) {
+	return file_proto_twitter_proto_rawDescGZIP(), []int{0}
+}
+
+func (x *Tweet) GetId() int64 {
+	if x != nil {
+		return x.Id
+	}
+	return 0
+}
+
+func (x *Tweet) GetText() string {
+	if x != nil {
+		return x.Text
+	}
+	return ""
+}
+
+func (x *Tweet) GetUsername() string {
+	if x != nil {
+		return x.Username
+	}
+	return ""
+}
+
+func (x *Tweet) GetCreatedAt() string {
+	if x != nil {
+		return x.CreatedAt
+	}
+	return ""
+}
+
+func (x *Tweet) GetRetweetedCount() int64 {
+	if x != nil {
+		return x.RetweetedCount
+	}
+	return 0
+}
+
+func (x *Tweet) GetFavouritedCount() int64 {
+	if x != nil {
+		return x.FavouritedCount
+	}
+	return 0
+}
+
+// Get the timeline for a given user
+type TimelineRequest struct {
+	state         protoimpl.MessageState
+	sizeCache     protoimpl.SizeCache
+	unknownFields protoimpl.UnknownFields
+
+	// the username to request the timeline for
+	Username string `protobuf:"bytes,1,opt,name=username,proto3" json:"username,omitempty"`
+	// number of tweets to return. default: 20
+	Limit int32 `protobuf:"varint,2,opt,name=limit,proto3" json:"limit,omitempty"`
+}
+
+func (x *TimelineRequest) Reset() {
+	*x = TimelineRequest{}
+	if protoimpl.UnsafeEnabled {
+		mi := &file_proto_twitter_proto_msgTypes[1]
+		ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+		ms.StoreMessageInfo(mi)
+	}
+}
+
+func (x *TimelineRequest) String() string {
+	return protoimpl.X.MessageStringOf(x)
+}
+
+func (*TimelineRequest) ProtoMessage() {}
+
+func (x *TimelineRequest) ProtoReflect() protoreflect.Message {
+	mi := &file_proto_twitter_proto_msgTypes[1]
+	if protoimpl.UnsafeEnabled && x != nil {
+		ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+		if ms.LoadMessageInfo() == nil {
+			ms.StoreMessageInfo(mi)
+		}
+		return ms
+	}
+	return mi.MessageOf(x)
+}
+
+// Deprecated: Use TimelineRequest.ProtoReflect.Descriptor instead.
+func (*TimelineRequest) Descriptor() ([]byte, []int) {
+	return file_proto_twitter_proto_rawDescGZIP(), []int{1}
+}
+
+func (x *TimelineRequest) GetUsername() string {
+	if x != nil {
+		return x.Username
+	}
+	return ""
+}
+
+func (x *TimelineRequest) GetLimit() int32 {
+	if x != nil {
+		return x.Limit
+	}
+	return 0
+}
+
+type TimelineResponse struct {
+	state         protoimpl.MessageState
+	sizeCache     protoimpl.SizeCache
+	unknownFields protoimpl.UnknownFields
+
+	// The recent tweets for the user
+	Tweets []*Tweet `protobuf:"bytes,1,rep,name=tweets,proto3" json:"tweets,omitempty"`
+}
+
+func (x *TimelineResponse) Reset() {
+	*x = TimelineResponse{}
+	if protoimpl.UnsafeEnabled {
+		mi := &file_proto_twitter_proto_msgTypes[2]
+		ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+		ms.StoreMessageInfo(mi)
+	}
+}
+
+func (x *TimelineResponse) String() string {
+	return protoimpl.X.MessageStringOf(x)
+}
+
+func (*TimelineResponse) ProtoMessage() {}
+
+func (x *TimelineResponse) ProtoReflect() protoreflect.Message {
+	mi := &file_proto_twitter_proto_msgTypes[2]
+	if protoimpl.UnsafeEnabled && x != nil {
+		ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+		if ms.LoadMessageInfo() == nil {
+			ms.StoreMessageInfo(mi)
+		}
+		return ms
+	}
+	return mi.MessageOf(x)
+}
+
+// Deprecated: Use TimelineResponse.ProtoReflect.Descriptor instead.
+func (*TimelineResponse) Descriptor() ([]byte, []int) {
+	return file_proto_twitter_proto_rawDescGZIP(), []int{2}
+}
+
+func (x *TimelineResponse) GetTweets() []*Tweet {
+	if x != nil {
+		return x.Tweets
+	}
+	return nil
+}
+
+var File_proto_twitter_proto protoreflect.FileDescriptor
+
+var file_proto_twitter_proto_rawDesc = []byte{
+	0x0a, 0x13, 0x70, 0x72, 0x6f, 0x74, 0x6f, 0x2f, 0x74, 0x77, 0x69, 0x74, 0x74, 0x65, 0x72, 0x2e,
+	0x70, 0x72, 0x6f, 0x74, 0x6f, 0x12, 0x07, 0x74, 0x77, 0x69, 0x74, 0x74, 0x65, 0x72, 0x22, 0xba,
+	0x01, 0x0a, 0x05, 0x54, 0x77, 0x65, 0x65, 0x74, 0x12, 0x0e, 0x0a, 0x02, 0x69, 0x64, 0x18, 0x01,
+	0x20, 0x01, 0x28, 0x03, 0x52, 0x02, 0x69, 0x64, 0x12, 0x12, 0x0a, 0x04, 0x74, 0x65, 0x78, 0x74,
+	0x18, 0x02, 0x20, 0x01, 0x28, 0x09, 0x52, 0x04, 0x74, 0x65, 0x78, 0x74, 0x12, 0x1a, 0x0a, 0x08,
+	0x75, 0x73, 0x65, 0x72, 0x6e, 0x61, 0x6d, 0x65, 0x18, 0x03, 0x20, 0x01, 0x28, 0x09, 0x52, 0x08,
+	0x75, 0x73, 0x65, 0x72, 0x6e, 0x61, 0x6d, 0x65, 0x12, 0x1d, 0x0a, 0x0a, 0x63, 0x72, 0x65, 0x61,
+	0x74, 0x65, 0x64, 0x5f, 0x61, 0x74, 0x18, 0x04, 0x20, 0x01, 0x28, 0x09, 0x52, 0x09, 0x63, 0x72,
+	0x65, 0x61, 0x74, 0x65, 0x64, 0x41, 0x74, 0x12, 0x27, 0x0a, 0x0f, 0x72, 0x65, 0x74, 0x77, 0x65,
+	0x65, 0x74, 0x65, 0x64, 0x5f, 0x63, 0x6f, 0x75, 0x6e, 0x74, 0x18, 0x05, 0x20, 0x01, 0x28, 0x03,
+	0x52, 0x0e, 0x72, 0x65, 0x74, 0x77, 0x65, 0x65, 0x74, 0x65, 0x64, 0x43, 0x6f, 0x75, 0x6e, 0x74,
+	0x12, 0x29, 0x0a, 0x10, 0x66, 0x61, 0x76, 0x6f, 0x75, 0x72, 0x69, 0x74, 0x65, 0x64, 0x5f, 0x63,
+	0x6f, 0x75, 0x6e, 0x74, 0x18, 0x06, 0x20, 0x01, 0x28, 0x03, 0x52, 0x0f, 0x66, 0x61, 0x76, 0x6f,
+	0x75, 0x72, 0x69, 0x74, 0x65, 0x64, 0x43, 0x6f, 0x75, 0x6e, 0x74, 0x22, 0x43, 0x0a, 0x0f, 0x54,
+	0x69, 0x6d, 0x65, 0x6c, 0x69, 0x6e, 0x65, 0x52, 0x65, 0x71, 0x75, 0x65, 0x73, 0x74, 0x12, 0x1a,
+	0x0a, 0x08, 0x75, 0x73, 0x65, 0x72, 0x6e, 0x61, 0x6d, 0x65, 0x18, 0x01, 0x20, 0x01, 0x28, 0x09,
+	0x52, 0x08, 0x75, 0x73, 0x65, 0x72, 0x6e, 0x61, 0x6d, 0x65, 0x12, 0x14, 0x0a, 0x05, 0x6c, 0x69,
+	0x6d, 0x69, 0x74, 0x18, 0x02, 0x20, 0x01, 0x28, 0x05, 0x52, 0x05, 0x6c, 0x69, 0x6d, 0x69, 0x74,
+	0x22, 0x3a, 0x0a, 0x10, 0x54, 0x69, 0x6d, 0x65, 0x6c, 0x69, 0x6e, 0x65, 0x52, 0x65, 0x73, 0x70,
+	0x6f, 0x6e, 0x73, 0x65, 0x12, 0x26, 0x0a, 0x06, 0x74, 0x77, 0x65, 0x65, 0x74, 0x73, 0x18, 0x01,
+	0x20, 0x03, 0x28, 0x0b, 0x32, 0x0e, 0x2e, 0x74, 0x77, 0x69, 0x74, 0x74, 0x65, 0x72, 0x2e, 0x54,
+	0x77, 0x65, 0x65, 0x74, 0x52, 0x06, 0x74, 0x77, 0x65, 0x65, 0x74, 0x73, 0x32, 0x4c, 0x0a, 0x07,
+	0x54, 0x77, 0x69, 0x74, 0x74, 0x65, 0x72, 0x12, 0x41, 0x0a, 0x08, 0x54, 0x69, 0x6d, 0x65, 0x6c,
+	0x69, 0x6e, 0x65, 0x12, 0x18, 0x2e, 0x74, 0x77, 0x69, 0x74, 0x74, 0x65, 0x72, 0x2e, 0x54, 0x69,
+	0x6d, 0x65, 0x6c, 0x69, 0x6e, 0x65, 0x52, 0x65, 0x71, 0x75, 0x65, 0x73, 0x74, 0x1a, 0x19, 0x2e,
+	0x74, 0x77, 0x69, 0x74, 0x74, 0x65, 0x72, 0x2e, 0x54, 0x69, 0x6d, 0x65, 0x6c, 0x69, 0x6e, 0x65,
+	0x52, 0x65, 0x73, 0x70, 0x6f, 0x6e, 0x73, 0x65, 0x22, 0x00, 0x42, 0x11, 0x5a, 0x0f, 0x2e, 0x2f,
+	0x70, 0x72, 0x6f, 0x74, 0x6f, 0x3b, 0x74, 0x77, 0x69, 0x74, 0x74, 0x65, 0x72, 0x62, 0x06, 0x70,
+	0x72, 0x6f, 0x74, 0x6f, 0x33,
+}
+
+var (
+	file_proto_twitter_proto_rawDescOnce sync.Once
+	file_proto_twitter_proto_rawDescData = file_proto_twitter_proto_rawDesc
+)
+
+func file_proto_twitter_proto_rawDescGZIP() []byte {
+	file_proto_twitter_proto_rawDescOnce.Do(func() {
+		file_proto_twitter_proto_rawDescData = protoimpl.X.CompressGZIP(file_proto_twitter_proto_rawDescData)
+	})
+	return file_proto_twitter_proto_rawDescData
+}
+
+var file_proto_twitter_proto_msgTypes = make([]protoimpl.MessageInfo, 3)
+var file_proto_twitter_proto_goTypes = []interface{}{
+	(*Tweet)(nil),            // 0: twitter.Tweet
+	(*TimelineRequest)(nil),  // 1: twitter.TimelineRequest
+	(*TimelineResponse)(nil), // 2: twitter.TimelineResponse
+}
+var file_proto_twitter_proto_depIdxs = []int32{
+	0, // 0: twitter.TimelineResponse.tweets:type_name -> twitter.Tweet
+	1, // 1: twitter.Twitter.Timeline:input_type -> twitter.TimelineRequest
+	2, // 2: twitter.Twitter.Timeline:output_type -> twitter.TimelineResponse
+	2, // [2:3] is the sub-list for method output_type
+	1, // [1:2] is the sub-list for method input_type
+	1, // [1:1] is the sub-list for extension type_name
+	1, // [1:1] is the sub-list for extension extendee
+	0, // [0:1] is the sub-list for field type_name
+}
+
+func init() { file_proto_twitter_proto_init() }
+func file_proto_twitter_proto_init() {
+	if File_proto_twitter_proto != nil {
+		return
+	}
+	if !protoimpl.UnsafeEnabled {
+		file_proto_twitter_proto_msgTypes[0].Exporter = func(v interface{}, i int) interface{} {
+			switch v := v.(*Tweet); i {
+			case 0:
+				return &v.state
+			case 1:
+				return &v.sizeCache
+			case 2:
+				return &v.unknownFields
+			default:
+				return nil
+			}
+		}
+		file_proto_twitter_proto_msgTypes[1].Exporter = func(v interface{}, i int) interface{} {
+			switch v := v.(*TimelineRequest); i {
+			case 0:
+				return &v.state
+			case 1:
+				return &v.sizeCache
+			case 2:
+				return &v.unknownFields
+			default:
+				return nil
+			}
+		}
+		file_proto_twitter_proto_msgTypes[2].Exporter = func(v interface{}, i int) interface{} {
+			switch v := v.(*TimelineResponse); i {
+			case 0:
+				return &v.state
+			case 1:
+				return &v.sizeCache
+			case 2:
+				return &v.unknownFields
+			default:
+				return nil
+			}
+		}
+	}
+	type x struct{}
+	out := protoimpl.TypeBuilder{
+		File: protoimpl.DescBuilder{
+			GoPackagePath: reflect.TypeOf(x{}).PkgPath(),
+			RawDescriptor: file_proto_twitter_proto_rawDesc,
+			NumEnums:      0,
+			NumMessages:   3,
+			NumExtensions: 0,
+			NumServices:   1,
+		},
+		GoTypes:           file_proto_twitter_proto_goTypes,
+		DependencyIndexes: file_proto_twitter_proto_depIdxs,
+		MessageInfos:      file_proto_twitter_proto_msgTypes,
+	}.Build()
+	File_proto_twitter_proto = out.File
+	file_proto_twitter_proto_rawDesc = nil
+	file_proto_twitter_proto_goTypes = nil
+	file_proto_twitter_proto_depIdxs = nil
+}

twitter/proto/twitter.pb.micro.go

@@ -0,0 +1,93 @@
+// Code generated by protoc-gen-micro. DO NOT EDIT.
+// source: proto/twitter.proto
+
+package twitter
+
+import (
+	fmt "fmt"
+	proto "github.com/golang/protobuf/proto"
+	math "math"
+)
+
+import (
+	context "context"
+	api "github.com/micro/micro/v3/service/api"
+	client "github.com/micro/micro/v3/service/client"
+	server "github.com/micro/micro/v3/service/server"
+)
+
+// Reference imports to suppress errors if they are not otherwise used.
+var _ = proto.Marshal
+var _ = fmt.Errorf
+var _ = math.Inf
+
+// This is a compile-time assertion to ensure that this generated file
+// is compatible with the proto package it is being compiled against.
+// A compilation error at this line likely means your copy of the
+// proto package needs to be updated.
+const _ = proto.ProtoPackageIsVersion3 // please upgrade the proto package
+
+// Reference imports to suppress errors if they are not otherwise used.
+var _ api.Endpoint
+var _ context.Context
+var _ client.Option
+var _ server.Option
+
+// Api Endpoints for Twitter service
+
+func NewTwitterEndpoints() []*api.Endpoint {
+	return []*api.Endpoint{}
+}
+
+// Client API for Twitter service
+
+type TwitterService interface {
+	Timeline(ctx context.Context, in *TimelineRequest, opts ...client.CallOption) (*TimelineResponse, error)
+}
+
+type twitterService struct {
+	c    client.Client
+	name string
+}
+
+func NewTwitterService(name string, c client.Client) TwitterService {
+	return &twitterService{
+		c:    c,
+		name: name,
+	}
+}
+
+func (c *twitterService) Timeline(ctx context.Context, in *TimelineRequest, opts ...client.CallOption) (*TimelineResponse, error) {
+	req := c.c.NewRequest(c.name, "Twitter.Timeline", in)
+	out := new(TimelineResponse)
+	err := c.c.Call(ctx, req, out, opts...)
+	if err != nil {
+		return nil, err
+	}
+	return out, nil
+}
+
+// Server API for Twitter service
+
+type TwitterHandler interface {
+	Timeline(context.Context, *TimelineRequest, *TimelineResponse) error
+}
+
+func RegisterTwitterHandler(s server.Server, hdlr TwitterHandler, opts ...server.HandlerOption) error {
+	type twitter interface {
+		Timeline(ctx context.Context, in *TimelineRequest, out *TimelineResponse) error
+	}
+	type Twitter struct {
+		twitter
+	}
+	h := &twitterHandler{hdlr}
+	return s.Handle(s.NewHandler(&Twitter{h}, opts...))
+}
+
+type twitterHandler struct {
+	TwitterHandler
+}
+
+func (h *twitterHandler) Timeline(ctx context.Context, in *TimelineRequest, out *TimelineResponse) error {
+	return h.TwitterHandler.Timeline(ctx, in, out)
+}

twitter/proto/twitter.proto

@@ -0,0 +1,37 @@
+syntax = "proto3";
+
+package twitter;
+
+option go_package = "./proto;twitter";
+
+service Twitter {
+	rpc Timeline(TimelineRequest) returns (TimelineResponse) {}
+}
+
+message Tweet {
+	// id of the tweet
+	int64 id = 1;
+	// text of the tweet
+	string text = 2;
+	// username of the person who tweeted
+	string username = 3;
+	// time of tweet
+	string created_at = 4;
+	// number of times retweeted
+	int64 retweeted_count = 5;
+	// number of times favourited
+	int64 favourited_count = 6;
+}
+
+// Get the timeline for a given user
+message TimelineRequest {
+	// the username to request the timeline for
+	string username = 1;
+	// number of tweets to return. default: 20
+	int32 limit = 2;
+}
+
+message TimelineResponse {
+	// The recent tweets for the user
+	repeated Tweet tweets = 1;
+}

twitter/publicapi.json

@@ -0,0 +1,5 @@
+{
+  "name": "twitter",
+  "icon": "💬",
+  "category": "social"
+}