keybase

README

Bind

Go bindable package that includes both Keybase client and KBFS for gomobile builds.

Documentation

Index

• func AppBeginBackgroundTask(pusher PushNotifier)
• func AppBeginBackgroundTaskNonblock(pusher PushNotifier)
• func AppDidEnterBackground() bool
• func AppWillExit(pusher PushNotifier)
• func BackgroundSync()
• func ExtensionDetectMIMEType(filename string) (res string, err error)
• func ExtensionForceGC()
• func ExtensionGetInbox() (res string, err error)
• func ExtensionGetSavedConv() string
• func ExtensionInit(homeDir string, mobileSharedHome string, logFile string, runModeStr string, ...) (err error)
• func ExtensionIsInited() bool
• func ExtensionPostFile(strConvID, name string, public bool, membersType int, caption string, ...) (err error)
• func ExtensionPostImage(strConvID, name string, public bool, membersType int, caption string, ...) (err error)
• func ExtensionPostText(strConvID, name string, public bool, membersType int, body string) (err error)
• func ExtensionPostVideo(strConvID, name string, public bool, membersType int, caption string, ...) (err error)
• func ForceGC()
• func HandleBackgroundNotification(strConvID, body, serverMessageBody, sender string, intMembersType int, ...) (err error)
• func HandlePostTextReply(strConvID, tlfName string, intMessageID int, body string) (err error)
• func Init(homeDir, mobileSharedHome, logFile, runModeStr string, ...) (err error)
• func InitOnce(homeDir, mobileSharedHome, logFile, runModeStr string, ...)
• func IsAppStateForeground() bool
• func LogSend(statusJSON string, feedback string, sendLogs, sendMaxBytes bool, ...) (res string, err error)
• func ReadB64() (res string, err error)
• func Reset() error
• func SetAppStateBackground()
• func SetAppStateBackgroundActive()
• func SetAppStateForeground()
• func SetAppStateInactive()
• func Version() string
• func WriteB64(str string) (err error)
• type ChatNotification
• type ExternalDNSNSFetcher
• type Message
• type NativeVideoHelper
• type Person
• type PushNotifier

Functions

func AppBeginBackgroundTask

func AppBeginBackgroundTask(pusher PushNotifier)

AppBeginBackgroundTask notifies us that an app background task has been started on our behalf. This function will return once we no longer need any time in the background.

func AppBeginBackgroundTaskNonblock

func AppBeginBackgroundTaskNonblock(pusher PushNotifier)

func AppDidEnterBackground

func AppDidEnterBackground() bool

AppDidEnterBackground notifies the service that the app is in the background [iOS] returning true will request about ~3mins from iOS to continue execution

func AppWillExit

func AppWillExit(pusher PushNotifier)

AppWillExit is called reliably on iOS when the app is about to terminate not as reliably on android

func BackgroundSync

func BackgroundSync()

func ExtensionDetectMIMEType

func ExtensionDetectMIMEType(filename string) (res string, err error)

func ExtensionForceGC

func ExtensionForceGC()

ExtensionForceGC Forces a gc

func ExtensionGetInbox

func ExtensionGetInbox() (res string, err error)

func ExtensionGetSavedConv

func ExtensionGetSavedConv() string

func ExtensionInit

func ExtensionInit(homeDir string, mobileSharedHome string, logFile string, runModeStr string,
	accessGroupOverride bool, pusher PushNotifier, mobileOsVersion string) (err error)

func ExtensionIsInited

func ExtensionIsInited() bool

func ExtensionPostFile

func ExtensionPostFile(strConvID, name string, public bool, membersType int,
	caption string, filename string) (err error)

func ExtensionPostImage

func ExtensionPostImage(strConvID, name string, public bool, membersType int,
	caption string, inFilename string, mimeType string,
	baseWidth, baseHeight, previewWidth, previewHeight int, previewData []byte) (err error)

func ExtensionPostText

func ExtensionPostText(strConvID, name string, public bool, membersType int, body string) (err error)

func ExtensionPostVideo

func ExtensionPostVideo(strConvID, name string, public bool, membersType int,
	caption string, inFilename string, mimeType string,
	duration, baseWidth, baseHeight, previewWidth, previewHeight int, previewData []byte) (err error)

func ForceGC

func ForceGC()

ForceGC Forces a gc

func HandleBackgroundNotification

func HandleBackgroundNotification(strConvID, body, serverMessageBody, sender string, intMembersType int,
	displayPlaintext bool, intMessageID int, pushID string, badgeCount, unixTime int, soundName string,
	pusher PushNotifier, showIfStale bool) (err error)

func HandlePostTextReply

func HandlePostTextReply(strConvID, tlfName string, intMessageID int, body string) (err error)

func Init

func Init(homeDir, mobileSharedHome, logFile, runModeStr string,
	accessGroupOverride bool, externalDNSNSFetcher ExternalDNSNSFetcher, nvh NativeVideoHelper,
	mobileOsVersion string) (err error)

Init runs the Keybase services

func InitOnce

func InitOnce(homeDir, mobileSharedHome, logFile, runModeStr string,
	accessGroupOverride bool, dnsNSFetcher ExternalDNSNSFetcher, nvh NativeVideoHelper,
	mobileOsVersion string)

InitOnce runs the Keybase services (only runs one time)

func IsAppStateForeground

func IsAppStateForeground() bool

func LogSend

func LogSend(statusJSON string, feedback string, sendLogs, sendMaxBytes bool, traceDir, cpuProfileDir string) (res string, err error)

LogSend sends a log to Keybase

func ReadB64

func ReadB64() (res string, err error)

ReadB64 is a blocking read for base64 encoded msgpack rpc data. It is called serially by the mobile run loops.

func Reset

func Reset() error

Reset resets the socket connection

func SetAppStateBackground

func SetAppStateBackground()

func SetAppStateBackgroundActive

func SetAppStateBackgroundActive()

func SetAppStateForeground

func SetAppStateForeground()

func SetAppStateInactive

func SetAppStateInactive()

func Version

func Version() string

Version returns semantic version string

func WriteB64

func WriteB64(str string) (err error)

WriteB64 sends a base64 encoded msgpack rpc payload

Types

type ChatNotification

type ChatNotification struct {
	Message   *Message
	ConvID    string
	TeamName  string
	TopicName string
	TlfName   string
	// e.g. "keybase#general, CoolTeam, Susannah,Jake"
	ConversationName    string
	IsGroupConversation bool
	IsPlaintext         bool
	SoundName           string
	BadgeCount          int
}

type ExternalDNSNSFetcher

type ExternalDNSNSFetcher interface {
	GetServers() []byte
}

type Message

type Message struct {
	ID            int
	Kind          string // "Text" | "Reaction"
	Plaintext     string
	ServerMessage string // This is the server's suggested display message for the notification
	From          *Person
	At            int64
}

type NativeVideoHelper

type NativeVideoHelper interface {
	Thumbnail(filename string) []byte
	Duration(filename string) int
}

type Person

type Person struct {
	KeybaseUsername string
	KeybaseAvatar   string
	IsBot           bool
}

type PushNotifier

type PushNotifier interface {
	LocalNotification(ident string, msg string, badgeCount int, soundName string, convID string, typ string)
	DisplayChatNotification(notification *ChatNotification)
}