archive

Documentation

Overview

Package archive implements a dnsutil.Archive client and a ready to use service component.

This package is a work in progress and makes no API stability promises.

Index

• Constants
• func ClientBuilder(opt ...ClientOption) apiservice.BuildFn
• func RegisterServer(server *grpc.Server, service *Service)
• func ServiceName() string
• type Client
  • func NewClient(conn *grpc.ClientConn, opt ...ClientOption) *Client
  • func (c *Client) API() string
  • func (c *Client) Close() error
  • func (c *Client) Ping() error
  • func (c *Client) SaveResolv(ctx context.Context, rd dnsutil.ResolvData) (uuid.UUID, error)
• type ClientOption
  • func CloseConnection(b bool) ClientOption
  • func SetLogger(l yalogi.Logger) ClientOption
• type Service
  • func NewService(a dnsutil.Archiver, opt ...ServiceOption) *Service
  • func (s *Service) SaveResolv(ctx context.Context, req *pb.SaveResolvRequest) (*pb.SaveResolvResponse, error)
• type ServiceOption
  • func SetServiceLogger(l yalogi.Logger) ServiceOption

Constants

const (
	APIName    = "luids.dnsutil"
	APIVersion = "v1"
	APIService = "Archive"
)

Constants for api description.

Functions

func ClientBuilder

func ClientBuilder(opt ...ClientOption) apiservice.BuildFn

ClientBuilder returns builder function for the apiservice

func RegisterServer

func RegisterServer(server *grpc.Server, service *Service)

RegisterServer registers a service in the grpc server.

func ServiceName

func ServiceName() string

ServiceName returns service name.

Types

type Client

type Client struct {
	// contains filtered or unexported fields
}

Client provides a grpc client.

func NewClient

func NewClient(conn *grpc.ClientConn, opt ...ClientOption) *Client

NewClient returns a new client.

func (*Client) API

func (c *Client) API() string

API returns API service name implemented

func (*Client) Close

func (c *Client) Close() error

Close closes the client

func (*Client) Ping

func (c *Client) Ping() error

Ping checks connectivity with the api

func (*Client) SaveResolv

func (c *Client) SaveResolv(ctx context.Context, rd dnsutil.ResolvData) (uuid.UUID, error)

SaveResolv implements dnsutil.Archiver interface.

type ClientOption

type ClientOption func(*clientOpts)

ClientOption encapsules options for client.

func CloseConnection

func CloseConnection(b bool) ClientOption

CloseConnection option closes grpc connection on shutdown.

func SetLogger

func SetLogger(l yalogi.Logger) ClientOption

SetLogger option allows set a custom logger.

type Service

type Service struct {
	// contains filtered or unexported fields
}

Service implements a grpc service wrapper.

func NewService

func NewService(a dnsutil.Archiver, opt ...ServiceOption) *Service

NewService returns a new Service.

func (*Service) SaveResolv

func (s *Service) SaveResolv(ctx context.Context, req *pb.SaveResolvRequest) (*pb.SaveResolvResponse, error)

SaveResolv implements grpc interface.

type ServiceOption

type ServiceOption func(*serviceOpts)

ServiceOption is used for service configuration.

func SetServiceLogger

func SetServiceLogger(l yalogi.Logger) ServiceOption

SetServiceLogger option allows set a custom logger.